@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,82 @@
1
+ /**
2
+ * forkChildNodeOptions — fork 本地 node 子进程的选项单一出口。
3
+ *
4
+ * 集中在一处的理由:这里每一项都是「不写就静默出问题」的配置,分散手抄必然以
5
+ * 「有人漏了其中一个」的方式复发 —— `run-serve-child` 就漏了 `windowsHide`:
6
+ *
7
+ * - `windowsHide`:Windows 上父进程**没有控制台**(detached daemon / 服务宿主)时,
8
+ * console 子系统的子进程会被分配一个新的**可见**控制台窗口,且随实例存活不消失。
9
+ * 注意判断依据是「是否分配控制台」,不是 `stdio`(`stdio` 只管句柄继承):
10
+ * `stdio: 'ignore'` 的 taskkill 同样需要 `windowsHide`。
11
+ * - `execArgv: []`:不继承父进程的箭头参数(`--inspect` / `--loader` / `--require` 等)。
12
+ * **不覆盖 `NODE_OPTIONS`**:那是环境变量,实测在 `execArgv: []` 下仍然生效。
13
+ * - 剥离 `NODE_CHANNEL_*` / `NODE_UNIQUE_ID`:Node 自己 fork 出来的子进程会在 bootstrap
14
+ * 阶段消费掉它注入的通道变量,所以在当前 Node 上这一步通常是 no-op;保留它是为了
15
+ * 宿主(IDE 插件 / Electron / 非 node 启动器)把陈旧值留在环境里的情形——那些值会
16
+ * 原样传给孙进程。注意:「按 advanced 序列化编码」由 `fork()` 的 `serialization`
17
+ * 选项决定,不由环境变量决定,故此处不宣称修复编码错配。
18
+ * - Electron 宿主:`ELECTRON_RUN_AS_NODE=1`,且调用方必须**保持** `process.execPath`
19
+ * (换成捆绑 node.exe 会切断 Windows 上的 fork IPC)。
20
+ *
21
+ * `stdio` 的前三路由调用方决定(日志经 fd 转发 vs 全静默);`ipc` 末位由本函数追加,
22
+ * 调用方无法漏配。
23
+ *
24
+ * `@types/node` 的 `ForkOptions` 未声明 `windowsHide`(运行时有效),此处只豁免该字段,
25
+ * 其余字段仍受类型检查。
26
+ */
27
+ import type { ChildProcess, ForkOptions } from 'node:child_process';
28
+ /** {@link stopForkedChild} 的三段等待预算(毫秒) */
29
+ export interface StopForkedChildOptions {
30
+ /** 发 close 消息后等子进程自行收摊的宽限 */
31
+ graceMs: number;
32
+ /** SIGTERM 后等它退出的宽限 */
33
+ termMs: number;
34
+ /** SIGKILL 后仍观察 exit 的时长,超时则放行并告警 */
35
+ reapFallbackMs: number;
36
+ /** 告警里的调用方标识(如 `knowledge` / `run`):兜底放行时排障要知道是谁 */
37
+ label: string;
38
+ }
39
+ /** 调用方可选的三路 stdio 策略(取值收窄:本函数只支持这三者) */
40
+ export type ChildStdio = 'ignore' | 'inherit' | 'pipe';
41
+ /** `forkChildNodeOptions` 的调用方可变项 */
42
+ export interface ForkChildNodeOptionsInput {
43
+ /** `[stdin, stdout, stderr]`;ipc 通道由本函数追加 */
44
+ stdio: readonly [ChildStdio, ChildStdio, ChildStdio];
45
+ }
46
+ /**
47
+ * 当前进程是否跑在 Electron 宿主里(打包的桌面端 / MiMo.exe)。
48
+ *
49
+ * `process.versions.electron` 是权威判据;execPath 正则只作兜底(老版本 Electron 或
50
+ * 包装器可能不设 versions.electron)。兜底会误判路径中恰好含 `electron` 的普通 node
51
+ * 宿主,代价是多设一个 `ELECTRON_RUN_AS_NODE=1`(对 node 无副作用)。
52
+ *
53
+ * @returns true 表示需要以 node 模式拉起 node 子进程
54
+ */
55
+ export declare function isElectronHost(): boolean;
56
+ /**
57
+ * 生成本地 node 子进程的 fork 选项。
58
+ *
59
+ * @param input - 调用方决定的前三路 stdio 策略
60
+ * @returns 完整 fork 选项(含 `windowsHide` 与 ipc 末位)
61
+ */
62
+ export declare function forkChildNodeOptions(input: ForkChildNodeOptionsInput): ForkOptions & {
63
+ windowsHide?: boolean;
64
+ };
65
+ /**
66
+ * 停止一个由 {@link forkChildNodeOptions} 拉起的本地 node 子进程。
67
+ *
68
+ * 与「发个信号就返回」的区别:**完成条件必须是观察到 `exit`**。调用方依赖这个语义
69
+ * (释放文件句柄后才能删目录;Windows 上删被打开的文件直接 EPERM)。
70
+ *
71
+ * 阶梯:`close` 消息(通道在)→ graceMs → SIGTERM → termMs → SIGKILL → reapFallbackMs
72
+ * 兜底放行(并 warn)。兜底是为了不让不可观测的僵尸把调用方永久挂住;它牺牲了
73
+ * 「绝对已退出」,因此必须留痕而不是静默。
74
+ *
75
+ * 集中在这里的原因:两处调用方(knowledge 子进程 / run 实例)曾各自实现,阶梯与兜底
76
+ * 已经漂移——run 侧是 5s/3s 且 SIGKILL 后 `await exited` 无兜底,理论上可永久挂起。
77
+ *
78
+ * @param child - 目标子进程
79
+ * @param options - 三段等待预算(毫秒)
80
+ * @returns 子进程已退出(或兜底放行)时 resolve
81
+ */
82
+ export declare function stopForkedChild(child: ChildProcess, options: StopForkedChildOptions): Promise<void>;
@@ -0,0 +1,123 @@
1
+ /**
2
+ * 当前进程是否跑在 Electron 宿主里(打包的桌面端 / MiMo.exe)。
3
+ *
4
+ * `process.versions.electron` 是权威判据;execPath 正则只作兜底(老版本 Electron 或
5
+ * 包装器可能不设 versions.electron)。兜底会误判路径中恰好含 `electron` 的普通 node
6
+ * 宿主,代价是多设一个 `ELECTRON_RUN_AS_NODE=1`(对 node 无副作用)。
7
+ *
8
+ * @returns true 表示需要以 node 模式拉起 node 子进程
9
+ */
10
+ export function isElectronHost() {
11
+ return (Boolean(process.versions.electron) ||
12
+ /electron|MiMo\.exe/i.test(process.execPath));
13
+ }
14
+ /**
15
+ * 生成本地 node 子进程的 fork 选项。
16
+ *
17
+ * @param input - 调用方决定的前三路 stdio 策略
18
+ * @returns 完整 fork 选项(含 `windowsHide` 与 ipc 末位)
19
+ */
20
+ export function forkChildNodeOptions(input) {
21
+ const env = { ...process.env };
22
+ delete env.NODE_CHANNEL_FD;
23
+ delete env.NODE_CHANNEL_ID;
24
+ delete env.NODE_CHANNEL_SERIALIZATION;
25
+ delete env.NODE_UNIQUE_ID;
26
+ if (isElectronHost()) {
27
+ env.ELECTRON_RUN_AS_NODE = '1';
28
+ }
29
+ return {
30
+ execArgv: [],
31
+ stdio: [input.stdio[0], input.stdio[1], input.stdio[2], 'ipc'],
32
+ env,
33
+ windowsHide: true,
34
+ };
35
+ }
36
+ /**
37
+ * 停止一个由 {@link forkChildNodeOptions} 拉起的本地 node 子进程。
38
+ *
39
+ * 与「发个信号就返回」的区别:**完成条件必须是观察到 `exit`**。调用方依赖这个语义
40
+ * (释放文件句柄后才能删目录;Windows 上删被打开的文件直接 EPERM)。
41
+ *
42
+ * 阶梯:`close` 消息(通道在)→ graceMs → SIGTERM → termMs → SIGKILL → reapFallbackMs
43
+ * 兜底放行(并 warn)。兜底是为了不让不可观测的僵尸把调用方永久挂住;它牺牲了
44
+ * 「绝对已退出」,因此必须留痕而不是静默。
45
+ *
46
+ * 集中在这里的原因:两处调用方(knowledge 子进程 / run 实例)曾各自实现,阶梯与兜底
47
+ * 已经漂移——run 侧是 5s/3s 且 SIGKILL 后 `await exited` 无兜底,理论上可永久挂起。
48
+ *
49
+ * @param child - 目标子进程
50
+ * @param options - 三段等待预算(毫秒)
51
+ * @returns 子进程已退出(或兜底放行)时 resolve
52
+ */
53
+ export async function stopForkedChild(child, options) {
54
+ if (child.exitCode != null || child.signalCode != null)
55
+ return;
56
+ await new Promise((resolve) => {
57
+ let graceTimer;
58
+ let termTimer;
59
+ let reapFallbackTimer;
60
+ let settled = false;
61
+ let escalated = false;
62
+ const finish = () => {
63
+ settled = true;
64
+ if (graceTimer)
65
+ clearTimeout(graceTimer);
66
+ if (termTimer)
67
+ clearTimeout(termTimer);
68
+ if (reapFallbackTimer)
69
+ clearTimeout(reapFallbackTimer);
70
+ child.off('exit', finish);
71
+ resolve();
72
+ };
73
+ child.once('exit', finish);
74
+ /** SIGTERM → termMs → SIGKILL → reapFallbackMs 兜底。单发。 */
75
+ const escalate = () => {
76
+ // settled 也要查:exit 先到之后迟到的 send 错误仍可能进来,此时再武装定时器
77
+ // 会在 promise 已 resolve 后打出假的 unobservable 告警。
78
+ if (settled || escalated)
79
+ return;
80
+ escalated = true;
81
+ if (graceTimer)
82
+ clearTimeout(graceTimer);
83
+ try {
84
+ child.kill('SIGTERM');
85
+ }
86
+ catch {
87
+ /* 已经退出:exit 事件会/已把 promise 收掉 */
88
+ }
89
+ termTimer = setTimeout(() => {
90
+ try {
91
+ child.kill('SIGKILL');
92
+ }
93
+ catch {
94
+ /* 已经退出(同上) */
95
+ }
96
+ reapFallbackTimer = setTimeout(() => {
97
+ console.warn(`[child-process:${options.label}] pid=${String(child.pid)} unobservable after SIGKILL; releasing stop() without exit`);
98
+ finish();
99
+ }, options.reapFallbackMs);
100
+ reapFallbackTimer.unref?.();
101
+ }, options.termMs);
102
+ termTimer.unref?.();
103
+ };
104
+ if (!child.connected) {
105
+ // 通道已断(等价宿主硬死):没有优雅关闭通道可走,直接升级
106
+ escalate();
107
+ return;
108
+ }
109
+ graceTimer = setTimeout(escalate, options.graceMs);
110
+ graceTimer.unref?.();
111
+ try {
112
+ // 通道刚断时 send 不抛异常,错误只进回调——必须由回调转入升级,
113
+ // 否则会白等满 graceMs。无回调形式会 emit 'error',可致未捕获异常。
114
+ child.send({ type: 'close' }, (err) => {
115
+ if (err)
116
+ escalate();
117
+ });
118
+ }
119
+ catch {
120
+ escalate();
121
+ }
122
+ });
123
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * delegated-run — 委派子 run 的执行腿适配(arch/service-topology.md §9.5 S1 收口)。
3
+ *
4
+ * attach / child-run 不持裸 runner:RunnerChildRunPort 调的 `handle()` 经
5
+ * RunRequest → host.startRun(准入闸门 + in-flight 计数 + abort 判据 + 退役可见),
6
+ * 不再直连 SessionAwareRunner.handle。与 SessionRunnerDispatcher(RunRequest →
7
+ * runner.handle)互为正反映射。
8
+ */
9
+ import type { Message } from '@octopi-agent/core/types.js';
10
+ import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
11
+ import type { RunRequest } from './types.js';
12
+ import type { RunConfig } from '../run/runner.js';
13
+ /** 执行腿依赖面(RunHost 结构子集:get / ensureMounted / startRun + 定义查询) */
14
+ export interface DelegatedLegDeps {
15
+ /** 挂载查询:已挂载返回真值 */
16
+ get(agentId: string): unknown;
17
+ /** get-or-mount(B1 单飞语义在 host 内) */
18
+ ensureMounted(agentId: string, definition: Record<string, unknown>): Promise<unknown>;
19
+ /** 契约执行入口(startRun:准入 + in-flight + abort) */
20
+ startRun(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
21
+ /** 目标 agent 定义查询;undefined = 不可委派 */
22
+ getDefinition(agentId: string): Record<string, unknown> | undefined;
23
+ }
24
+ /**
25
+ * 构造委派子 run 的 RunRequest(纯映射)。
26
+ * D3 天花板随 req 透传,由 Runner 与模板天花板取交集(只能收紧)。
27
+ *
28
+ * @param sessionId - 子会话 id(D7 预创建,含 spawnBy)
29
+ * @param input - RunnerChildRunPort 交给 handle 的用户输入
30
+ * @param runConfig - 子 run 配置(systemPrompt / rightsCeiling / model)
31
+ * @returns 契约 RunRequest
32
+ * @throws runConfig.agentId 缺失(委派执行腿必有目标)
33
+ */
34
+ export declare function buildDelegatedRunRequest(sessionId: string, input: Message, runConfig: RunConfig): RunRequest;
35
+ /**
36
+ * 委派子 run 的执行腿 handle(SessionAwareRunner.handle 的结构替代面)。
37
+ * 目标未挂载即 get-or-mount(/runs 同语义);缺定义 fail-loud。
38
+ *
39
+ * @param deps - 执行腿依赖面
40
+ * @returns handle(sessionId, input, runConfig, signal) 事件流
41
+ */
42
+ export declare function createDelegatedLegHandle(deps: DelegatedLegDeps): (sessionId: string, input: Message, runConfig: RunConfig, signal?: AbortSignal) => AsyncGenerator<AgentEvent>;
@@ -0,0 +1,71 @@
1
+ /**
2
+ * delegated-run — 委派子 run 的执行腿适配(arch/service-topology.md §9.5 S1 收口)。
3
+ *
4
+ * attach / child-run 不持裸 runner:RunnerChildRunPort 调的 `handle()` 经
5
+ * RunRequest → host.startRun(准入闸门 + in-flight 计数 + abort 判据 + 退役可见),
6
+ * 不再直连 SessionAwareRunner.handle。与 SessionRunnerDispatcher(RunRequest →
7
+ * runner.handle)互为正反映射。
8
+ */
9
+ import { randomUUID } from 'node:crypto';
10
+ /**
11
+ * 构造委派子 run 的 RunRequest(纯映射)。
12
+ * D3 天花板随 req 透传,由 Runner 与模板天花板取交集(只能收紧)。
13
+ *
14
+ * @param sessionId - 子会话 id(D7 预创建,含 spawnBy)
15
+ * @param input - RunnerChildRunPort 交给 handle 的用户输入
16
+ * @param runConfig - 子 run 配置(systemPrompt / rightsCeiling / model)
17
+ * @returns 契约 RunRequest
18
+ * @throws runConfig.agentId 缺失(委派执行腿必有目标)
19
+ */
20
+ export function buildDelegatedRunRequest(sessionId, input, runConfig) {
21
+ const agentId = runConfig.agentId;
22
+ if (!agentId) {
23
+ throw new Error('delegate child run requires runConfig.agentId');
24
+ }
25
+ const text = typeof input.content === 'string' ? input.content : JSON.stringify(input.content ?? '');
26
+ const trigger = {
27
+ id: `child-${randomUUID()}`,
28
+ type: 'message',
29
+ agentId,
30
+ sessionId,
31
+ timestamp: Date.now(),
32
+ payload: { kind: 'user_message', content: text },
33
+ };
34
+ return {
35
+ requestId: `child-${randomUUID()}`,
36
+ triggers: [trigger],
37
+ agentId,
38
+ sessionId,
39
+ messages: [input],
40
+ actorType: 'agent',
41
+ // §9.1-6:子 run principal 归属继承父租户(dispatcher 合入 principal)
42
+ ...(runConfig.principal?.tenantId === undefined ? {} : { tenantId: runConfig.principal.tenantId }),
43
+ ...(runConfig.model === undefined ? {} : { modelOverride: runConfig.model }),
44
+ ...(runConfig.modelProvider === undefined ? {} : { modelProvider: runConfig.modelProvider }),
45
+ ...(runConfig.systemPrompt === undefined ? {} : { systemPrompt: runConfig.systemPrompt }),
46
+ ...(runConfig.rightsCeiling === undefined ? {} : { rightsCeiling: runConfig.rightsCeiling }),
47
+ };
48
+ }
49
+ /**
50
+ * 委派子 run 的执行腿 handle(SessionAwareRunner.handle 的结构替代面)。
51
+ * 目标未挂载即 get-or-mount(/runs 同语义);缺定义 fail-loud。
52
+ *
53
+ * @param deps - 执行腿依赖面
54
+ * @returns handle(sessionId, input, runConfig, signal) 事件流
55
+ */
56
+ export function createDelegatedLegHandle(deps) {
57
+ return (sessionId, input, runConfig, signal) => (async function* () {
58
+ const agentId = runConfig.agentId;
59
+ if (!agentId) {
60
+ throw new Error('delegate child run requires runConfig.agentId');
61
+ }
62
+ const def = deps.getDefinition(agentId);
63
+ if (!def) {
64
+ throw new Error(`delegate target not runnable: ${agentId}`);
65
+ }
66
+ if (!deps.get(agentId)) {
67
+ await deps.ensureMounted(agentId, def);
68
+ }
69
+ yield* deps.startRun(buildDelegatedRunRequest(sessionId, input, runConfig), signal);
70
+ })();
71
+ }
@@ -27,6 +27,10 @@ export class SessionRunnerDispatcher {
27
27
  sessionId: req.sessionId,
28
28
  model: req.modelOverride,
29
29
  modelProvider: req.modelProvider,
30
+ // per-run 覆盖(委派子 run):显式值后置胜出;rightsCeiling 由 Runner
31
+ // 与模板天花板取交集(D3 只能收紧),此处透传不放宽。
32
+ ...(req.systemPrompt === undefined ? {} : { systemPrompt: req.systemPrompt }),
33
+ ...(req.rightsCeiling === undefined ? {} : { rightsCeiling: req.rightsCeiling }),
30
34
  ...(req.actorId === undefined && req.actorType === undefined && req.tenantId === undefined ? {} : {
31
35
  principal: {
32
36
  ...(req.actorId === undefined ? {} : { actorId: req.actorId }),
@@ -18,3 +18,4 @@ export { RuntimeEvents } from './types.js';
18
18
  export { ScheduleSource, EscalateBridge, AgentSignalSource, emitEscalate, emitAgentSignal, ESCALATE_EVENT_TYPE, SIGNAL_ESCALATE_EVENT_TYPE, AGENT_SIGNAL_EVENT_TYPE, } from './sources/index.js';
19
19
  export type { ScheduleJob, ScheduleSourceConfig, EscalateBridgeConfig, AgentSignal, AgentSignalSourceConfig, } from './sources/index.js';
20
20
  export type { Trigger, TriggerType, TriggerPayload, TriggerSource, RunRequest, RunDispatcher, RouteTarget, AgentRouter, RuntimeAgent, DispatchResult, FanoutDispatchResult, RuntimeEvent, RuntimeEventType, RuntimeEventListener, } from './types.js';
21
+ export type { RunBackend, RunBackendHealth, } from './run-backend.js';
@@ -0,0 +1,92 @@
1
+ /**
2
+ * RunBackend — gateway ↔ run 侧契约缝(arch/service-topology.md §4)
3
+ *
4
+ * 语义边界(触发面/执行面分离,§5.4):
5
+ * - 触发面(AgentRuntime / TriggerSource / 准入政策)归 gateway;
6
+ * - 执行面(Runner 构建/执行/退役/会话锁)一律经本契约触达,gateway 不得直摸 Runner。
7
+ *
8
+ * 实现分期(§4 单实现决策):
9
+ * - P0a:InProcessRunBackend(gateway 包内,进程内脚手架,P0b 后删除);
10
+ * - P0b 起:RemoteRunBackend(进程间唯一实现)。
11
+ *
12
+ * P0b 迁移注记:compactSession 的函数型参数(compactStructural / summarize)已数据化
13
+ * 清偿(2026-11-10,解析入 engine RunHost)——控制面只传键,实现在 run 侧解析。
14
+ * 本契约禁止再引入函数型参数。
15
+ */
16
+ import type { RunDispatcher } from './types.js';
17
+ import type { SessionLease } from '../run/concurrency/session-lease.js';
18
+ import type { CompactTransportOutcome } from '../context/capabilities/compact/types.js';
19
+ import type { OpsAuditEvent } from '../extension/execution-environment/ops-audit.js';
20
+ /**
21
+ * run 起点准入闸门结果(三件套:账本 event + state + run 通道错误,ops P2)。
22
+ * 政策面(gateway)↔ 执行面(backend)的握手类型;远程化时须可传输(state 保持
23
+ * 原样序列化,不在此收窄——闸门可为 knowledge/drift/kill-switch 等多种政策复用)。
24
+ */
25
+ export interface AdmissionGateResult {
26
+ /** 账本事件名(联合类型,如 ops.knowledge.run_refused) */
27
+ event: OpsAuditEvent;
28
+ /** run 通道错误文案(也是账本 reason) */
29
+ error: string;
30
+ /** 账本 state 载荷(如 knowledge 运行状态) */
31
+ state: unknown;
32
+ }
33
+ /** 运行面健康快照 */
34
+ export interface RunBackendHealth {
35
+ mountedAgents: number;
36
+ inFlightRuns: number;
37
+ retiredRunners: number;
38
+ /**
39
+ * 脉搏自述(P0c A′):装配产物声明的全部 PulseSpec。gateway 脉搏调度器据此
40
+ * 单发驱动;也是「无 self-arm 定时器」结构性断言的自证面(清单有、定时器无)。
41
+ */
42
+ pulses?: import('../activation/run-protocol.js').PulseSpec[];
43
+ /**
44
+ * fleet 聚合时的不可达实例清单(单实例恒空;fail-loud 可见性,§4.2)。
45
+ * 现状:生产消费者仅 fleetStatus 诊断面(DOC-5 标注:诊断预留,非控制信号)。
46
+ */
47
+ unreachableInstances?: string[];
48
+ /**
49
+ * 守卫在位状态(§4.3 健康门跨版本核查):'armed'=实例按 configPath 自建了
50
+ * securityIntegrity 守卫;'absent'=未自建(旧版 run-serve-child 或未配)。
51
+ * 配置含 securityIntegrity 而实例报 absent → 健康门拒(防跨版本漂移闸 fail-open)。
52
+ */
53
+ securityGuard?: 'armed' | 'absent';
54
+ }
55
+ /**
56
+ * RunBackend —— run 托管契约(单一 remote 实现为终态)。
57
+ *
58
+ * 契约拆分(P1-1b,OP-P0B-1 ③):P0a 脚手架面(mount/get/handles/
59
+ * mountedAgentIds/retire + InProcessAgentHandle/RunBackendMountSpec)已归
60
+ * RunHost 域(harness/run/run-host.ts)——执行体装配是 run 服务自身面,
61
+ * 不是 gateway 消费面。本契约只保留 gateway 侧消费面。
62
+ *
63
+ * 错误表面(fail-loud,两形态):未装载时 `execute`/`compactSession` **同步抛错**;
64
+ * 准入闸门拒 run 是**异步事件流内抛错**(消费方经 for-await 收到)。远程实现须把
65
+ * 两者映射为明确的失败事件,不得静默吞(§4 契约纪律)。
66
+ *
67
+ * `execute`(继承自 RunDispatcher)是契约统一执行入口(测试与未来 startRun 通道
68
+ * 使用);in-process 生产链路当前经 AgentRuntime → handle.dispatcher 直达同一包装,
69
+ * 两条路汇聚于同一执行腿,无第二执行语义。
70
+ */
71
+ export interface RunBackend extends RunDispatcher {
72
+ /** 会话执行互斥(宪法 E1/E2;run lease 前身,P1 分布式化) */
73
+ readonly sessionLock: SessionLease;
74
+ /**
75
+ * 会话压缩(控制面 op;与 run 共用 sessionLock 排队)。
76
+ * 纯数据签名:systemPrompt/tools/摘要绑定由实现侧(RunHost)从 run 状态解析。
77
+ *
78
+ * @param sessionId - 会话 id
79
+ * @param agentId - compact 视图归属 agent
80
+ * @returns 压缩结果
81
+ */
82
+ compactSession(sessionId: string, agentId: string): Promise<CompactTransportOutcome>;
83
+ /**
84
+ * 运行面健康(supervise 健康门的进程内形态)。
85
+ * 计数口径注记:inFlightRuns 只计**在挂**执行体;热失效退役中仍有 in-flight 的
86
+ * runner 不计入(retiredRunners 只报个数)。P0c 接健康门时须先补退役侧计数,
87
+ * 否则会低估负载(见 arch/service-topology.md §5)。
88
+ */
89
+ health(): Promise<RunBackendHealth>;
90
+ /** 全量回收(停机路径,fail-open) */
91
+ disposeAll(): void;
92
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * RunBackend — gateway ↔ run 侧契约缝(arch/service-topology.md §4)
3
+ *
4
+ * 语义边界(触发面/执行面分离,§5.4):
5
+ * - 触发面(AgentRuntime / TriggerSource / 准入政策)归 gateway;
6
+ * - 执行面(Runner 构建/执行/退役/会话锁)一律经本契约触达,gateway 不得直摸 Runner。
7
+ *
8
+ * 实现分期(§4 单实现决策):
9
+ * - P0a:InProcessRunBackend(gateway 包内,进程内脚手架,P0b 后删除);
10
+ * - P0b 起:RemoteRunBackend(进程间唯一实现)。
11
+ *
12
+ * P0b 迁移注记:compactSession 的函数型参数(compactStructural / summarize)已数据化
13
+ * 清偿(2026-11-10,解析入 engine RunHost)——控制面只传键,实现在 run 侧解析。
14
+ * 本契约禁止再引入函数型参数。
15
+ */
16
+ export {};