@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
@@ -1,336 +1,333 @@
1
+ /** Manifest-first discovery: no plugin code runs before eligibility and config validation. */
2
+ import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
3
+ import { join, relative, resolve, sep } from 'node:path';
4
+ import { pathToFileURL } from 'node:url';
5
+ import { PluginApi } from './api.js';
6
+ import { CONTRIBUTION_KINDS, assertManifestCoverage, declaredClaims } from './contribution-kinds.js';
7
+ import { parseManifest, validatePluginConfig, } from './manifest.js';
8
+ import { PluginContributionRegistry, } from './contribution-registry.js';
9
+ import { getEngineVersion, satisfiesEngineRange } from './engine-compatibility.js';
10
+ import { readStaging } from './staging.js';
1
11
  /**
2
- * Plugin Loader — Plugin 发现和加载
12
+ * Resolve a manifest entry to its real path inside the plugin root. Shared
13
+ * single source for the loader and `octopi plugin doctor`: rejects entries
14
+ * that escape the plugin root (before and after symlink resolution).
3
15
  *
4
- * 加载流程:
5
- * 1. Discovery — 从配置路径发现候选 plugins
6
- * 2. Validation — 验证 manifest、检查 enable/disable 状态
7
- * 3. Loading — 进程内加载 plugin 代码
8
- * 4. Registration — 调用 register() 注册能力
9
- */
10
- import * as path from 'node:path';
11
- import * as fs from 'node:fs/promises';
12
- import { existsSync } from 'node:fs';
13
- import { validateManifest } from './manifest.js';
14
- import { PluginApi as PluginApiClass } from './api.js';
15
- import { CapabilityRegistry, registerManifestCapabilities } from './capability.js';
16
- /**
17
- * Plugin Loader
18
- *
19
- * 负责从文件系统发现和加载 plugins。
16
+ * @param rootDir - Plugin directory
17
+ * @param entry - Manifest `entry` (relative path)
18
+ * @returns The real path of the entry file
19
+ * @throws When the entry is missing, escapes its root, or is not a file
20
20
  */
21
+ export function resolvePluginEntry(rootDir, entry) {
22
+ const root = realpathSync(rootDir);
23
+ const candidate = resolve(root, entry);
24
+ if (relative(root, candidate).startsWith(`..${sep}`) || relative(root, candidate) === '..') {
25
+ throw new Error(`Plugin entry escapes its root: ${entry}`);
26
+ }
27
+ const real = realpathSync(candidate);
28
+ const rel = relative(root, real);
29
+ if (rel === '..' || rel.startsWith(`..${sep}`)) {
30
+ throw new Error(`Plugin entry realpath escapes its root: ${entry}`);
31
+ }
32
+ return real;
33
+ }
34
+ const PLUGIN_MANIFEST_FILENAME = 'octopi.plugin.json';
21
35
  export class PluginLoader {
22
- /** 已加载的 plugins */
23
- plugins = new Map();
24
- /** Capability Registry */
25
- capabilities = new CapabilityRegistry();
26
- /** 配置 */
36
+ contributions = new PluginContributionRegistry();
27
37
  config;
38
+ plugins = new Map();
39
+ diagnostics = [];
28
40
  constructor(config) {
29
41
  this.config = config;
30
42
  }
31
- /**
32
- * 发现并加载所有 plugins
33
- *
34
- * 扫描所有配置路径,查找包含 octopi.plugin.json 的目录。
35
- *
36
- * @returns 加载的 plugin 列表
37
- */
43
+ /** Resolve a loaded plugin's configured hook policy, including legacy aliases. */
44
+ getPluginConfig(id) {
45
+ const plugin = this.plugins.get(id);
46
+ if (!plugin)
47
+ return undefined;
48
+ const ids = [plugin.id, ...(plugin.manifest.legacyPluginIds ?? [])];
49
+ return ids.map((key) => this.config.entries?.[key]).find((entry) => entry !== undefined);
50
+ }
51
+ /** Discover, validate and atomically publish the successful plugin set. */
38
52
  async discover() {
39
- const discovered = [];
53
+ // Keep the previous effective snapshot until the next complete set validates.
54
+ this.diagnostics = [];
55
+ const candidates = new Map();
56
+ const aliases = new Map();
57
+ const rejectedIds = new Set();
40
58
  for (const loadPath of this.config.loadPaths) {
41
- try {
42
- const plugins = await this.scanDirectory(loadPath);
43
- discovered.push(...plugins);
44
- }
45
- catch (err) {
46
- console.warn(`[PluginLoader] Failed to scan "${loadPath}":`, err);
59
+ for (const rootDir of this.scanDirectories(loadPath)) {
60
+ const candidate = this.readCandidate(rootDir);
61
+ if (candidate)
62
+ this.addCandidate(candidate, candidates, aliases, rejectedIds);
47
63
  }
48
64
  }
49
- // 过滤:allowlist / blocklist / enabled
50
- const filtered = this.filterPlugins(discovered);
51
- // 依赖解析:按 requiresPlugins 拓扑排序
52
- const ordered = this.resolveDependencyOrder(filtered);
53
- // 检查缺失的依赖
54
- const ids = new Set(ordered.map(p => p.manifest.id));
55
- const disabled = new Set();
56
- for (const plugin of ordered) {
57
- const deps = plugin.manifest.requiresPlugins ?? [];
58
- for (const dep of deps) {
59
- if (!ids.has(dep)) {
60
- console.warn(`[PluginLoader] Plugin "${plugin.manifest.id}" requires "${dep}", but it was not found. Skipping.`);
61
- disabled.add(plugin.manifest.id);
62
- }
63
- }
65
+ for (const candidate of candidates.values()) {
66
+ candidate.config = this.config.entries?.[candidate.id];
64
67
  }
65
- // 执行 register()
66
- for (const plugin of ordered) {
67
- if (disabled.has(plugin.manifest.id))
68
- continue;
69
- await this.registerPlugin(plugin);
68
+ for (const id of rejectedIds) {
69
+ const candidate = candidates.get(id);
70
+ if (candidate)
71
+ candidate.rejected = true;
70
72
  }
71
- return ordered;
72
- }
73
- /**
74
- * 扫描单个目录,发现 plugins
75
- */
76
- async scanDirectory(dirPath) {
77
- const plugins = [];
78
- if (!existsSync(dirPath)) {
79
- return plugins;
73
+ this.applyAliases(candidates);
74
+ for (const candidate of candidates.values()) {
75
+ candidate.eligible = this.isEligible(candidate);
80
76
  }
81
- const entries = await fs.readdir(dirPath, { withFileTypes: true });
82
- for (const entry of entries) {
83
- if (!entry.isDirectory())
84
- continue;
85
- const pluginDir = path.join(dirPath, entry.name);
86
- const manifestPath = path.join(pluginDir, 'octopi.plugin.json');
87
- if (!existsSync(manifestPath))
77
+ for (const candidate of candidates.values()) {
78
+ if (candidate.eligible)
79
+ this.prepareCandidate(candidate);
80
+ }
81
+ // Configuration, entry, conflict and dependency failures must settle before any import.
82
+ let changed = true;
83
+ while (changed) {
84
+ const before = [...candidates.values()].filter((candidate) => candidate.eligible).length;
85
+ this.markDependencyFailures(candidates, aliases);
86
+ this.checkDeclaredConflicts(candidates);
87
+ changed = before !== [...candidates.values()].filter((candidate) => candidate.eligible).length;
88
+ }
89
+ const staged = [];
90
+ for (const candidate of candidates.values()) {
91
+ if (!candidate.eligible)
88
92
  continue;
89
- try {
90
- const plugin = await this.loadPluginFromDir(pluginDir, manifestPath);
91
- if (plugin) {
92
- plugins.push(plugin);
93
- }
93
+ const plugin = await this.importAndRegister(candidate);
94
+ if (plugin)
95
+ staged.push(plugin);
96
+ else
97
+ candidate.eligible = false;
98
+ }
99
+ this.markDependencyFailures(candidates, aliases);
100
+ const publishable = staged.filter((plugin) => candidates.get(plugin.manifest.id)?.eligible);
101
+ for (const plugin of staged) {
102
+ if (!candidates.get(plugin.manifest.id)?.eligible) {
103
+ this.fail(plugin.manifest.id, 'dependency', new Error('A required plugin failed to register'), plugin.path);
104
+ }
105
+ }
106
+ const nextDiscoveryFailed = this.diagnostics.some((item) => item.status === 'failed');
107
+ if (publishable.length === 0 && nextDiscoveryFailed && this.plugins.size > 0) {
108
+ const reason = 'New discovery has no publishable plugins; last complete snapshot retained for diagnosis';
109
+ this.fail('discovery', 'publish', new Error(reason));
110
+ throw new Error(`Plugin discovery failed: ${reason}`);
111
+ }
112
+ try {
113
+ const nextPlugins = new Map();
114
+ for (const plugin of publishable) {
115
+ const loaded = {
116
+ ...plugin,
117
+ id: plugin.manifest.id,
118
+ name: plugin.manifest.name,
119
+ version: plugin.manifest.version,
120
+ ...(plugin.manifest.description === undefined ? {} : { description: plugin.manifest.description }),
121
+ source: 'local',
122
+ registered: true,
123
+ };
124
+ nextPlugins.set(loaded.id, loaded);
94
125
  }
95
- catch (err) {
96
- console.warn(`[PluginLoader] Failed to load plugin from "${pluginDir}":`, err);
126
+ this.contributions.publish(publishable);
127
+ this.plugins = nextPlugins;
128
+ for (const plugin of nextPlugins.values()) {
129
+ this.diagnostics.push({ id: plugin.id, status: 'registered', stage: 'publish', reason: 'registered', path: plugin.path });
97
130
  }
98
131
  }
99
- return plugins;
132
+ catch (error) {
133
+ // publish constructs a replacement set before assignment; a conflict cannot leave a partial new set.
134
+ this.fail('unknown', 'publish', error);
135
+ }
136
+ return this.getRegisteredIds().map((id) => this.plugins.get(id));
100
137
  }
101
- /**
102
- * 从目录加载单个 plugin
103
- */
104
- async loadPluginFromDir(pluginDir, manifestPath) {
105
- // 1. 读取和验证 manifest
106
- const manifestJson = await fs.readFile(manifestPath, 'utf-8');
107
- let manifest;
138
+ scanDirectories(loadPath) {
139
+ const root = resolve(loadPath);
108
140
  try {
109
- manifest = validateManifest(JSON.parse(manifestJson));
141
+ const stat = readdirSync(root, { withFileTypes: true });
142
+ if (existsSync(join(root, PLUGIN_MANIFEST_FILENAME)))
143
+ return [root];
144
+ return stat
145
+ // Dot-dirs are never plugin candidates (sync scratch `.sync-*`, VCS, hidden).
146
+ .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.') && existsSync(join(root, entry.name, PLUGIN_MANIFEST_FILENAME)))
147
+ .map((entry) => join(root, entry.name));
110
148
  }
111
- catch (err) {
112
- console.warn(`[PluginLoader] Invalid manifest at "${manifestPath}":`, err);
113
- return null;
114
- }
115
- // 2. 查找入口文件
116
- const entryPoint = await this.resolveEntryPoint(pluginDir);
117
- if (!entryPoint) {
118
- console.warn(`[PluginLoader] No entry point found in "${pluginDir}"`);
119
- return null;
149
+ catch (error) {
150
+ this.diagnostics.push({ id: root, status: 'failed', stage: 'manifest', reason: errorMessage(error), path: root });
151
+ return [];
120
152
  }
121
- // 3. 加载 plugin 模块
122
- let definition;
153
+ }
154
+ readCandidate(rootDir) {
123
155
  try {
124
- const module = await import(entryPoint);
125
- definition = module.default ?? module;
126
- if (!definition?.id || !definition?.register) {
127
- console.warn(`[PluginLoader] Invalid plugin definition in "${entryPoint}": missing id or register`);
128
- return null;
129
- }
156
+ const manifest = parseManifest(readFileSync(join(rootDir, PLUGIN_MANIFEST_FILENAME), 'utf8'));
157
+ return { id: manifest.id, rootDir, manifest, eligible: false, rejected: false };
130
158
  }
131
- catch (err) {
132
- console.warn(`[PluginLoader] Failed to import "${entryPoint}":`, err);
159
+ catch (error) {
160
+ this.fail(rootDir, 'manifest', error, rootDir);
133
161
  return null;
134
162
  }
135
- // 4. 创建 PluginApi
136
- const entryConfig = this.config.pluginEntries?.[manifest.id];
137
- const api = new PluginApiClass({
138
- id: manifest.id,
139
- name: definition.name ?? manifest.name ?? manifest.id,
140
- version: definition.version ?? manifest.version,
141
- description: definition.description ?? manifest.description,
142
- source: entryPoint,
143
- rootDir: pluginDir,
144
- pluginConfig: entryConfig?.config,
145
- });
146
- // 5. 注册 manifest 中声明的能力
147
- try {
148
- registerManifestCapabilities(manifest, this.capabilities);
163
+ }
164
+ addCandidate(candidate, candidates, aliases, rejectedIds) {
165
+ const previous = candidates.get(candidate.id);
166
+ if (previous) {
167
+ this.fail(candidate.id, 'manifest', new Error(`Duplicate plugin id at ${candidate.rootDir} and ${previous.rootDir}`), candidate.rootDir);
168
+ rejectedIds.add(candidate.id);
169
+ return;
149
170
  }
150
- catch (err) {
151
- console.warn(`[PluginLoader] Capability registration failed for "${manifest.id}":`, err);
152
- return null;
171
+ const ids = [candidate.id, ...(candidate.manifest.legacyPluginIds ?? [])];
172
+ for (const id of ids) {
173
+ const owner = aliases.get(id);
174
+ if (owner && owner !== candidate.id) {
175
+ this.fail(candidate.id, 'manifest', new Error(`Plugin id or legacy alias "${id}" conflicts with "${owner}"`), candidate.rootDir);
176
+ this.fail(owner, 'manifest', new Error(`Plugin id or legacy alias "${id}" conflicts with "${candidate.id}"`));
177
+ rejectedIds.add(candidate.id).add(owner);
178
+ }
153
179
  }
154
- const plugin = {
155
- id: manifest.id,
156
- manifest,
157
- definition,
158
- api,
159
- source: entryPoint,
160
- rootDir: pluginDir,
161
- registered: false,
162
- };
163
- this.plugins.set(manifest.id, plugin);
164
- return plugin;
180
+ for (const id of ids)
181
+ aliases.set(id, candidate.id);
182
+ candidates.set(candidate.id, candidate);
165
183
  }
166
- /**
167
- * 解析 plugin 入口文件
168
- *
169
- * 查找顺序:
170
- * 1. package.json 中的 main / exports
171
- * 2. index.ts / index.js
172
- * 3. src/index.ts / src/index.js
173
- */
174
- async resolveEntryPoint(pluginDir) {
175
- // 检查 package.json
176
- const pkgPath = path.join(pluginDir, 'package.json');
177
- if (existsSync(pkgPath)) {
178
- try {
179
- const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8'));
180
- // main 字段
181
- if (pkg.main) {
182
- const main = path.resolve(pluginDir, pkg.main);
183
- if (existsSync(main))
184
- return main;
185
- }
184
+ applyAliases(candidates) {
185
+ for (const candidate of candidates.values()) {
186
+ const spellings = [candidate.id, ...(candidate.manifest.legacyPluginIds ?? [])];
187
+ const configured = spellings.filter((id) => this.config.entries?.[id] !== undefined);
188
+ if (configured.length > 1) {
189
+ this.fail(candidate.id, 'policy', new Error(`Plugin is configured under multiple identities: ${configured.join(', ')}`), candidate.rootDir);
190
+ candidate.rejected = true;
186
191
  }
187
- catch {
188
- // ignore
192
+ else if (configured.length === 1) {
193
+ candidate.config = this.config.entries?.[configured[0]];
189
194
  }
190
195
  }
191
- // 尝试常见入口文件
192
- const candidates = [
193
- 'index.ts', 'index.js', 'index.mjs',
194
- 'src/index.ts', 'src/index.js', 'src/index.mjs',
195
- 'dist/index.js', 'dist/index.mjs',
196
- ];
197
- for (const candidate of candidates) {
198
- const fullPath = path.join(pluginDir, candidate);
199
- if (existsSync(fullPath))
200
- return fullPath;
196
+ }
197
+ isEligible(candidate) {
198
+ if (candidate.rejected)
199
+ return false;
200
+ const ids = [candidate.id, ...(candidate.manifest.legacyPluginIds ?? [])];
201
+ if (this.config.blockList?.some((id) => ids.includes(id))) {
202
+ this.disabled(candidate, 'blocklisted');
203
+ return false;
204
+ }
205
+ if (this.config.allowList && !ids.some((id) => this.config.allowList.includes(id))) {
206
+ this.disabled(candidate, 'not in allowList');
207
+ return false;
201
208
  }
202
- return null;
209
+ const enabled = candidate.config?.enabled ?? candidate.manifest.enabledByDefault ?? true;
210
+ if (!enabled) {
211
+ this.disabled(candidate, 'disabled by configuration or manifest default');
212
+ return false;
213
+ }
214
+ return true;
203
215
  }
204
- /**
205
- * 过滤 plugins(allowlist / blocklist / enabled)
206
- */
207
- filterPlugins(plugins) {
208
- return plugins.filter((plugin) => {
209
- // Blocklist
210
- if (this.config.blockList?.includes(plugin.id)) {
211
- console.info(`[PluginLoader] Plugin "${plugin.id}" is blocklisted, skipping`);
212
- return false;
213
- }
214
- // Allowlist
215
- if (this.config.allowList && this.config.allowList.length > 0) {
216
- if (!this.config.allowList.includes(plugin.id)) {
217
- console.info(`[PluginLoader] Plugin "${plugin.id}" not in allowlist, skipping`);
218
- return false;
219
- }
216
+ prepareCandidate(candidate) {
217
+ try {
218
+ candidate.entryPoint = resolvePluginEntry(candidate.rootDir, candidate.manifest.entry);
219
+ candidate.pluginConfig = validatePluginConfig(candidate.manifest, candidate.config?.config);
220
+ const engineVersion = this.config.engineVersion ?? getEngineVersion();
221
+ if (!satisfiesEngineRange(engineVersion, candidate.manifest.engine.octopi)) {
222
+ throw new Error(`Requires Octopi ${candidate.manifest.engine.octopi}; host is ${engineVersion}`);
220
223
  }
221
- // Enabled check
222
- const entryConfig = this.config.pluginEntries?.[plugin.id];
223
- if (entryConfig?.enabled === false) {
224
- console.info(`[PluginLoader] Plugin "${plugin.id}" is disabled, skipping`);
224
+ }
225
+ catch (error) {
226
+ this.fail(candidate.id, 'config', error, candidate.rootDir);
227
+ candidate.eligible = false;
228
+ }
229
+ }
230
+ markDependencyFailures(candidates, aliases) {
231
+ const visiting = new Set();
232
+ const failed = new Set();
233
+ const visit = (id) => {
234
+ const candidate = candidates.get(id);
235
+ if (!candidate || !candidate.eligible)
236
+ return false;
237
+ if (visiting.has(id)) {
238
+ this.fail(id, 'dependency', new Error('Circular plugin dependency'), candidate.rootDir);
239
+ candidate.eligible = false;
240
+ failed.add(id);
225
241
  return false;
226
242
  }
227
- // Manifest enabledByDefault check
228
- if (plugin.manifest.enabledByDefault !== true && !entryConfig) {
229
- // 如果没有显式配置且 manifest 没有设置 enabledByDefault,则跳过
230
- // 除非有其他触发条件
231
- const hasActivation = plugin.manifest.activation &&
232
- (plugin.manifest.activation.onProviders?.length ||
233
- plugin.manifest.activation.onChannels?.length ||
234
- plugin.manifest.activation.onCommands?.length);
235
- if (!hasActivation && !plugin.manifest.enabledByDefault) {
236
- console.info(`[PluginLoader] Plugin "${plugin.id}" not enabled by default and no config, skipping`);
237
- return false;
243
+ if (failed.has(id))
244
+ return false;
245
+ visiting.add(id);
246
+ for (const dependencyName of candidate.manifest.requiresPlugins ?? []) {
247
+ const dependency = aliases.get(dependencyName) ?? dependencyName;
248
+ if (!visit(dependency)) {
249
+ this.fail(id, 'dependency', new Error(`Missing or ineligible dependency "${dependencyName}" (resolved to "${dependency}")`), candidate.rootDir);
250
+ candidate.eligible = false;
251
+ failed.add(id);
252
+ break;
238
253
  }
239
254
  }
240
- // 依赖检查
241
- if (plugin.manifest.requiresPlugins) {
242
- for (const dep of plugin.manifest.requiresPlugins) {
243
- if (!plugins.some((p) => p.id === dep)) {
244
- console.warn(`[PluginLoader] Plugin "${plugin.id}" requires "${dep}" which is not loaded`);
245
- // 依赖缺失不阻塞加载,只警告
255
+ visiting.delete(id);
256
+ return candidate.eligible;
257
+ };
258
+ for (const id of candidates.keys())
259
+ visit(id);
260
+ }
261
+ checkDeclaredConflicts(candidates) {
262
+ const claims = new Map();
263
+ for (const candidate of candidates.values()) {
264
+ if (!candidate.eligible)
265
+ continue;
266
+ for (const kind of CONTRIBUTION_KINDS) {
267
+ for (const claim of declaredClaims(kind, candidate.manifest)) {
268
+ const owner = claims.get(claim);
269
+ if (owner) {
270
+ this.fail(candidate.id, 'register', new Error(`Declared ${claim} conflicts with "${owner}"`), candidate.rootDir);
271
+ candidate.eligible = false;
272
+ const first = candidates.get(owner);
273
+ if (first) {
274
+ first.eligible = false;
275
+ this.fail(owner, 'register', new Error(`Declared ${claim} conflicts with "${candidate.id}"`), first.rootDir);
276
+ }
246
277
  }
278
+ else
279
+ claims.set(claim, candidate.id);
247
280
  }
248
281
  }
249
- return true;
250
- });
251
- }
252
- /**
253
- * 拓扑排序:按依赖关系排列 plugin 顺序
254
- *
255
- * 使用 Kahn 算法。被依赖的 plugin 排在前面。
256
- * 存在循环依赖时,剩余的 plugin 按原始顺序追加并警告。
257
- */
258
- resolveDependencyOrder(plugins) {
259
- const idToPlugin = new Map();
260
- for (const p of plugins) {
261
- idToPlugin.set(p.id, p);
262
- }
263
- // 计算入度(有多少 plugin 依赖它)
264
- const inDegree = new Map();
265
- const dependents = new Map(); // dep → [plugins that depend on it]
266
- for (const p of plugins) {
267
- if (!inDegree.has(p.id))
268
- inDegree.set(p.id, 0);
269
- const deps = (p.manifest.requiresPlugins ?? []).filter(d => idToPlugin.has(d));
270
- for (const dep of deps) {
271
- inDegree.set(p.id, (inDegree.get(p.id) ?? 0) + 1);
272
- if (!dependents.has(dep))
273
- dependents.set(dep, []);
274
- dependents.get(dep).push(p.id);
275
- }
276
282
  }
277
- // Kahn 算法
278
- const queue = [];
279
- for (const [id, deg] of inDegree) {
280
- if (deg === 0)
281
- queue.push(id);
283
+ }
284
+ async importAndRegister(candidate) {
285
+ const { manifest, rootDir, entryPoint, pluginConfig } = candidate;
286
+ if (!entryPoint || !pluginConfig) {
287
+ this.fail(manifest.id, 'config', new Error('Candidate has not completed pre-import validation'), rootDir);
288
+ return null;
282
289
  }
283
- const result = [];
284
- while (queue.length > 0) {
285
- const id = queue.shift();
286
- result.push(idToPlugin.get(id));
287
- for (const dep of (dependents.get(id) ?? [])) {
288
- const newDeg = (inDegree.get(dep) ?? 1) - 1;
289
- inDegree.set(dep, newDeg);
290
- if (newDeg === 0)
291
- queue.push(dep);
290
+ try {
291
+ const module = await import(pathToFileURL(entryPoint).href);
292
+ const definition = module.default;
293
+ if (!definition || definition.id !== manifest.id || typeof definition.register !== 'function') {
294
+ throw new Error(`Default entry must be definePlugin({ id: "${manifest.id}", register })`);
292
295
  }
296
+ const api = new PluginApi({
297
+ id: manifest.id,
298
+ name: manifest.name,
299
+ version: manifest.version,
300
+ ...(manifest.description === undefined ? {} : { description: manifest.description }),
301
+ source: rootDir,
302
+ rootDir,
303
+ pluginConfig,
304
+ });
305
+ await definition.register(api);
306
+ this.assertActualContributions(manifest, api);
307
+ return { manifest, definition, api, path: rootDir };
293
308
  }
294
- // 追加未解析的(循环依赖)
295
- const resolved = new Set(result.map(p => p.id));
296
- const remaining = plugins.filter(p => !resolved.has(p.id));
297
- if (remaining.length > 0) {
298
- console.warn(`[PluginLoader] Circular dependency detected among: ${remaining.map(p => p.id).join(', ')}. Appending in original order.`);
299
- result.push(...remaining);
309
+ catch (error) {
310
+ this.fail(manifest.id, 'register', error, rootDir);
311
+ return null;
300
312
  }
301
- return result;
302
313
  }
303
- /**
304
- * 执行 plugin 的 register()
305
- */
306
- async registerPlugin(plugin) {
307
- if (plugin.registered)
308
- return;
309
- try {
310
- await plugin.definition.register(plugin.api);
311
- plugin.registered = true;
312
- console.info(`[PluginLoader] Plugin "${plugin.id}" registered successfully`);
314
+ assertActualContributions(manifest, api) {
315
+ const staged = readStaging(api);
316
+ for (const kind of CONTRIBUTION_KINDS) {
317
+ assertManifestCoverage(kind, manifest, staged);
313
318
  }
314
- catch (err) {
315
- console.error(`[PluginLoader] Plugin "${plugin.id}" register() failed:`, err);
316
- }
317
- }
318
- /**
319
- * 获取已加载的 plugin
320
- */
321
- getPlugin(id) {
322
- return this.plugins.get(id);
323
319
  }
324
- /**
325
- * 获取所有已加载的 plugins
326
- */
327
- getAllPlugins() {
328
- return [...this.plugins.values()];
320
+ disabled(candidate, reason) {
321
+ this.diagnostics.push({ id: candidate.id, status: 'disabled', stage: 'policy', reason, path: candidate.rootDir });
329
322
  }
330
- /**
331
- * 获取所有已注册的 plugin IDs
332
- */
333
- getRegisteredIds() {
334
- return [...this.plugins.values()].filter((p) => p.registered).map((p) => p.id);
323
+ fail(id, stage, error, path) {
324
+ this.diagnostics.push({ id, status: 'failed', stage, reason: errorMessage(error), ...(path === undefined ? {} : { path }) });
335
325
  }
326
+ getDiagnostics() { return this.diagnostics.map((item) => ({ ...item })); }
327
+ getRegisteredIds() { return [...this.plugins.keys()]; }
328
+ getPlugin(id) { return this.plugins.get(id); }
329
+ getAllPlugins() { return [...this.plugins.values()]; }
330
+ }
331
+ function errorMessage(error) {
332
+ return error instanceof Error ? error.message : String(error);
336
333
  }