@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.d.ts CHANGED
@@ -5,6 +5,7 @@
5
5
  import type { ToolPolicy } from '@octopi-agent/core/types.js';
6
6
  import type { ModelConfig as _ModelConfig } from './harness/shared/types/agent-definition.js';
7
7
  import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
8
+ import type { BrowserStealthConfig } from './harness/extension/plugin-ecosystem/tools/browser-types.js';
8
9
  import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
9
10
  /** 产品默认上下文窗口(与 core/types/model-info 一致,未声明能力时按此预算) */
10
11
  export { DEFAULT_CONTEXT_WINDOW };
@@ -72,7 +73,7 @@ export interface AgentConfig {
72
73
  rightsCeiling?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionRights;
73
74
  /** 委派预算上限(请求预算与此取交集) */
74
75
  budget?: {
75
- maxTurns?: number;
76
+ maxSteps?: number;
76
77
  maxTokens?: number;
77
78
  timeoutMs?: number;
78
79
  };
@@ -88,6 +89,10 @@ export interface AgentConfig {
88
89
  export type KnowledgeRecallMode = 'off' | 'hint' | 'hybrid' | 'inject';
89
90
  /** Knowledge 全局配置(agents[].knowledge 覆盖 recall 等) */
90
91
  export interface KnowledgeRuntimeConfig {
92
+ /** 跨租户共享闸(B-5):allowPublic 缺省 false=禁止创建 visibility='public' 项目 */
93
+ projects?: {
94
+ allowPublic?: boolean;
95
+ };
91
96
  /** Knowledge Service 连接(v2:Gateway 不打开 knowledge.db);对齐 KnowledgeConfigSchema */
92
97
  service?: {
93
98
  baseUrl?: string;
@@ -125,20 +130,18 @@ export interface KnowledgeRuntimeConfig {
125
130
  includePriorUserTurns?: number;
126
131
  skipIfUserTokensBelow?: number;
127
132
  };
128
- index?: {
129
- embedding?: boolean;
130
- hybridKeyword?: boolean;
133
+ /** Phase B 向量化(v0.98.11 起取代 index.phaseB / index.embedding / index.embedSecretPolicy) */
134
+ embed?: {
135
+ /** false = 纯关键词索引(不外发 embed);缺省 true */
136
+ enabled?: boolean;
137
+ embedBatch?: number;
138
+ embedMinIntervalMs?: number;
139
+ embedConcurrency?: number;
131
140
  /** embedding 外发前敏感形态策略(默认 redact) */
132
141
  embedSecretPolicy?: 'allow' | 'redact' | 'skip';
133
- phaseA?: {
134
- concurrency?: number;
135
- debounceMs?: number;
136
- };
137
- phaseB?: {
138
- embedBatch?: number;
139
- concurrency?: number;
140
- ratePerMin?: number;
141
- };
142
+ };
143
+ index?: {
144
+ hybridKeyword?: boolean;
142
145
  queue?: {
143
146
  maxDepth?: number;
144
147
  };
@@ -172,6 +175,8 @@ export interface KnowledgeRuntimeConfig {
172
175
  };
173
176
  load?: {
174
177
  parseConcurrency?: number;
178
+ /** fs watch debounce ms(默认 800;原 index.phaseA.debounceMs) */
179
+ debounceMs?: number;
175
180
  diskWatermarkAlert?: boolean;
176
181
  };
177
182
  promotion?: {
@@ -187,22 +192,13 @@ export interface KnowledgeRuntimeConfig {
187
192
  maxFileBytes?: number;
188
193
  maxTotalBytes?: number;
189
194
  allowedExtensions?: string[];
190
- parse?: {
191
- extract?: boolean;
192
- keywordIndex?: boolean;
193
- embedding?: 'off' | 'lazy' | 'on-upload';
194
- };
195
195
  inject?: {
196
196
  fullTextMaxChars?: number;
197
197
  recallTopK?: number;
198
- inventory?: boolean;
199
198
  intent?: 'llm' | 'off';
200
199
  intentTimeoutMs?: number;
201
200
  emptyMessagePrompt?: string;
202
201
  };
203
- tools?: {
204
- attachmentsRootReadOnly?: boolean;
205
- };
206
202
  };
207
203
  }
208
204
  /** 单个 web search provider slot */
@@ -241,12 +237,59 @@ export interface WebSearchToolConfig {
241
237
  /** provider 映射 */
242
238
  providers?: Record<string, WebSearchProviderSlot>;
243
239
  }
240
+ /** browser_* 工具顶层配置(arch/browser-capability.md §3.8) */
241
+ export interface BrowserToolConfig {
242
+ /** 工具面注册开关(缺省 true = 拍板默认开) */
243
+ enabled?: boolean;
244
+ /** 后端引擎(auto = playwright;stealth = 隐身链;rebrowser / camoufox = 单后端直钉) */
245
+ engine?: 'auto' | 'playwright' | 'stealth' | 'rebrowser' | 'camoufox' | 'cdp-attach' | 'cloud';
246
+ /** attach 端点(engine=cdp-attach 用;缺省 http://127.0.0.1:9222) */
247
+ attach?: {
248
+ endpoint?: string;
249
+ };
250
+ /** 持久 profile(P2;storageState 归档于 OCTOPI_HOME/browser-profiles) */
251
+ profiles?: {
252
+ persist?: boolean;
253
+ defaultProfile?: string;
254
+ };
255
+ /** 浏览器来源:chromium(管理版)| chrome(系统 Chrome) */
256
+ channel?: 'chromium' | 'chrome';
257
+ headless?: boolean;
258
+ /** 工具/动作超时(毫秒,默认 30000) */
259
+ timeoutMs?: number;
260
+ /** 快照序列化预算(字符,默认 8000) */
261
+ snapshotMaxChars?: number;
262
+ /** 会话空闲回收(毫秒;<=0 不回收;缺省 1800000 = 30 分钟) */
263
+ sessionIdleTimeoutMs?: number;
264
+ viewport?: {
265
+ width: number;
266
+ height: number;
267
+ };
268
+ locale?: string;
269
+ network?: {
270
+ /** 域名 allow/deny(deny 优先;`*.suffix` 通配;缺省无限制) */
271
+ domains?: {
272
+ allow?: string[];
273
+ deny?: string[];
274
+ };
275
+ /** 私网/环回放行(缺省 false) */
276
+ allowPrivateNetwork?: boolean;
277
+ };
278
+ /** stealth(P3):fallback 链由服务层消费;humanize 透传工具层 */
279
+ stealth?: BrowserStealthConfig;
280
+ /**
281
+ * 敏感动作确认闸门三档(2026-11-20 拍板):
282
+ * `strict` = 所有非 GET 过闸(含页内 fetch/XHR);`standard`(缺省)= 仅文档级
283
+ * (表单提交/密码/上传);`off` = 全放开。
284
+ */
285
+ confirm?: 'strict' | 'standard' | 'off';
286
+ }
244
287
  /**
245
288
  * Session 配置(合并了旧的 store + session 节点)
246
289
  */
247
290
  export interface SessionConfig {
248
- /** DM 作用域: main / per-peer / per-channel-peer */
249
- dmScope?: 'main' | 'per-peer' | 'per-channel-peer';
291
+ /** DM 作用域: main / per-peer / per-channel-peer / per-conversation */
292
+ dmScope?: 'main' | 'per-peer' | 'per-channel-peer' | 'per-conversation';
250
293
  /**
251
294
  * 上下文租约(毫秒)。**显式配置才生效**;缺省关闭。
252
295
  *
@@ -255,14 +298,28 @@ export interface SessionConfig {
255
298
  */
256
299
  idleExpiryMs?: number;
257
300
  }
301
+ /**
302
+ * Tenancy 配置 — 多租户渠道锚定策略(arch/multi-tenancy.md §9)
303
+ */
304
+ export interface TenancyConfig {
305
+ /** 未绑定流量兜底:`fallback`(默认,存量首 agent)| `reject`(拒收,日志明示) */
306
+ unboundChannelPolicy?: 'fallback' | 'reject';
307
+ }
258
308
  /**
259
309
  * Plugin 配置
260
310
  */
261
311
  export interface PluginConfig {
262
312
  /** Plugin 目录扫描路径 */
263
313
  loadPaths?: string[];
264
- /** 单个 plugin 的配置(plugin id → config) */
265
- configs?: Record<string, Record<string, unknown>>;
314
+ /** 宿主允许的插件 ID;未配置 = 不限制 */
315
+ allowList?: string[];
316
+ /** 宿主明确阻止的插件 ID,优先于其他启用决策 */
317
+ blockList?: string[];
318
+ /** 插件启停与业务配置;单纯存在 config 不代表启用 */
319
+ entries?: Record<string, {
320
+ enabled?: boolean;
321
+ config?: Record<string, unknown>;
322
+ }>;
266
323
  }
267
324
  /**
268
325
  * 监听 host 配置值
@@ -272,6 +329,13 @@ export interface PluginConfig {
272
329
  * - 具体 IP / 主机名:绑定该地址
273
330
  */
274
331
  export type NetworkHostConfig = 'local' | 'lan' | (string & {});
332
+ /**
333
+ * 判定 listen 地址是否仅回环可达(B-1:无钥告警分级依据——非回环 = 网络敞开)
334
+ *
335
+ * @param host - `resolveListenHost` 解析后的 listen 地址
336
+ * @returns 是否回环(127/8 · ::1 · localhost)
337
+ */
338
+ export declare function isLoopbackListenHost(host: string): boolean;
275
339
  /**
276
340
  * 将 host 配置解析为 HTTP listen 地址
277
341
  *
@@ -297,8 +361,10 @@ export declare function isLanHost(host?: NetworkHostConfig): boolean;
297
361
  * Channel 配置
298
362
  */
299
363
  export interface ChannelConfig {
300
- /** 类型(http) */
301
- type: string;
364
+ /** 内置通道类型(http);与 plugin 二选一(恰好其一) */
365
+ type?: string;
366
+ /** 插件 Channel 贡献 id(manifest contributes.channels);与 type 二选一 */
367
+ plugin?: string;
302
368
  /** 端口(HTTP channel 用) */
303
369
  port?: number;
304
370
  /**
@@ -309,17 +375,24 @@ export interface ChannelConfig {
309
375
  host?: NetworkHostConfig;
310
376
  /** 路径(HTTP channel 用) */
311
377
  path?: string;
312
- /** API Key(HTTP channel 认证) */
378
+ /** API Key(HTTP channel 认证;插件通道的凭证通道,推荐 `${ENV_VAR}` 引用) */
313
379
  apiKey?: string;
380
+ /**
381
+ * bot 凭证归属租户(arch/multi-tenancy.md §9 Q11=a 渠道锚定):
382
+ * 消息进入先按此定租户,再查 bindings 表路由。缺省 = DEFAULT_TENANT_ID(存量域)。
383
+ */
384
+ tenantId?: string;
314
385
  /** 允许的 CORS 源 */
315
386
  corsOrigins?: string[];
387
+ /** 插件自定义旋钮(非密钥;原样透传) */
388
+ options?: Record<string, unknown>;
316
389
  }
317
390
  /**
318
391
  * BudgetPolicyJsonConfig — octopi.json 中的 budgetPolicy 字段
319
392
  *
320
393
  * 见 arch/budget-redesign.md:
321
394
  * - 默认 **无** nominal token hard(Σ nominalTotalTokens 不作为出厂熔断)
322
- * - P0:仅 wall-clock 安全阀 + 可显式 iteration/tool 上限
395
+ * - P0:仅 wall-clock 安全阀 + 可显式 steps/tool 上限
323
396
  * - P2:控制梯配置(wrap-up 策略)
324
397
  * - P3:扩展 usd / uncached 等 opt-in 单位;键名仅 budgetPolicy(无 budget)
325
398
  */
@@ -327,13 +400,13 @@ export interface BudgetPolicyJsonConfig {
327
400
  /** 安全阀:最大运行时间毫秒(默认 6h) */
328
401
  maxWallClockMs?: number;
329
402
  /** 最大迭代次数。仅显式设置时硬停 */
330
- maxIterations?: number;
403
+ maxSteps?: number;
331
404
  /** 最大工具调用次数。仅显式设置时硬停 */
332
405
  maxToolCalls?: number;
333
406
  /** Policy 触达时的行为:'stop' 立即停止 | 'wrap_up_then_stop' 先总结再停止(默认) */
334
407
  onPolicyHit?: 'stop' | 'wrap_up_then_stop';
335
408
  /** wrap-up 窗口的轮次数(默认 3) */
336
- wrapUpTurns?: number;
409
+ wrapUpSteps?: number;
337
410
  /** context 轴 wrap-up 触发阈值比例(默认 0.85) */
338
411
  contextWrapUpRatio?: number;
339
412
  /** 预算单位配置(仅显式配置才启用 hard) */
@@ -461,6 +534,13 @@ export interface ContextEngineConfig {
461
534
  protectFirstN?: number;
462
535
  /** 尾部保护消息数(默认 20) */
463
536
  protectLastN?: number;
537
+ /**
538
+ * turn 内活跃窗口条数(默认 50):工具活动进行中(isMidTurn)时主动压缩选段的
539
+ * tail 扩大到 max(protectLastN, 本值),进行中的工具步骤/证据/推理链不进选段。
540
+ * 2026-11-07 方案 E 修订:取代「turn 内禁 LLM 摘要」。条数上限,token 密集的
541
+ * 短 turn 仍有已知限制(见 CHANGELOG v0.102.2 已接受风险)。
542
+ */
543
+ midTurnProtectLastN?: number;
464
544
  /** 摘要软目标预算(P1c 缺省 clamp(2%, 2k, 8k)):可配置 ratioPct/minTokens/maxTokens */
465
545
  summaryBudget?: {
466
546
  ratioPct?: number;
@@ -471,7 +551,8 @@ export interface ContextEngineConfig {
471
551
  * 窗口比例线:消息 token / messagesBudget 超过该比例时,
472
552
  * 在硬溢出前先主动压缩(默认 0.6)。
473
553
  * `0` = **禁止发起新的**路径 A 压缩(不只禁 LLM;目标线/窗口比例线同闸);**不**丢弃已有
474
- * `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)本就不打 LLM。
554
+ * `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)同样打 LLM
555
+ * (2026-11-07 方案 E 修订),活动记录由 `midTurnProtectLastN` 活跃窗口保护。
475
556
  */
476
557
  proactiveCompactRatio?: number;
477
558
  /**
@@ -479,6 +560,12 @@ export interface ContextEngineConfig {
479
560
  * 冷却期内优先缓存重建,降低单 turn 双摘要。
480
561
  */
481
562
  proactiveCooldownMs?: number;
563
+ /**
564
+ * 单次摘要 LLM 调用预算 ms(默认 300000;0 = 不设预算,只受 provider 超时约束)。
565
+ * 超时即中止摘要请求并按 onSummarizeFail 降级——防止 provider 挂死时 UI 全程假等。
566
+ * 中断不续做:下一轮重新发起压缩即可。
567
+ */
568
+ summarizeTimeoutMs?: number;
482
569
  /**
483
570
  * 历史工具结果批量冻结老化(F1-B2):当前 run 永不老化、近 rawWindow 条跨轮原文、
484
571
  * 更旧按 freezeBatch 成批降级为结构化指针(视图级、write-once、禁渐进)。
@@ -513,10 +600,6 @@ export interface ContextEngineConfig {
513
600
  minOutputReserve?: number;
514
601
  /** 输出预留最大值(默认 8000) */
515
602
  maxOutputReserve?: number;
516
- /** 是否启用 LLM 摘要(默认 true) */
517
- enableLLMSummary?: boolean;
518
- /** 摘要模型(可选,使用主模型) */
519
- summaryModel?: string;
520
603
  }
521
604
  /**
522
605
  * 公用能力 summary 配置(harness/context/capabilities)
@@ -543,21 +626,10 @@ export interface SummaryCapabilityConfig {
543
626
  } & Record<string, unknown>;
544
627
  cache?: {
545
628
  enabled?: boolean;
546
- backend?: 'memory' | 'file';
547
629
  ttlMs?: number;
548
630
  maxEntries?: number;
549
- dir?: string;
550
631
  };
551
632
  }
552
- /**
553
- * 公用能力 compact 缺省配置
554
- */
555
- export interface CompactCapabilityConfig {
556
- defaultProtectHead?: number;
557
- defaultProtectTail?: number;
558
- defaultTargetTokens?: number;
559
- defaultMode?: 'structure_only' | 'summary_only' | 'head_tail_only' | 'auto';
560
- }
561
633
  /**
562
634
  * 公用能力 documents(DocumentPort 读抽取)
563
635
  */
@@ -577,19 +649,6 @@ export interface DocumentsCapabilityConfig {
577
649
  timeoutMs?: number;
578
650
  maxInputBytes?: number;
579
651
  };
580
- markitdown?: {
581
- enabled?: boolean;
582
- command?: string;
583
- };
584
- enhanced?: {
585
- enabled?: boolean;
586
- provider?: 'mineru' | 'azure-di' | 'azure-cu' | string;
587
- endpoint?: string | null;
588
- command?: string | null;
589
- authRef?: string | null;
590
- timeoutMs?: number;
591
- preferOn?: string[];
592
- };
593
652
  }
594
653
  /**
595
654
  * system prompt 层装配器配置(七层 ContextAssembler)
@@ -649,8 +708,6 @@ export interface ModelDefinition {
649
708
  provider: string;
650
709
  /** 模型名称 */
651
710
  model: string;
652
- /** 温度 */
653
- temperature?: number;
654
711
  /** 最大 token 数 */
655
712
  maxTokens?: number;
656
713
  /** 上下文窗口大小 */
@@ -693,12 +750,19 @@ export interface ModelProviderConfig {
693
750
  baseUrl: string;
694
751
  /** API Key(支持 ${ENV_VAR} 语法);省略/空 = 不发鉴权(keyless) */
695
752
  apiKey?: string;
696
- /** API 协议类型 */
697
- api: 'openai-completions' | 'anthropic-messages';
753
+ /** API 协议类型;与 plugin 二选一(恰好设置其一) */
754
+ api?: 'openai-completions' | 'anthropic-messages';
755
+ /** 插件 Provider 贡献 id(manifest contributes.providers);与 api 二选一 */
756
+ plugin?: string;
698
757
  /** 此 provider 下的模型列表 */
699
758
  models: ModelCapability[];
700
759
  /** 请求超时(秒) */
701
760
  timeoutSeconds?: number;
761
+ /**
762
+ * 插件自定义旋钮(按 contributes.providers 契约由插件自行校验)。
763
+ * 仅放非密钥配置;密钥只走 apiKey(credential 通道),出现在此处视为配置错误。
764
+ */
765
+ options?: Record<string, unknown>;
702
766
  }
703
767
  /** 模型级别定义(primary + fallback 降级链) */
704
768
  export interface LevelConfig {
@@ -767,8 +831,6 @@ export interface EmbeddingModelConfig {
767
831
  }
768
832
  /** 新格式的 models 配置 */
769
833
  export interface ModelsConfig {
770
- /** 合并模式:merge=与 builtin 合并,replace=完全替代 */
771
- mode?: 'merge' | 'replace';
772
834
  /** Provider 映射(key = provider 名称) */
773
835
  providers: Record<string, ModelProviderConfig>;
774
836
  /** 模型级别映射(子系统通过级别名引用具体模型) */
@@ -824,6 +886,10 @@ export interface HarnessConfig {
824
886
  plugins?: PluginConfig;
825
887
  /** Run 安全阀 / 策略(budgetPolicy;无默认 token hard) */
826
888
  budgetPolicy?: BudgetPolicyJsonConfig;
889
+ /** fleet 期望状态播种(P0c Q3=A;arch/service-topology-p0c.md §4.1) */
890
+ fleet?: {
891
+ replicasPerVersion?: number;
892
+ };
827
893
  /** 过程监督配置(行为监督;与 budget 组合) */
828
894
  runGuard?: RunGuardJsonConfig;
829
895
  /** 模型调用 watchdog 超时(modelCall 段) */
@@ -836,19 +902,13 @@ export interface HarnessConfig {
836
902
  contextEngine?: ContextEngineConfig;
837
903
  /** 公用能力 summary(harness/context/capabilities) */
838
904
  summary?: SummaryCapabilityConfig;
839
- /** 公用能力 compact 缺省 */
840
- compact?: CompactCapabilityConfig;
841
905
  /** 公用能力 documents(DocumentPort 读抽取) */
842
906
  documents?: DocumentsCapabilityConfig;
843
- /** system prompt 七层装配器配置 */
844
- contextAssembler?: ContextAssemblerConfig;
845
- /** context 域扩展:全局宪法等 */
907
+ /** system prompt 七层装配器 / 全局宪法(唯一声明面:context 域;v0.98.11 起顶层简写已删除) */
846
908
  context?: {
847
909
  constitution?: ConstitutionConfig;
848
910
  contextAssembler?: ContextAssemblerConfig;
849
911
  };
850
- /** 全局宪法(顶层简写,等价 context.constitution) */
851
- constitution?: ConstitutionConfig;
852
912
  /** Memory 写入/置信度策略 */
853
913
  memory?: {
854
914
  profile?: 'personal_assistant' | 'embedded_interactive' | 'embedded_headless';
@@ -895,76 +955,36 @@ export interface HarnessConfig {
895
955
  maxLength?: Partial<Record<'fact' | 'method' | 'norm', number>>;
896
956
  };
897
957
  };
898
- /** Cognition 概念图谱(arch/cognition-graph-formation.md) */
958
+ /** Cognition 概念图谱(arch/cognition-graph-formation.md);steward 调参面在子系统 config.yaml metadata.config */
899
959
  cognition?: {
900
960
  enabled?: boolean;
901
- conceptualize?: {
902
- onMemoryWrite?: boolean;
903
- maxNodesPerProposition?: number;
904
- maxEdgesPerProposition?: number;
905
- };
906
961
  relations?: {
907
- requireCue?: boolean;
908
962
  causesMinIndependentMemories?: number;
909
963
  };
910
964
  identity?: {
911
965
  mergeThreshold?: number;
912
966
  candidateBandHi?: number;
967
+ semanticSeedMaxDistance?: number;
968
+ semanticSeedEmbedTimeoutMs?: number;
913
969
  };
914
970
  capacity?: {
915
- warnNodes?: number;
916
- warnEdges?: number;
917
971
  stopNodes?: number;
918
972
  stopEdges?: number;
919
973
  };
920
- retrieval?: {
921
- depth?: number;
922
- delta?: number;
923
- tau?: number;
924
- limit?: number;
925
- };
926
- consolidation?: {
927
- debounceMinutes?: number;
928
- ttlHours?: number;
929
- };
930
974
  };
931
- /** Wisdom 判断范式(arch/wisdom-layer-formation.md) */
975
+ /** Wisdom 判断范式(arch/wisdom-layer-formation.md);steward 调参面在子系统 config.yaml metadata.config */
932
976
  wisdom?: {
933
977
  enabled?: boolean;
934
978
  capacity?: {
935
- softCap?: number;
936
979
  hardCap?: number;
937
980
  };
938
- formation?: {
939
- enabled?: boolean;
940
- dryRun?: boolean;
941
- ttlHours?: number;
942
- minMemorySupport?: number;
943
- minClusterSize?: number;
944
- minPromotionStack?: number;
945
- maxItemsPerRun?: number;
946
- maxEvidenceChars?: number;
947
- };
948
- evaluation?: {
949
- dryRun?: boolean;
950
- windowHours?: number;
951
- minAppliesForActive?: number;
952
- contestRate?: number;
953
- counterevidenceWeight?: number;
954
- strengthenMinApplies?: number;
955
- };
956
981
  injection?: {
957
982
  coreMaxItems?: number;
958
- coreMaxTokens?: number;
959
983
  scenarioMaxItems?: number;
984
+ /** trial 轮转试用名额(缺省 2;0 = 关闭轮转) */
985
+ trialMaxItems?: number;
960
986
  trialVisible?: boolean;
961
987
  };
962
- govern?: {
963
- dryRun?: boolean;
964
- zeroApplyIdleMs?: number;
965
- priorityDecayStep?: number;
966
- priorityFloor?: number;
967
- };
968
988
  };
969
989
  /** Knowledge 检索/召回(全局缺省;agents[].knowledge.recall 可覆盖) */
970
990
  knowledge?: KnowledgeRuntimeConfig;
@@ -1004,6 +1024,8 @@ export interface HarnessConfig {
1004
1024
  channels?: ChannelConfig[];
1005
1025
  /** Session 配置 */
1006
1026
  session?: SessionConfig;
1027
+ /** 多租户渠道锚定策略(arch/multi-tenancy.md §9) */
1028
+ tenancy?: TenancyConfig;
1007
1029
  /**
1008
1030
  * 工具效应隔离策略(宪法 I5)
1009
1031
  *
@@ -1073,6 +1095,8 @@ export interface HarnessConfig {
1073
1095
  };
1074
1096
  /** 网络搜索配置(web_search 工具) */
1075
1097
  webSearch?: WebSearchToolConfig;
1098
+ /** 浏览器操作配置(browser_* 工具;缺省默认开) */
1099
+ browser?: BrowserToolConfig;
1076
1100
  /** Web UI 运行配置 */
1077
1101
  web?: {
1078
1102
  /** Web UI 源码目录(含 package.json);未设置时按 CLI 内置顺序探测 */
@@ -1160,17 +1184,31 @@ export declare function createWireDumpSinkFromConfig(cfg?: import('./integration
1160
1184
  /**
1161
1185
  * 从 ModelProviderConfig 创建 ModelProvider 实例
1162
1186
  *
1163
- * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
1164
- * 使用动态 import 以支持 ESM。
1187
+ * `api` 选择内置适配器(OpenAI / Anthropic);`plugin` 路由到插件 Provider 工厂。
1188
+ * 两者恰好设置其一。使用动态 import 以支持 ESM。
1165
1189
  *
1166
1190
  * @param name - provider 名称
1167
1191
  * @param pc - provider 配置
1168
- * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
1192
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`);
1193
+ * `resolvePluginProvider` 解析插件 Provider 工厂(`pc.plugin` 必需)
1169
1194
  * @returns provider 实例(wire dump → 原生 provider 的装饰链;LLM 计时已 observability 化进 model.call.*)
1170
1195
  */
1171
1196
  export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig, options?: {
1172
1197
  wireDump?: import('./integration/providers/wire-dump.js').WireDumpSink;
1198
+ resolvePluginProvider?: (ref: string) => import('./harness/extension/plugin-ecosystem/plugins/contribution-registry.js').PluginProviderRecord | undefined;
1173
1199
  }): Promise<ModelProvider>;
1200
+ /**
1201
+ * 从 `channels[]` 配置条目创建插件 Channel Adapter。
1202
+ *
1203
+ * `plugin` 路由到插件 Channel 工厂(`contributes.channels` 命名贡献);
1204
+ * 内置 `type: 'http'` 由 daemon 的 HttpChannelAdapter 装配,不走本函数。
1205
+ * 与 `createProviderFromConfig` 同闸:type | plugin 恰好其一,工厂是第二道闸。
1206
+ *
1207
+ * @param entry - channels[] 配置条目
1208
+ * @param resolvePluginChannel - 解析插件 Channel 工厂(`entry.plugin` 必需)
1209
+ * @returns ChannelAdapter 实例(最小契约校验,name 硬绑定贡献 id)
1210
+ */
1211
+ export declare function createChannelAdapterFromConfig(entry: ChannelConfig, resolvePluginChannel: (ref: string) => import('./harness/extension/plugin-ecosystem/plugins/contribution-registry.js').PluginChannelRecord | undefined): Promise<import('./harness/extension/plugin-ecosystem/channel-types.js').ChannelAdapter>;
1174
1212
  /**
1175
1213
  * 按 `observability` 配置构造 RunTelemetry 工厂(F3/D5 接线,组合根)
1176
1214
  *