@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
@@ -0,0 +1,270 @@
1
+ /**
2
+ * Onboarding 向导核心 — 单源状态机 / 双语文案表 / 配置组装(纯逻辑无 IO)。
3
+ *
4
+ * CLI 与 Web 向导共享本模块(product-onboarding.md §1):渲染器只做呈现,
5
+ * 步骤序、校验、落盘内容都在这里。生成器语义:产出与手写 octopi.json 同构。
6
+ *
7
+ * @module
8
+ */
9
+ import { expandProviderPreset, getProviderPreset, listProviderPresets } from './model-presets.js';
10
+ import { pickLocalized } from './i18n.js';
11
+ /** 步骤序(`init-mode` 仅在 Web 向导可用时呈现——CLI 先行期只有命令行一条道) */
12
+ export const ONBOARDING_STEPS = [
13
+ 'welcome',
14
+ 'init-mode',
15
+ 'deployment-mode',
16
+ 'provider',
17
+ 'api-key',
18
+ 'model',
19
+ 'probe',
20
+ 'services',
21
+ 'first-chat',
22
+ ];
23
+ /** 部署模式选项(顺序即展示序) */
24
+ export const DEPLOYMENT_MODES = [
25
+ {
26
+ id: 'personal',
27
+ labels: { zh: '个人使用', en: 'Personal' },
28
+ descriptions: {
29
+ zh: '单人使用这台机器上的助手,无需账号密码。',
30
+ en: 'Just you on this machine — no login required.',
31
+ },
32
+ },
33
+ {
34
+ id: 'organization',
35
+ labels: { zh: '单组织多用户', en: 'Organization' },
36
+ descriptions: {
37
+ zh: '一个组织(团队/公司)内多人使用。组织内可共享知识库、跨用户 agent 协同。',
38
+ en: 'One organization with multiple users. Shared knowledge base and cross-user agent collaboration inside the org.',
39
+ },
40
+ },
41
+ {
42
+ id: 'multi-organization',
43
+ labels: { zh: '多组织多租户', en: 'Multi-organization' },
44
+ descriptions: {
45
+ zh: '多个组织共用一套部署,相互隔离。组织内可共享知识库、跨用户 agent 协同。',
46
+ en: 'Multiple isolated organizations on one deployment. Shared knowledge and collaboration inside each org.',
47
+ },
48
+ },
49
+ ];
50
+ /**
51
+ * 取当前语言的双语文案(与 pickLocalized 同源,保留本名给向导渲染器)
52
+ *
53
+ * @param map - 双语映射
54
+ * @param fallback - 回落文案
55
+ * @param lang - 当前语言
56
+ * @returns 本地化文案
57
+ */
58
+ export function pickLang(map, fallback, lang) {
59
+ return pickLocalized(map, map[lang]?.trim() || fallback, lang);
60
+ }
61
+ /**
62
+ * 预设的 apiKey 环境变量名(.env 键 + `${VAR}` 占位同名)
63
+ *
64
+ * @param providerId - 预设 id
65
+ * @returns 环境变量名;无需 key 的预设(ollama 等)返回 ''
66
+ * @throws 未知 providerId(fail-loud)
67
+ */
68
+ export function apiKeyEnvVar(providerId) {
69
+ const preset = getProviderPreset(providerId);
70
+ if (!preset)
71
+ throw new Error(`unknown provider preset: ${providerId}`);
72
+ return preset.apiKeyEnvHint || '';
73
+ }
74
+ /**
75
+ * 校验一步的选择是否完整(渲染器在「下一步」前调用)
76
+ *
77
+ * @param step - 步骤 id
78
+ * @param choices - 当前选择
79
+ * @returns 错误文案(当前语言);'' 表示通过
80
+ */
81
+ export function validateStep(step, choices) {
82
+ const zh = choices.lang === 'zh';
83
+ switch (step) {
84
+ case 'welcome':
85
+ return choices.lang ? '' : zh ? '请选择语言' : 'Pick a language';
86
+ case 'init-mode':
87
+ return choices.initMode ? '' : zh ? '请选择初始化方式' : 'Pick an init mode';
88
+ case 'deployment-mode': {
89
+ const mode = choices.deploymentMode;
90
+ if (!mode)
91
+ return zh ? '请选择部署模式' : 'Pick a deployment mode';
92
+ // M-4:③模式组织名必填(此前 Web 端漏校验 → seedDeploymentRegistry 退化 'default' 租户)
93
+ if (mode === 'multi-organization' && !String(choices.orgName ?? '').trim()) {
94
+ return zh ? '请填写组织名称' : 'Enter an organization name';
95
+ }
96
+ return '';
97
+ }
98
+ case 'provider': {
99
+ if (!getProviderPreset(choices.providerId))
100
+ return zh ? '请选择一个模型服务' : 'Pick a model provider';
101
+ // custom(OpenAI 兼容)必须给 baseUrl(schema: min(1);空值产出非法配置)
102
+ if (choices.providerId === 'custom' && !String(choices.providerOverrides?.baseUrl ?? '').trim()) {
103
+ return zh ? '请填写服务的 Base URL(OpenAI 兼容接口地址)' : 'Enter the service base URL (OpenAI-compatible endpoint)';
104
+ }
105
+ return '';
106
+ }
107
+ case 'api-key': {
108
+ const envVar = apiKeyEnvVar(choices.providerId);
109
+ if (!envVar)
110
+ return ''; // 无需 key 的预设跳过
111
+ return choices.apiKey?.trim()
112
+ ? ''
113
+ : zh
114
+ ? '请粘贴 API Key(或返回上一步换无需 key 的本地模型)'
115
+ : 'Paste your API key (or go back and pick a keyless local model)';
116
+ }
117
+ case 'model':
118
+ return choices.modelId?.trim() ? '' : zh ? '请选择或填写模型名' : 'Pick or type a model id';
119
+ case 'probe':
120
+ case 'services':
121
+ case 'first-chat':
122
+ return ''; // 动作步无输入
123
+ }
124
+ }
125
+ /**
126
+ * 组装落盘内容(生成器语义:与手写 octopi.json 完全同构)
127
+ *
128
+ * @param choices - 完整选择(须先过 validateStep 全链)
129
+ * @returns 配置片段 + .env 行
130
+ * @throws provider 未知或 apiKey 缺失时抛错(fail-loud,不产半截配置)
131
+ */
132
+ export function assembleOnboarding(choices) {
133
+ const preset = getProviderPreset(choices.providerId);
134
+ if (!preset)
135
+ throw new Error(`unknown provider preset: ${choices.providerId}`);
136
+ const envVar = apiKeyEnvVar(choices.providerId);
137
+ if (envVar && !choices.apiKey?.trim()) {
138
+ // fail-loud,不产「KEY=」空值配置(运行时静默 401 比向导报错难查得多)
139
+ throw new Error(`missing api key for provider preset: ${choices.providerId}`);
140
+ }
141
+ const baseUrl = String(choices.providerOverrides?.baseUrl ?? '').trim();
142
+ if (choices.providerId === 'custom' && !baseUrl) {
143
+ throw new Error('missing baseUrl for custom provider');
144
+ }
145
+ const modelId = choices.modelId.trim();
146
+ const overrides = (choices.providerOverrides ?? {});
147
+ // 模型目录全量落配置(生成器语义):预设模型全进目录(参考参数随行),
148
+ // 用户「用哪个模型?」只接线 default agent 与 level 三档;手填清单外 id 追加进目录
149
+ const baseModels = Array.isArray(overrides.models) && overrides.models.length > 0 ? overrides.models : preset.models.map((m) => ({ ...m }));
150
+ const models = baseModels.some((m) => m?.id === modelId) ? [...baseModels] : [...baseModels, { id: modelId }];
151
+ const providerConfig = expandProviderPreset(choices.providerId, {
152
+ ...overrides,
153
+ ...(envVar ? { apiKey: `\${${envVar}}` } : {}),
154
+ models,
155
+ });
156
+ const modelRef = `${preset.id}/${modelId}`;
157
+ return {
158
+ configFragment: {
159
+ language: choices.lang,
160
+ deploymentMode: choices.deploymentMode,
161
+ providers: { [preset.id]: providerConfig },
162
+ // B3:档位与 default agent 全部接线到所选 provider/model(不然「第一句话」仍跑在 openai 写死档上)
163
+ levels: {
164
+ mini: { primary: modelRef },
165
+ standard: { primary: modelRef },
166
+ pro: { primary: modelRef },
167
+ },
168
+ agentModel: modelRef,
169
+ },
170
+ envLines: envVar ? [`${envVar}=${(choices.apiKey ?? '').trim()}`] : [],
171
+ };
172
+ }
173
+ /**
174
+ * 列出可选 provider 预设(渲染器用)
175
+ *
176
+ * @returns 预设清单(只读)
177
+ */
178
+ export function providerChoices() {
179
+ return listProviderPresets();
180
+ }
181
+ /**
182
+ * 步骤数据浅合并(白名单字段;Web/CLI 渲染器共用单源——M2)。
183
+ *
184
+ * @param base - 现有选择
185
+ * @param patch - 本步提交的部分字段(只认 OnboardingChoices 顶层键)
186
+ * @returns 合并后的新对象(不改入参)
187
+ */
188
+ const ONBOARDING_CHOICE_FIELDS = [
189
+ 'lang',
190
+ 'initMode',
191
+ 'deploymentMode',
192
+ 'orgName',
193
+ 'providerId',
194
+ 'providerOverrides',
195
+ 'adminPassword',
196
+ 'apiKey',
197
+ 'modelId',
198
+ ];
199
+ export function mergeOnboardingChoices(base, patch) {
200
+ const out = { ...base };
201
+ // MINOR-1:白名单合并(只认 OnboardingChoices 顶层字段;HTTP 层透传对象不能塞任意键)
202
+ for (const key of ONBOARDING_CHOICE_FIELDS) {
203
+ const v = patch[key];
204
+ if (v !== undefined)
205
+ out[key] = v;
206
+ }
207
+ return out;
208
+ }
209
+ /**
210
+ * 初始状态
211
+ *
212
+ * @param start - 起始步骤(默认 welcome)
213
+ * @returns 全新状态机状态
214
+ */
215
+ export function initialOnboardingState(start = 'welcome') {
216
+ return { current: start, stack: [], completed: false, aborted: false, exitSave: false };
217
+ }
218
+ /**
219
+ * 纯转移函数(M2 核心):无 IO、无渲染,Web/CLI 唯一步骤图真相。
220
+ *
221
+ * @param state - 当前状态
222
+ * @param event - 事件
223
+ * @returns 转移后状态 + commit 时机
224
+ */
225
+ export function nextStep(state, event) {
226
+ if (state.current === null)
227
+ return { state, commit: 'none' }; // 终态吸收
228
+ const idx = ONBOARDING_STEPS.indexOf(state.current);
229
+ switch (event.kind) {
230
+ case 'next': {
231
+ const nextIdx = idx + 1;
232
+ const done = nextIdx >= ONBOARDING_STEPS.length;
233
+ return {
234
+ state: {
235
+ ...state,
236
+ current: done ? null : ONBOARDING_STEPS[nextIdx],
237
+ stack: [...state.stack, state.current],
238
+ completed: done,
239
+ },
240
+ // B2:测通通过即落盘(services 动作读盘拿新配置);走完防御落盘(半截状态不组装)
241
+ commit: state.current === 'probe' ? 'after-probe' : done ? 'on-done' : 'none',
242
+ };
243
+ }
244
+ case 'back': {
245
+ const prev = state.stack[state.stack.length - 1];
246
+ if (prev === undefined)
247
+ return { state, commit: 'none', notice: 'back-at-first' }; // m13:空栈回退给提示,不静默绕圈
248
+ return { state: { ...state, current: prev, stack: state.stack.slice(0, -1) }, commit: 'none' };
249
+ }
250
+ case 'goto': {
251
+ // M1:探针失败动作面的精确落点(rekey→api-key / reprovider→provider);非法目标忽略(fail-safe 不坏状态)
252
+ if (!ONBOARDING_STEPS.includes(event.step)) {
253
+ return { state, commit: 'none' };
254
+ }
255
+ // 自身不压栈(否则重试循环把「上一步」变成原地踏步 + 栈无限增长)
256
+ const stack = event.step === state.current ? state.stack : [...state.stack, state.current];
257
+ return { state: { ...state, current: event.step, stack }, commit: 'none' };
258
+ }
259
+ case 'exit': {
260
+ // m5:save=true 落盘退出;save=false 半截状态不组装
261
+ return {
262
+ state: { ...state, current: null, exitSave: event.save },
263
+ commit: event.save ? 'on-exit-save' : 'none',
264
+ };
265
+ }
266
+ case 'eof': {
267
+ return { state: { ...state, current: null, aborted: true }, commit: 'none' };
268
+ }
269
+ }
270
+ }
@@ -4,14 +4,15 @@
4
4
  * apiKey 只回显「是否已配置 + 引用形态」,绝不回显明文值。
5
5
  * `${VAR}` 形态给变量名;明文形态只标记 `literal`。
6
6
  *
7
+ * options 键级脱敏(P6-4/M4):manifest `secretOptions` 声明的键按同一
8
+ * `RedactedSecret` 视图打码;插件贡献不在有效注册表时 fail-closed 全量打码。
9
+ *
7
10
  * @module
8
11
  */
9
- /** 脱敏后的密钥视图 */
12
+ /** 脱敏后的 Secret 视图 */
10
13
  export interface RedactedSecret {
11
- /** 是否已配置非空值 */
12
14
  configured: boolean;
13
- /** `${VAR}` 形态 → 变量名;明文 → `'literal'`;未配置 → null */
14
- ref: string | null;
15
+ ref: 'literal' | string | null;
15
16
  }
16
17
  /** 脱敏后的 provider 视图(WebUI 表单回显) */
17
18
  export interface RedactedProvider {
@@ -21,19 +22,51 @@ export interface RedactedProvider {
21
22
  models: Array<Record<string, unknown>>;
22
23
  timeoutSeconds?: number;
23
24
  apiKey: RedactedSecret;
25
+ /** 插件 Provider 贡献 id(与 api 二选一) */
26
+ plugin?: string;
27
+ /** 插件自定义旋钮:manifest `secretOptions` 声明的键以 RedactedSecret 打码,其余原样透传。 */
28
+ options?: Record<string, unknown>;
24
29
  }
25
30
  /**
26
- * 把 apiKey 字符串脱敏为 `RedactedSecret`
31
+ * 脱敏一个 secret 值(唯一实现点:apiKey 与 options 键共用)
27
32
  *
28
- * @param value - 原始 apiKey(可能为 `${VAR}` 形态、明文或空)
33
+ * @param value - 原始值(可能为 `${VAR}` 形态、明文、空或非字符串对象)
29
34
  * @returns 脱敏视图(不含明文)
30
35
  */
31
- export declare function redactSecret(value: string | undefined): RedactedSecret;
36
+ export declare function redactSecret(value: unknown): RedactedSecret;
37
+ /**
38
+ * Whether an option value is one of OUR echo placeholders (a `RedactedSecret`
39
+ * view round-tripped by a config client). A placeholder means "the client did
40
+ * not change this value" — upsert must restore the stored value instead of
41
+ * writing the placeholder to disk (see resolveEchoPlaceholders).
42
+ *
43
+ * @param value - Candidate option value
44
+ * @returns Whether the value is a RedactedSecret-shaped placeholder
45
+ */
46
+ export declare function isRedactedSecret(value: unknown): value is RedactedSecret;
47
+ /**
48
+ * Resolve echo placeholders in an upserted provider config: for every
49
+ * manifest-declared secret option key holding a `RedactedSecret` placeholder,
50
+ * restore the previous stored value; without a stored value the key is
51
+ * dropped (a placeholder has no meaning on disk).
52
+ *
53
+ * @param config - The upserted provider config fragment
54
+ * @param previous - The stored config fragment it replaces (if any)
55
+ * @param secretOptionKeys - manifest `secretOptions` for this provider
56
+ * @returns The config with placeholders resolved
57
+ */
58
+ export declare function resolveEchoPlaceholders<T extends {
59
+ options?: Record<string, unknown>;
60
+ }>(config: T, previous: {
61
+ options?: Record<string, unknown>;
62
+ } | undefined, secretOptionKeys: readonly string[]): T;
32
63
  /**
33
64
  * 脱敏单个 provider 配置
34
65
  *
35
66
  * @param name - provider 名
36
- * @param pc - provider 配置(已展开 `${ENV}` 的运行时形态或 raw 形态均可)
67
+ * @param pc - provider 配置
68
+ * @param secretOptionKeys - manifest `secretOptions`(undefined=内置 provider
69
+ * 原样透传;null=插件贡献未知,fail-closed 全量打码;数组=声明键打码)
37
70
  * @returns 脱敏视图
38
71
  */
39
- export declare function redactProvider(name: string, pc: Record<string, unknown>): RedactedProvider;
72
+ export declare function redactProvider(name: string, pc: Record<string, unknown>, secretOptionKeys?: readonly string[] | null): RedactedProvider;
@@ -4,31 +4,80 @@
4
4
  * apiKey 只回显「是否已配置 + 引用形态」,绝不回显明文值。
5
5
  * `${VAR}` 形态给变量名;明文形态只标记 `literal`。
6
6
  *
7
+ * options 键级脱敏(P6-4/M4):manifest `secretOptions` 声明的键按同一
8
+ * `RedactedSecret` 视图打码;插件贡献不在有效注册表时 fail-closed 全量打码。
9
+ *
7
10
  * @module
8
11
  */
9
12
  const ENV_REF_PATTERN = /^\$\{(\w+)(?::-.*?)?\}$/;
10
13
  /**
11
- * 把 apiKey 字符串脱敏为 `RedactedSecret`
14
+ * 脱敏一个 secret 值(唯一实现点:apiKey 与 options 键共用)
12
15
  *
13
- * @param value - 原始 apiKey(可能为 `${VAR}` 形态、明文或空)
16
+ * @param value - 原始值(可能为 `${VAR}` 形态、明文、空或非字符串对象)
14
17
  * @returns 脱敏视图(不含明文)
15
18
  */
16
19
  export function redactSecret(value) {
17
- if (!value)
20
+ if (value === undefined || value === null || value === '')
18
21
  return { configured: false, ref: null };
22
+ if (typeof value !== 'string')
23
+ return { configured: true, ref: 'literal' };
19
24
  const m = ENV_REF_PATTERN.exec(value);
20
25
  if (m)
21
26
  return { configured: true, ref: m[1] };
22
27
  return { configured: true, ref: 'literal' };
23
28
  }
29
+ /**
30
+ * Whether an option value is one of OUR echo placeholders (a `RedactedSecret`
31
+ * view round-tripped by a config client). A placeholder means "the client did
32
+ * not change this value" — upsert must restore the stored value instead of
33
+ * writing the placeholder to disk (see resolveEchoPlaceholders).
34
+ *
35
+ * @param value - Candidate option value
36
+ * @returns Whether the value is a RedactedSecret-shaped placeholder
37
+ */
38
+ export function isRedactedSecret(value) {
39
+ return (typeof value === 'object' &&
40
+ value !== null &&
41
+ !Array.isArray(value) &&
42
+ typeof value.configured === 'boolean' &&
43
+ Object.keys(value).every((key) => key === 'configured' || key === 'ref'));
44
+ }
45
+ /**
46
+ * Resolve echo placeholders in an upserted provider config: for every
47
+ * manifest-declared secret option key holding a `RedactedSecret` placeholder,
48
+ * restore the previous stored value; without a stored value the key is
49
+ * dropped (a placeholder has no meaning on disk).
50
+ *
51
+ * @param config - The upserted provider config fragment
52
+ * @param previous - The stored config fragment it replaces (if any)
53
+ * @param secretOptionKeys - manifest `secretOptions` for this provider
54
+ * @returns The config with placeholders resolved
55
+ */
56
+ export function resolveEchoPlaceholders(config, previous, secretOptionKeys) {
57
+ if (!config.options || secretOptionKeys.length === 0)
58
+ return config;
59
+ const options = { ...config.options };
60
+ for (const key of secretOptionKeys) {
61
+ if (!isRedactedSecret(options[key]))
62
+ continue;
63
+ const stored = previous?.options?.[key];
64
+ if (stored !== undefined && !isRedactedSecret(stored))
65
+ options[key] = stored;
66
+ else
67
+ delete options[key];
68
+ }
69
+ return { ...config, options };
70
+ }
24
71
  /**
25
72
  * 脱敏单个 provider 配置
26
73
  *
27
74
  * @param name - provider 名
28
- * @param pc - provider 配置(已展开 `${ENV}` 的运行时形态或 raw 形态均可)
75
+ * @param pc - provider 配置
76
+ * @param secretOptionKeys - manifest `secretOptions`(undefined=内置 provider
77
+ * 原样透传;null=插件贡献未知,fail-closed 全量打码;数组=声明键打码)
29
78
  * @returns 脱敏视图
30
79
  */
31
- export function redactProvider(name, pc) {
80
+ export function redactProvider(name, pc, secretOptionKeys) {
32
81
  const out = {
33
82
  name,
34
83
  baseUrl: typeof pc.baseUrl === 'string' ? pc.baseUrl : '',
@@ -38,5 +87,20 @@ export function redactProvider(name, pc) {
38
87
  };
39
88
  if (typeof pc.timeoutSeconds === 'number')
40
89
  out.timeoutSeconds = pc.timeoutSeconds;
90
+ if (typeof pc.plugin === 'string')
91
+ out.plugin = pc.plugin;
92
+ if (pc.options !== undefined && pc.options !== null && typeof pc.options === 'object' && !Array.isArray(pc.options)) {
93
+ // Three states: undefined = built-in provider (verbatim echo, no manifest
94
+ // exists); null = plugin contribution unknown to the live registry (fail
95
+ // closed — mask everything rather than echo a possibly-secret value);
96
+ // string[] = manifest-declared secret keys (mask those, pass others).
97
+ out.options =
98
+ secretOptionKeys === undefined
99
+ ? { ...pc.options }
100
+ : Object.fromEntries(Object.entries(pc.options).map(([key, value]) => [
101
+ key,
102
+ secretOptionKeys === null || secretOptionKeys.includes(key) ? redactSecret(value) : value,
103
+ ]));
104
+ }
41
105
  return out;
42
106
  }
@@ -114,13 +114,11 @@ export declare const AgentConfigSchema: z.ZodObject<{
114
114
  model: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
115
115
  provider: z.ZodString;
116
116
  model: z.ZodString;
117
- temperature: z.ZodOptional<z.ZodNumber>;
118
117
  maxTokens: z.ZodOptional<z.ZodNumber>;
119
118
  contextWindow: z.ZodOptional<z.ZodNumber>;
120
119
  fallbackModels: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
121
120
  provider: z.ZodString;
122
121
  model: z.ZodString;
123
- temperature: z.ZodOptional<z.ZodNumber>;
124
122
  maxTokens: z.ZodOptional<z.ZodNumber>;
125
123
  contextWindow: z.ZodOptional<z.ZodNumber>;
126
124
  }, z.core.$strip>]>>>;
@@ -128,6 +126,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
128
126
  tools: z.ZodOptional<z.ZodObject<{
129
127
  allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
130
128
  deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
129
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
131
130
  }, z.core.$strip>>;
132
131
  skillDirectory: z.ZodOptional<z.ZodString>;
133
132
  skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -181,7 +180,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
181
180
  }, z.core.$strip>>;
182
181
  }, z.core.$strip>>;
183
182
  budget: z.ZodOptional<z.ZodObject<{
184
- maxTurns: z.ZodOptional<z.ZodNumber>;
183
+ maxSteps: z.ZodOptional<z.ZodNumber>;
185
184
  maxTokens: z.ZodOptional<z.ZodNumber>;
186
185
  timeoutMs: z.ZodOptional<z.ZodNumber>;
187
186
  }, z.core.$strip>>;
@@ -189,10 +188,43 @@ export declare const AgentConfigSchema: z.ZodObject<{
189
188
  }, z.core.$strip>;
190
189
  export declare const PluginConfigSchema: z.ZodObject<{
191
190
  loadPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
192
- configs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
193
- }, z.core.$strip>;
191
+ allowList: z.ZodOptional<z.ZodArray<z.ZodString>>;
192
+ blockList: z.ZodOptional<z.ZodArray<z.ZodString>>;
193
+ entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
194
+ enabled: z.ZodOptional<z.ZodBoolean>;
195
+ config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
196
+ hooks: z.ZodOptional<z.ZodObject<{
197
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
198
+ timeouts: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
199
+ before_model_resolve: "before_model_resolve";
200
+ agent_turn_prepare: "agent_turn_prepare";
201
+ before_prompt_build: "before_prompt_build";
202
+ before_agent_run: "before_agent_run";
203
+ before_agent_reply: "before_agent_reply";
204
+ before_agent_finalize: "before_agent_finalize";
205
+ agent_end: "agent_end";
206
+ before_tool_call: "before_tool_call";
207
+ after_tool_call: "after_tool_call";
208
+ message_received: "message_received";
209
+ message_sending: "message_sending";
210
+ message_sent: "message_sent";
211
+ session_start: "session_start";
212
+ session_end: "session_end";
213
+ before_compaction: "before_compaction";
214
+ after_compaction: "after_compaction";
215
+ gateway_start: "gateway_start";
216
+ gateway_stop: "gateway_stop";
217
+ before_install: "before_install";
218
+ before_iteration: "before_iteration";
219
+ after_iteration: "after_iteration";
220
+ loop_end: "loop_end";
221
+ }> & z.core.$partial, z.ZodNumber>>;
222
+ }, z.core.$strict>>;
223
+ }, z.core.$strict>>>;
224
+ }, z.core.$strict>;
194
225
  export declare const ChannelConfigSchema: z.ZodObject<{
195
- type: z.ZodString;
226
+ type: z.ZodOptional<z.ZodString>;
227
+ plugin: z.ZodOptional<z.ZodString>;
196
228
  port: z.ZodOptional<z.ZodNumber>;
197
229
  host: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
198
230
  local: "local";
@@ -200,5 +232,7 @@ export declare const ChannelConfigSchema: z.ZodObject<{
200
232
  }>, z.ZodString]>>;
201
233
  path: z.ZodOptional<z.ZodString>;
202
234
  apiKey: z.ZodOptional<z.ZodString>;
235
+ tenantId: z.ZodOptional<z.ZodString>;
203
236
  corsOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
237
+ options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
204
238
  }, z.core.$strip>;
@@ -6,6 +6,7 @@
6
6
  import { z } from 'zod';
7
7
  import { ConfigPathSchema, InlinePersonaSchema, ModelConfigSchema, NetworkHostSchema, SessionRightsSchema, ToolPolicySchema, } from './shared.js';
8
8
  import { EffectPolicyConfigSchema } from './governance.js';
9
+ import { PLUGIN_HOOK_NAMES } from '../harness/extension/plugin-ecosystem/plugins/manifest.js';
9
10
  export const AgentConfigSchema = z.object({
10
11
  id: z.string({ error: 'Agent must have an id' }).min(1, 'Agent id cannot be empty'),
11
12
  /**
@@ -23,6 +24,7 @@ export const AgentConfigSchema = z.object({
23
24
  tools: ToolPolicySchema.optional(),
24
25
  /** Skill 目录(缺省 `home/skills`):与 `workspace`/`home` 同规(绝对或 `~` 形态,拒相对) */
25
26
  skillDirectory: ConfigPathSchema.optional(),
27
+ /** Skill 启用清单(按 skill id = SKILL.md 目录名):只启用列出的 Skill;缺省 = 目录内全部;`[]` = 全部关闭(未命中的 id 在 discover 时告警) */
26
28
  skills: z.array(z.string()).optional(),
27
29
  channelBindings: z.record(z.string(), z.string()).optional(),
28
30
  /** Session ACL 天花板(E6 L1);与角色 max / 绑定取交集 */
@@ -91,7 +93,7 @@ export const AgentConfigSchema = z.object({
91
93
  /** 委派预算上限(请求预算与此取交集) */
92
94
  budget: z
93
95
  .object({
94
- maxTurns: z.number().positive().optional(),
96
+ maxSteps: z.number().positive().optional(),
95
97
  maxTokens: z.number().positive().optional(),
96
98
  timeoutMs: z.number().positive().optional(),
97
99
  })
@@ -100,15 +102,51 @@ export const AgentConfigSchema = z.object({
100
102
  })
101
103
  .optional(),
102
104
  });
103
- export const PluginConfigSchema = z.object({
105
+ export const PluginConfigSchema = z
106
+ .object({
104
107
  loadPaths: z.array(z.string()).optional(),
105
- configs: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
106
- });
107
- export const ChannelConfigSchema = z.object({
108
- type: z.string({ error: 'Channel must have a type' }).min(1),
108
+ allowList: z.array(z.string()).optional(),
109
+ blockList: z.array(z.string()).optional(),
110
+ entries: z
111
+ .record(z.string(), z
112
+ .object({
113
+ enabled: z.boolean().optional(),
114
+ config: z.record(z.string(), z.unknown()).optional(),
115
+ hooks: z
116
+ .object({
117
+ timeoutMs: z.number().positive().optional(),
118
+ timeouts: z.partialRecord(z.enum(PLUGIN_HOOK_NAMES), z.number().positive()).optional(),
119
+ })
120
+ .strict()
121
+ .optional(),
122
+ })
123
+ .strict())
124
+ .optional(),
125
+ })
126
+ .strict();
127
+ export const ChannelConfigSchema = z
128
+ .object({
129
+ /** 内置通道类型(`http`);与 plugin 二选一(恰好其一) */
130
+ type: z.string().min(1).optional(),
131
+ /** 插件 Channel 贡献 id(manifest contributes.channels);与 type 二选一 */
132
+ plugin: z.string().min(1).optional(),
109
133
  port: z.number().positive().optional(),
110
134
  host: NetworkHostSchema.optional(),
111
135
  path: z.string().optional(),
136
+ /** 密钥通道(如飞书 App Secret,推荐 `${ENV_VAR}` 引用);options 禁放密钥 */
112
137
  apiKey: z.string().optional(),
138
+ /** bot 凭证归属租户(Q11=a 渠道锚定);缺省 = default 存量域 */
139
+ tenantId: z.string().min(1).optional(),
113
140
  corsOrigins: z.array(z.string()).optional(),
141
+ /** 插件自定义旋钮(非密钥;原样透传) */
142
+ options: z.record(z.string(), z.unknown()).optional(),
143
+ })
144
+ .superRefine((v, ctx) => {
145
+ // type | plugin 恰好其一:schema/写盘校验与装配路由同闸(装配是第二道闸)
146
+ if ((v.type === undefined) === (v.plugin === undefined)) {
147
+ ctx.addIssue({
148
+ code: z.ZodIssueCode.custom,
149
+ message: 'exactly one of type | plugin must be set',
150
+ });
151
+ }
114
152
  });