@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
package/dist/config.js CHANGED
@@ -2,6 +2,15 @@ import { getRunScope } from './harness/run/run-scope.js';
2
2
  import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
3
3
  /** 产品默认上下文窗口(与 core/types/model-info 一致,未声明能力时按此预算) */
4
4
  export { DEFAULT_CONTEXT_WINDOW };
5
+ /**
6
+ * 判定 listen 地址是否仅回环可达(B-1:无钥告警分级依据——非回环 = 网络敞开)
7
+ *
8
+ * @param host - `resolveListenHost` 解析后的 listen 地址
9
+ * @returns 是否回环(127/8 · ::1 · localhost)
10
+ */
11
+ export function isLoopbackListenHost(host) {
12
+ return /^(127\.\d{1,3}\.\d{1,3}\.\d{1,3}|::1|localhost)$/i.test(host.trim());
13
+ }
5
14
  /**
6
15
  * 将 host 配置解析为 HTTP listen 地址
7
16
  *
@@ -54,7 +63,8 @@ export function flattenModels(config) {
54
63
  result.push({
55
64
  id: `${providerName}/${mc.id}`,
56
65
  provider: providerName,
57
- model: mc.name ?? mc.id,
66
+ // 请求模型字段 = 目录 id;`name` 是纯展示名,绝不进请求(曾被误当 model 发出 → API 400)
67
+ model: mc.id,
58
68
  contextWindow: mc.contextWindow,
59
69
  maxTokens: mc.maxTokens,
60
70
  });
@@ -145,7 +155,6 @@ function resolveFallbackModels(fallbacks, models, defaults, depth = 0) {
145
155
  return {
146
156
  provider: m.provider,
147
157
  model: m.model,
148
- temperature: m.temperature,
149
158
  maxTokens: m.maxTokens,
150
159
  contextWindow: m.contextWindow ?? defaults?.contextWindow,
151
160
  fallbackModels: resolveFallbackModels(m.fallbackModels, models, defaults, depth + 1),
@@ -185,17 +194,33 @@ export async function createWireDumpSinkFromConfig(cfg) {
185
194
  /**
186
195
  * 从 ModelProviderConfig 创建 ModelProvider 实例
187
196
  *
188
- * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
189
- * 使用动态 import 以支持 ESM。
197
+ * `api` 选择内置适配器(OpenAI / Anthropic);`plugin` 路由到插件 Provider 工厂。
198
+ * 两者恰好设置其一。使用动态 import 以支持 ESM。
190
199
  *
191
200
  * @param name - provider 名称
192
201
  * @param pc - provider 配置
193
- * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
202
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`);
203
+ * `resolvePluginProvider` 解析插件 Provider 工厂(`pc.plugin` 必需)
194
204
  * @returns provider 实例(wire dump → 原生 provider 的装饰链;LLM 计时已 observability 化进 model.call.*)
195
205
  */
196
206
  export async function createProviderFromConfig(name, pc, options) {
197
- const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
198
- const models = pc.models.map(m => ({ name: m.name ?? m.id, contextWindow: m.contextWindow, maxOutputTokens: m.maxTokens, temperature: m.temperature }));
207
+ if ((pc.api === undefined) === (pc.plugin === undefined)) {
208
+ throw new Error(`Provider "${name}": exactly one of api | plugin must be set`);
209
+ }
210
+ const models = pc.models.map((m) => {
211
+ const entry = { name: m.name ?? m.id };
212
+ if (m.contextWindow !== undefined)
213
+ entry.contextWindow = m.contextWindow;
214
+ if (m.maxTokens !== undefined)
215
+ entry.maxOutputTokens = m.maxTokens;
216
+ if (m.temperature !== undefined)
217
+ entry.temperature = m.temperature;
218
+ if (m.reasoning !== undefined)
219
+ entry.reasoning = m.reasoning;
220
+ if (m.input !== undefined)
221
+ entry.input = m.input;
222
+ return entry;
223
+ });
199
224
  const defaultModel = pc.models[0]?.name ?? pc.models[0]?.id;
200
225
  let decorate = (inner) => inner;
201
226
  if (options?.wireDump) {
@@ -205,6 +230,39 @@ export async function createProviderFromConfig(name, pc, options) {
205
230
  const sink = options.wireDump;
206
231
  decorate = (inner) => withWireDump(inner, sink);
207
232
  }
233
+ if (pc.plugin !== undefined) {
234
+ const record = options?.resolvePluginProvider?.(pc.plugin);
235
+ if (!record) {
236
+ throw new Error(`Provider "${name}": plugin provider "${pc.plugin}" is not registered (plugin disabled, failed, or not discovered)`);
237
+ }
238
+ const built = await record.factory({
239
+ providerName: name,
240
+ baseUrl: pc.baseUrl,
241
+ apiKey: pc.apiKey ?? '',
242
+ models,
243
+ ...(defaultModel === undefined ? {} : { defaultModel }),
244
+ ...(pc.timeoutSeconds === undefined ? {} : { timeoutMs: pc.timeoutSeconds * 1000 }),
245
+ options: pc.options ?? {},
246
+ });
247
+ // 最小契约校验 + name 绑定:工厂结果必须挂在配置键下,
248
+ // 否则 gateway 按 provider.name 注册会挂到错误的名字上
249
+ for (const method of ['chat', 'stream', 'isAvailable']) {
250
+ if (typeof built?.[method] !== 'function') {
251
+ throw new Error(`Provider "${name}": plugin provider "${pc.plugin}" factory returned an invalid ModelProvider (missing ${method})`);
252
+ }
253
+ }
254
+ if (built.name !== name) {
255
+ throw new Error(`Provider "${name}": plugin provider "${pc.plugin}" factory returned provider.name "${built.name}"; it must equal the config key "${name}"`);
256
+ }
257
+ // 出生 = 宿主验收:校验通过后登记工厂产物本身(先于 decorate——wire-dump
258
+ // 副本的 dispose 转发链要闭合到退役标记上)。查询返回产物,插件私有方法
259
+ // 只存在于产物上;宿主路由可能经装饰副本(仅 SPI 成员)转发到它。
260
+ if (record.acceptInstance && !record.acceptInstance(built, name)) {
261
+ console.warn(`Provider "${name}": plugin provider instance cannot be retirement-tracked (frozen/sealed); contribution lookup will report it as never instantiated`);
262
+ }
263
+ return decorate(built);
264
+ }
265
+ const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
208
266
  if (apiType === 'anthropic') {
209
267
  const { AnthropicProvider } = await import('./integration/providers/anthropic.js');
210
268
  return decorate(new AnthropicProvider({ name, apiKey: pc.apiKey ?? '', baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
@@ -212,6 +270,50 @@ export async function createProviderFromConfig(name, pc, options) {
212
270
  const { OpenAIProvider } = await import('./integration/providers/openai.js');
213
271
  return decorate(new OpenAIProvider({ name, apiKey: pc.apiKey ?? '', baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
214
272
  }
273
+ /**
274
+ * 从 `channels[]` 配置条目创建插件 Channel Adapter。
275
+ *
276
+ * `plugin` 路由到插件 Channel 工厂(`contributes.channels` 命名贡献);
277
+ * 内置 `type: 'http'` 由 daemon 的 HttpChannelAdapter 装配,不走本函数。
278
+ * 与 `createProviderFromConfig` 同闸:type | plugin 恰好其一,工厂是第二道闸。
279
+ *
280
+ * @param entry - channels[] 配置条目
281
+ * @param resolvePluginChannel - 解析插件 Channel 工厂(`entry.plugin` 必需)
282
+ * @returns ChannelAdapter 实例(最小契约校验,name 硬绑定贡献 id)
283
+ */
284
+ export async function createChannelAdapterFromConfig(entry, resolvePluginChannel) {
285
+ if ((entry.type === undefined) === (entry.plugin === undefined)) {
286
+ throw new Error('Channel: exactly one of type | plugin must be set');
287
+ }
288
+ if (entry.plugin === undefined) {
289
+ throw new Error(`Channel type "${entry.type}" has no built-in adapter (built-ins: http); use "plugin" for plugin channels`);
290
+ }
291
+ const ref = entry.plugin;
292
+ const record = resolvePluginChannel(ref);
293
+ if (!record) {
294
+ throw new Error(`Channel "${ref}": plugin channel "${ref}" is not registered (plugin disabled, failed, or not discovered)`);
295
+ }
296
+ const built = await record.factory({
297
+ channelName: ref,
298
+ apiKey: entry.apiKey ?? '',
299
+ options: entry.options ?? {},
300
+ });
301
+ // 最小契约校验 + name 绑定:工厂结果必须挂在贡献 id 下,
302
+ // 否则 gateway 按 adapter.name 注册、回复按 msg.channel 路由都会错位
303
+ for (const member of ['start', 'send', 'stop']) {
304
+ if (typeof built?.[member] !== 'function') {
305
+ throw new Error(`Channel "${ref}": plugin channel factory returned an invalid ChannelAdapter (missing ${member})`);
306
+ }
307
+ }
308
+ if (built.name !== ref) {
309
+ throw new Error(`Channel "${ref}": plugin channel factory returned adapter.name "${built.name}"; it must equal the contribution id "${ref}"`);
310
+ }
311
+ // 出生 = 宿主验收:校验通过后登记实例,与 provider 同语义
312
+ if (record.acceptInstance && !record.acceptInstance(built, ref)) {
313
+ console.warn(`Channel "${ref}": plugin channel instance cannot be retirement-tracked (frozen); contribution lookup will report it as never instantiated`);
314
+ }
315
+ return built;
316
+ }
215
317
  /**
216
318
  * 按 `observability` 配置构造 RunTelemetry 工厂(F3/D5 接线,组合根)
217
319
  *
@@ -0,0 +1,67 @@
1
+ /**
2
+ * 平台能力探测 + 秘密文件的真实权限收紧。
3
+ *
4
+ * ## 为什么不能只靠 `mode: 0o600`
5
+ *
6
+ * `statSync(path).mode & 0o777` 在 Windows 上恒报 `0o666` 形态,与 `writeFile` 的
7
+ * `mode`、`chmodSync` 都无关——所以「用 mode 保护秘密文件」在 Windows 上**完全不生效**。
8
+ * 实测:`writeFileSync(f, '{"apiKey":"sk-..."}', {mode:0o600})` 之后,`f` 的 ACL 仍是
9
+ * 从父目录继承来的一串主体(含一个可修改的用户组与多个可读写 SID)。也就是说秘密
10
+ * 文件的保护面完全由**它落在哪个目录**决定。
11
+ *
12
+ * ## 因此这里的契约是「收紧,而不是请求」
13
+ *
14
+ * - POSIX:`chmod` 就是真实生效的收紧。
15
+ * - Windows:改成 ACL——`icacls <target> /inheritance:r /grant:r "<user>:F"`,移除
16
+ * 继承并只授予当前用户。实测收紧后目录为 `user:(OI)(CI)(F)`、其中新建文件自动继承
17
+ * `user:(I)(F)`,不再有其他主体。
18
+ *
19
+ * 收紧失败时**不留文件**:一个已知不安全的秘密文件比没有文件更糟(调用方拿到的是
20
+ * "写成功"的假象)。`writeSecretFileSync` 会删掉已写内容再抛错。
21
+ *
22
+ * ## 平台判断为什么集中在这里
23
+ *
24
+ * 生产侧(`plugin doctor`、boot 文件写入)与测试侧(权限断言)必须同一口径,否则会
25
+ * 各自漂移——`plugin doctor` 曾因在 Windows 上判 `mode & 0o077` 而对每个 state 目录
26
+ * 误报告警。
27
+ */
28
+ /**
29
+ * 当前平台是否支持 POSIX 文件权限位(Windows 不支持)。
30
+ *
31
+ * 注意这是**平台能力**而非"平台名":判断放在这里而不是散落 `process.platform === 'win32'`,
32
+ * 是为了让生产侧与测试侧用同一个口径。
33
+ */
34
+ export declare const POSIX_FILE_MODE: boolean;
35
+ /**
36
+ * 把目标收紧到「仅当前用户可访问」。
37
+ *
38
+ * @param target - 文件或目录路径
39
+ * @param kind - `dir` 用继承形式授权(`(OI)(CI)`),使其中新建的文件自动安全
40
+ * @throws 当无法收紧时抛出(调用方不得把它当作可忽略的告警)
41
+ */
42
+ export declare function restrictToOwner(target: string, kind: 'file' | 'dir'): void;
43
+ /**
44
+ * 创建仅当前用户可访问的临时目录。
45
+ *
46
+ * 秘密文件应放这里而非直接平铺在共享 tmpdir:目录收紧后,其中新建文件自动继承安全
47
+ * ACL,等于在创建时就消除了暴露窗口。
48
+ *
49
+ * @param prefix - 目录名前缀(便于诊断)
50
+ * @returns 私有临时目录的绝对路径
51
+ */
52
+ export declare function createPrivateTempDir(prefix: string): string;
53
+ /**
54
+ * 同步写入秘密文件,并把权限真实收紧到仅当前用户。
55
+ *
56
+ * 与 `writeFileSync(..., {mode: 0o600})` 的区别:后者在 Windows 上不生效。
57
+ *
58
+ * 三步走(写 tmp → 收紧 tmp → rename)而不是直接写目标:目标可能已存在且是**有效**的
59
+ * 旧秘密(例如上一轮签发的 setup token)。直接写再收紧的话,一旦收紧失败就得删文件,
60
+ * 等于把旧秘密一起毁掉。这个顺序同时消除了「写完成 → 收紧完成」之间的暴露窗口;
61
+ * 同卷 rename 不会重新继承 ACL(实测 Windows 上收紧后的 ACL 完整保留)。
62
+ *
63
+ * @param filePath - 目标路径(父目录应当已经是私有的,见 {@link createPrivateTempDir})
64
+ * @param data - 文件内容
65
+ * @throws 当权限无法收紧时(此时目标文件保持原状,临时文件已删除)
66
+ */
67
+ export declare function writeSecretFileSync(filePath: string, data: string): void;
@@ -0,0 +1,182 @@
1
+ /**
2
+ * 平台能力探测 + 秘密文件的真实权限收紧。
3
+ *
4
+ * ## 为什么不能只靠 `mode: 0o600`
5
+ *
6
+ * `statSync(path).mode & 0o777` 在 Windows 上恒报 `0o666` 形态,与 `writeFile` 的
7
+ * `mode`、`chmodSync` 都无关——所以「用 mode 保护秘密文件」在 Windows 上**完全不生效**。
8
+ * 实测:`writeFileSync(f, '{"apiKey":"sk-..."}', {mode:0o600})` 之后,`f` 的 ACL 仍是
9
+ * 从父目录继承来的一串主体(含一个可修改的用户组与多个可读写 SID)。也就是说秘密
10
+ * 文件的保护面完全由**它落在哪个目录**决定。
11
+ *
12
+ * ## 因此这里的契约是「收紧,而不是请求」
13
+ *
14
+ * - POSIX:`chmod` 就是真实生效的收紧。
15
+ * - Windows:改成 ACL——`icacls <target> /inheritance:r /grant:r "<user>:F"`,移除
16
+ * 继承并只授予当前用户。实测收紧后目录为 `user:(OI)(CI)(F)`、其中新建文件自动继承
17
+ * `user:(I)(F)`,不再有其他主体。
18
+ *
19
+ * 收紧失败时**不留文件**:一个已知不安全的秘密文件比没有文件更糟(调用方拿到的是
20
+ * "写成功"的假象)。`writeSecretFileSync` 会删掉已写内容再抛错。
21
+ *
22
+ * ## 平台判断为什么集中在这里
23
+ *
24
+ * 生产侧(`plugin doctor`、boot 文件写入)与测试侧(权限断言)必须同一口径,否则会
25
+ * 各自漂移——`plugin doctor` 曾因在 Windows 上判 `mode & 0o077` 而对每个 state 目录
26
+ * 误报告警。
27
+ */
28
+ import { execFileSync } from 'node:child_process';
29
+ import { chmodSync, mkdtempSync, renameSync, rmSync, writeFileSync } from 'node:fs';
30
+ import { tmpdir } from 'node:os';
31
+ import { join } from 'node:path';
32
+ /**
33
+ * 当前平台是否支持 POSIX 文件权限位(Windows 不支持)。
34
+ *
35
+ * 注意这是**平台能力**而非"平台名":判断放在这里而不是散落 `process.platform === 'win32'`,
36
+ * 是为了让生产侧与测试侧用同一个口径。
37
+ */
38
+ export const POSIX_FILE_MODE = process.platform !== 'win32';
39
+ /** `icacls` 收紧要授予的主体(授权目标)。 */
40
+ let cachedPrincipal;
41
+ /**
42
+ * 取当前进程令牌的 SID 作为授权主体。
43
+ *
44
+ * 为什么不用 `USERDOMAIN\USERNAME`:那两个环境变量不是身份权威,且可被父进程污染。
45
+ * 真实失败面包括——服务/计划任务下常缺失;Azure AD 加入的机器上 `USERDOMAIN` 是计算机名,
46
+ * `MACHINE\user` 无法解析(icacls 报 status 1332);同名/改名账户可能解析到他人主体
47
+ * (不报错,但把秘密授权给了错误账户)。SID 与本机域/工作组/AAD/系统语言全部解耦。
48
+ *
49
+ * `whoami` 必须用绝对路径:Windows 上常见 Git Bash 的 coreutils `whoami` 排在 WINPATH 前面,
50
+ * 它不认识 `/user /fo csv`(实测报 `extra operand '/user'`)。
51
+ *
52
+ * @returns 可交给 icacls 的主体;无法确定时返回 null(由调用方决定降级策略)
53
+ */
54
+ function currentOwnerPrincipal() {
55
+ // 进程内缓存:一个进程的令牌主体不会变,而每次 restrictToOwner 起一个 whoami.exe
56
+ // 是纯浪费(credentials 打开一次最多 4 次调用)。
57
+ if (cachedPrincipal !== undefined)
58
+ return cachedPrincipal;
59
+ cachedPrincipal = resolveOwnerPrincipal();
60
+ return cachedPrincipal;
61
+ }
62
+ /**
63
+ * 解析当前令牌主体(不做缓存)。
64
+ *
65
+ * @returns 可交给 icacls 的主体;无法确定时返回 null(由调用方决定降级策略)
66
+ */
67
+ function resolveOwnerPrincipal() {
68
+ const whoami = join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'whoami.exe');
69
+ try {
70
+ const raw = execFileSync(whoami, ['/user', '/fo', 'csv', '/nh'], {
71
+ encoding: 'utf8',
72
+ windowsHide: true,
73
+ });
74
+ // 形如 `"machine\user","S-1-5-21-..."`
75
+ const sid = raw.trim().replace(/^"|"$/g, '').split('","').pop();
76
+ if (sid && /^S-\d+(-\d+)+$/.test(sid))
77
+ return { form: 'sid', value: sid };
78
+ }
79
+ catch {
80
+ /* whoami 不可用:退到名字形式,仍由 icacls 的 exit code 兜底判定成败 */
81
+ }
82
+ const username = process.env.USERNAME ?? '';
83
+ const domain = process.env.USERDOMAIN ?? '';
84
+ if (!username)
85
+ return null;
86
+ // 名字形式只作兜底:工作组下 USERDOMAIN 是机器名,域下是域名,两种都能解析
87
+ return { form: 'name', value: domain ? `${domain}\\${username}` : username };
88
+ }
89
+ /**
90
+ * 把目标收紧到「仅当前用户可访问」。
91
+ *
92
+ * @param target - 文件或目录路径
93
+ * @param kind - `dir` 用继承形式授权(`(OI)(CI)`),使其中新建的文件自动安全
94
+ * @throws 当无法收紧时抛出(调用方不得把它当作可忽略的告警)
95
+ */
96
+ export function restrictToOwner(target, kind) {
97
+ if (POSIX_FILE_MODE) {
98
+ chmodSync(target, kind === 'dir' ? 0o700 : 0o600);
99
+ return;
100
+ }
101
+ const owner = currentOwnerPrincipal();
102
+ if (!owner) {
103
+ throw new Error(`[permissions] cannot restrict ${target}: could not determine the current user (whoami unavailable and USERNAME unset)`);
104
+ }
105
+ // icacls 的输出是本地化的,只可信 exit code(非 0 时 execFileSync 会抛)。
106
+ // windowsHide 不可省:否则在无控制台的宿主里又会长出一个控制台窗口。
107
+ // `/inheritance:r /grant:r` 只处理**继承**来的 ACE 与"同一主体"的显式 ACE:目标上若有
108
+ // 别人显式授予的条目(老版本留下的宽松权限正是如此),它会原地留着。实测对
109
+ // `icacls <dir> /grant *S-1-5-32-545:(OI)(CI)R` 造宽过的目录,直接用本函数收紧后
110
+ // `BUILTIN\Users` 仍留在 DACL 上;先 `/reset`(重置为从父继承)再收紧才彻底。
111
+ try {
112
+ execFileSync('icacls', [target, '/reset'], { stdio: 'ignore', windowsHide: true });
113
+ }
114
+ catch {
115
+ /* 无法 reset(非 NTFS / 权限不足)时仍尝试下面的收紧;成败由它决定 */
116
+ }
117
+ // `*S-1-5-…` 是「按 SID 授权」的形式(icacls 语法);名字形式不能带 `*`。
118
+ const grantee = owner.form === 'sid' ? `*${owner.value}` : owner.value;
119
+ execFileSync('icacls', [
120
+ target,
121
+ '/inheritance:r',
122
+ '/grant:r',
123
+ kind === 'dir' ? `${grantee}:(OI)(CI)F` : `${grantee}:F`,
124
+ ], { stdio: 'ignore', windowsHide: true });
125
+ }
126
+ /**
127
+ * 创建仅当前用户可访问的临时目录。
128
+ *
129
+ * 秘密文件应放这里而非直接平铺在共享 tmpdir:目录收紧后,其中新建文件自动继承安全
130
+ * ACL,等于在创建时就消除了暴露窗口。
131
+ *
132
+ * @param prefix - 目录名前缀(便于诊断)
133
+ * @returns 私有临时目录的绝对路径
134
+ */
135
+ export function createPrivateTempDir(prefix) {
136
+ const dir = mkdtempSync(join(tmpdir(), prefix));
137
+ try {
138
+ restrictToOwner(dir, 'dir');
139
+ }
140
+ catch (err) {
141
+ // 建得出却收紧不了:该目录不能用来放秘密,清掉再抛(不留隐患目录)
142
+ try {
143
+ rmSync(dir, { recursive: true, force: true });
144
+ }
145
+ catch {
146
+ /* 清理失败是次要问题:主错误(无法收紧)才是调用方要看到的 */
147
+ }
148
+ throw err;
149
+ }
150
+ return dir;
151
+ }
152
+ /**
153
+ * 同步写入秘密文件,并把权限真实收紧到仅当前用户。
154
+ *
155
+ * 与 `writeFileSync(..., {mode: 0o600})` 的区别:后者在 Windows 上不生效。
156
+ *
157
+ * 三步走(写 tmp → 收紧 tmp → rename)而不是直接写目标:目标可能已存在且是**有效**的
158
+ * 旧秘密(例如上一轮签发的 setup token)。直接写再收紧的话,一旦收紧失败就得删文件,
159
+ * 等于把旧秘密一起毁掉。这个顺序同时消除了「写完成 → 收紧完成」之间的暴露窗口;
160
+ * 同卷 rename 不会重新继承 ACL(实测 Windows 上收紧后的 ACL 完整保留)。
161
+ *
162
+ * @param filePath - 目标路径(父目录应当已经是私有的,见 {@link createPrivateTempDir})
163
+ * @param data - 文件内容
164
+ * @throws 当权限无法收紧时(此时目标文件保持原状,临时文件已删除)
165
+ */
166
+ export function writeSecretFileSync(filePath, data) {
167
+ const staging = `${filePath}.staging`;
168
+ writeFileSync(staging, data, { encoding: 'utf8', mode: 0o600 });
169
+ try {
170
+ restrictToOwner(staging, 'file');
171
+ }
172
+ catch (err) {
173
+ try {
174
+ rmSync(staging, { force: true });
175
+ }
176
+ catch {
177
+ /* 删不掉时仍要抛出收紧失败:调用方至少知道有一份未收紧的副本存在 */
178
+ }
179
+ throw err;
180
+ }
181
+ renameSync(staging, filePath);
182
+ }
@@ -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>;