@octopi-agent/engine 0.98.4 → 0.102.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 (301) hide show
  1. package/dist/config-schema/agent.d.ts +35 -5
  2. package/dist/config-schema/agent.js +24 -4
  3. package/dist/config-schema/context.d.ts +6 -36
  4. package/dist/config-schema/context.js +4 -28
  5. package/dist/config-schema/engine.d.ts +57 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +8 -1
  8. package/dist/config-schema/governance.js +8 -1
  9. package/dist/config-schema/models.d.ts +2 -8
  10. package/dist/config-schema/models.js +0 -2
  11. package/dist/config-schema/run.d.ts +2 -2
  12. package/dist/config-schema/run.js +2 -2
  13. package/dist/config-schema/shared.d.ts +0 -3
  14. package/dist/config-schema/shared.js +0 -2
  15. package/dist/config-schema/substrate.d.ts +14 -88
  16. package/dist/config-schema/substrate.js +22 -107
  17. package/dist/config.d.ts +45 -113
  18. package/dist/config.js +8 -2
  19. package/dist/harness/activation/dispatcher.js +7 -0
  20. package/dist/harness/activation/inbox.d.ts +3 -3
  21. package/dist/harness/activation/inbox.js +3 -3
  22. package/dist/harness/activation/runtime.js +13 -5
  23. package/dist/harness/activation/types.d.ts +2 -2
  24. package/dist/harness/agent/builder.d.ts +24 -3
  25. package/dist/harness/agent/builder.js +131 -27
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.js +19 -2
  28. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  29. package/dist/harness/agent/wire-agent-builder.js +26 -7
  30. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  31. package/dist/harness/capabilities/document/factory.js +1 -0
  32. package/dist/harness/capabilities/document/port.js +6 -3
  33. package/dist/harness/capabilities/document/types.d.ts +5 -0
  34. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -1
  35. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  36. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +2 -2
  37. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  40. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  42. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  43. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +3 -3
  44. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  45. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  46. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  47. package/dist/harness/collaboration/delegation/index.js +1 -1
  48. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  49. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  50. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  51. package/dist/harness/collaboration/delegation/service.js +2 -1
  52. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  53. package/dist/harness/collaboration/delegation/store.js +2 -1
  54. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  55. package/dist/harness/collaboration/delegation/types.js +22 -0
  56. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  57. package/dist/harness/context/budget-allocator.d.ts +26 -18
  58. package/dist/harness/context/budget-allocator.js +67 -32
  59. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  60. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  61. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  62. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  63. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  64. package/dist/harness/context/capabilities/compact/index.js +4 -0
  65. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  66. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  67. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  68. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  69. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  70. package/dist/harness/context/capabilities/compact/types.js +11 -1
  71. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  72. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  73. package/dist/harness/context/capabilities/summary/port.js +0 -1
  74. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  75. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  76. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  77. package/dist/harness/context/capabilities/summary/types.d.ts +3 -6
  78. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  79. package/dist/harness/context/context-size-ledger.js +236 -0
  80. package/dist/harness/context/default-context-engine.d.ts +195 -119
  81. package/dist/harness/context/default-context-engine.js +1241 -743
  82. package/dist/harness/context/index.d.ts +2 -2
  83. package/dist/harness/context/index.js +1 -1
  84. package/dist/harness/context/layer-types.d.ts +15 -0
  85. package/dist/harness/context/layer-types.js +14 -1
  86. package/dist/harness/context/layers.d.ts +14 -15
  87. package/dist/harness/context/layers.js +41 -11
  88. package/dist/harness/context/message-selector.d.ts +10 -8
  89. package/dist/harness/context/message-selector.js +49 -27
  90. package/dist/harness/context/summarize.d.ts +2 -2
  91. package/dist/harness/context/summarize.js +9 -2
  92. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  93. package/dist/harness/context/system-prompt-assembler.js +2 -1
  94. package/dist/harness/context/token-constants.d.ts +8 -6
  95. package/dist/harness/context/token-constants.js +8 -7
  96. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  97. package/dist/harness/context/token-estimate-fns.js +85 -66
  98. package/dist/harness/context/token-estimator.d.ts +27 -12
  99. package/dist/harness/context/token-estimator.js +120 -66
  100. package/dist/harness/context/token-segments.d.ts +88 -0
  101. package/dist/harness/context/token-segments.js +103 -0
  102. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  103. package/dist/harness/context/tool-result-aging.js +16 -5
  104. package/dist/harness/context/tool-result-body.js +2 -0
  105. package/dist/harness/context/transform/anchors.d.ts +66 -0
  106. package/dist/harness/context/transform/anchors.js +125 -0
  107. package/dist/harness/context/transform/fold.d.ts +56 -0
  108. package/dist/harness/context/transform/fold.js +135 -0
  109. package/dist/harness/context/transform/migrate.d.ts +41 -0
  110. package/dist/harness/context/transform/migrate.js +69 -0
  111. package/dist/harness/context/transform/types.d.ts +129 -0
  112. package/dist/harness/context/transform/types.js +19 -0
  113. package/dist/harness/context/turn-envelope.d.ts +6 -3
  114. package/dist/harness/context/types.d.ts +127 -117
  115. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  116. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  117. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  118. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  119. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  120. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  121. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  122. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  123. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  124. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  125. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  126. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  127. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  128. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  129. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  130. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  131. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  132. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  133. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  134. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  135. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  136. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  137. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  138. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  139. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  140. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  145. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  146. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  147. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  149. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  150. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  151. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  153. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  155. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  157. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  161. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  164. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  165. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  167. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  168. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  171. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  172. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  173. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  174. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  175. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  176. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  177. package/dist/harness/index.d.ts +12 -12
  178. package/dist/harness/index.js +7 -7
  179. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  180. package/dist/harness/knowledge/boot-config.js +50 -0
  181. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  182. package/dist/harness/knowledge/client.d.ts +24 -2
  183. package/dist/harness/knowledge/client.js +19 -5
  184. package/dist/harness/knowledge/db.js +5 -0
  185. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  186. package/dist/harness/knowledge/describe-sample.js +58 -0
  187. package/dist/harness/knowledge/describe.d.ts +8 -0
  188. package/dist/harness/knowledge/describe.js +18 -2
  189. package/dist/harness/knowledge/engine-thread.js +6 -0
  190. package/dist/harness/knowledge/grounding.js +3 -1
  191. package/dist/harness/knowledge/http-app.js +35 -4
  192. package/dist/harness/knowledge/http-params.d.ts +18 -0
  193. package/dist/harness/knowledge/http-params.js +24 -0
  194. package/dist/harness/knowledge/index.d.ts +2 -0
  195. package/dist/harness/knowledge/index.js +1 -0
  196. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  197. package/dist/harness/knowledge/purge.js +5 -2
  198. package/dist/harness/knowledge/query-service.d.ts +13 -2
  199. package/dist/harness/knowledge/query-service.js +4 -2
  200. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  201. package/dist/harness/knowledge/query-worker-client.js +4 -2
  202. package/dist/harness/knowledge/query-worker.js +4 -2
  203. package/dist/harness/knowledge/read-http.js +5 -1
  204. package/dist/harness/knowledge/serve.d.ts +8 -7
  205. package/dist/harness/knowledge/serve.js +9 -0
  206. package/dist/harness/knowledge/source-store.js +26 -3
  207. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  208. package/dist/harness/knowledge/start-service-process.js +21 -9
  209. package/dist/harness/knowledge/types.d.ts +7 -0
  210. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  211. package/dist/harness/knowledge/writer-service.js +120 -14
  212. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  213. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  214. package/dist/harness/knowledge/writer-worker.js +9 -1
  215. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  216. package/dist/harness/memory/types.d.ts +6 -4
  217. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  218. package/dist/harness/memory/wisdom-formation.js +85 -22
  219. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  220. package/dist/harness/memory/wisdom-gates.js +59 -19
  221. package/dist/harness/memory/wisdom.js +9 -0
  222. package/dist/harness/observability/observer/hub.js +25 -15
  223. package/dist/harness/observability/observer/types.d.ts +10 -6
  224. package/dist/harness/run/agent/agent.d.ts +40 -21
  225. package/dist/harness/run/agent/agent.js +66 -13
  226. package/dist/harness/run/agent/index.d.ts +1 -1
  227. package/dist/harness/run/budget/budget.d.ts +28 -10
  228. package/dist/harness/run/budget/budget.js +38 -15
  229. package/dist/harness/run/model/index.d.ts +3 -1
  230. package/dist/harness/run/model/index.js +2 -1
  231. package/dist/harness/run/model/resolver.d.ts +4 -1
  232. package/dist/harness/run/model/resolver.js +36 -2
  233. package/dist/harness/run/model/run-scope.d.ts +2 -0
  234. package/dist/harness/run/model/run-scope.js +7 -0
  235. package/dist/harness/run/model/types.d.ts +22 -5
  236. package/dist/harness/run/model/types.js +3 -2
  237. package/dist/harness/run/model/window-truth.d.ts +37 -0
  238. package/dist/harness/run/model/window-truth.js +39 -0
  239. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  240. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  241. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  242. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  243. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  244. package/dist/harness/run/reliability/run-agent.js +137 -53
  245. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  246. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  247. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  248. package/dist/harness/run/run-scope.d.ts +37 -4
  249. package/dist/harness/run/runner.d.ts +44 -29
  250. package/dist/harness/run/runner.js +320 -102
  251. package/dist/harness/session/attachments/index.d.ts +1 -0
  252. package/dist/harness/session/attachments/index.js +1 -0
  253. package/dist/harness/session/attachments/inject.d.ts +21 -10
  254. package/dist/harness/session/attachments/inject.js +76 -24
  255. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  256. package/dist/harness/session/attachments/recall-index.js +219 -0
  257. package/dist/harness/session/attachments/service.d.ts +21 -0
  258. package/dist/harness/session/attachments/service.js +258 -139
  259. package/dist/harness/session/attachments/types.d.ts +6 -0
  260. package/dist/harness/session/transform-store.d.ts +136 -0
  261. package/dist/harness/session/transform-store.js +302 -0
  262. package/dist/harness/session/types.d.ts +2 -2
  263. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  264. package/dist/harness/shared/events/agent-event-map.js +3 -2
  265. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  266. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  267. package/dist/index.d.ts +14 -17
  268. package/dist/index.js +7 -9
  269. package/dist/integration/observability/metrics.d.ts +6 -6
  270. package/dist/integration/observability/metrics.js +13 -13
  271. package/dist/integration/observability/observer-bridge.js +2 -2
  272. package/dist/integration/observability/trace-collector.d.ts +5 -5
  273. package/dist/integration/observability/trace-collector.js +34 -35
  274. package/dist/integration/observability/trace-events.d.ts +3 -3
  275. package/dist/integration/observability/trace-events.js +3 -3
  276. package/dist/integration/providers/anthropic.js +14 -1
  277. package/dist/integration/providers/openai.js +7 -1
  278. package/dist/integration/providers/usage.d.ts +1 -1
  279. package/dist/integration/providers/wire-dump.d.ts +1 -1
  280. package/dist/integration/storage/archive-manager.d.ts +6 -0
  281. package/dist/integration/storage/archive-manager.js +10 -0
  282. package/dist/integration/storage/jsonl.d.ts +1 -1
  283. package/dist/integration/storage/jsonl.js +18 -16
  284. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  285. package/dist/subsystems/wisdom-steward/formation/config.yaml +1 -0
  286. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  287. package/package.json +11 -14
  288. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  289. package/dist/harness/context/hybrid-compressor.js +0 -159
  290. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  291. package/dist/harness/context/llm-summarizer.js +0 -249
  292. package/dist/harness/context/smart-router.d.ts +0 -75
  293. package/dist/harness/context/smart-router.js +0 -118
  294. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  295. package/dist/harness/context/truncate-compressor.js +0 -107
  296. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  297. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  298. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  299. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  300. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  301. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -1,24 +1,7 @@
1
- /**
2
- * Plugin System
3
- *
4
- * 核心概念:
5
- * - Plugin = 能力的所有权边界(Provider/Channel/Tool/Hook 等)
6
- * - definePluginEntry() = 创建 plugin 的标准方式
7
- * - PluginApi = plugin register() 回调中接收的 api 对象
8
- * - PluginManifest = 声明式元数据(octopi.plugin.json)
9
- * - PluginLoader = 发现和加载 plugins
10
- * - PluginManager = 管理 plugin 生命周期和 hook 执行
11
- * - CapabilityRegistry = 能力注册中心
12
- */
13
- export { definePluginEntry, defineChannelPluginEntry } from './entry.js';
14
- export type { OctopiPluginDefinition, OctopiChannelPluginDefinition } from './entry.js';
1
+ /** Plugin author contract. Host loading and mounting live under ./harness/. */
2
+ export { definePlugin } from './entry.js';
3
+ export type { OctopiPluginDefinition } from './entry.js';
15
4
  export { PluginApi } from './api.js';
16
- export type { PluginLogger, HookRegistrationOptions, ToolRegistrationOptions, ProviderRegistration, ChannelRegistration, } from './api.js';
17
- export { validateManifest, parseManifest } from './manifest.js';
18
- export type { PluginManifest, PluginContracts, ActivationConfig, SetupConfig, JsonSchema, } from './manifest.js';
19
- export { CapabilityRegistry, registerManifestCapabilities } from './capability.js';
20
- export type { CapabilityType, CapabilityRecord } from './capability.js';
21
- export { PluginLoader } from './loader.js';
22
- export type { LoadedPlugin, PluginLoaderConfig, PluginEntryConfig } from './loader.js';
23
- export { PluginManager } from './manager.js';
24
- export type { BeforeModelResolveEvent, AgentTurnPrepareEvent, BeforePromptBuildEvent, BeforeAgentRunEvent, BeforeAgentReplyEvent, BeforeAgentFinalizeEvent, AgentEndEvent, BeforeToolCallEvent, AfterToolCallEvent, MessageReceivedEvent, MessageSendingEvent, MessageSentEvent, SessionLifecycleEvent, CompactionEvent, GatewayLifecycleEvent, BeforeInstallEvent, ModelResolveResult, PromptBuildResult, AgentRunResult, AgentReplyResult, AgentFinalizeResult, ToolCallResult, MessageSendingResult, InstallResult, } from './manager.js';
5
+ export type { PluginLogger, PluginCommandRegistration, PluginCommandContext, PluginHookMap, HookHandler, HookRegistrationOptions, ToolRegistrationOptions, } from './api.js';
6
+ export { PLUGIN_API_VERSION, PLUGIN_HOOK_NAMES, validateManifest, parseManifest, validatePluginConfig, } from './manifest.js';
7
+ export type { PluginManifest, PluginContributions, PluginCommandContribution, PluginHookName, PluginSessionOpName, JsonSchema, } from './manifest.js';
@@ -1,24 +1,4 @@
1
- /**
2
- * Plugin System
3
- *
4
- * 核心概念:
5
- * - Plugin = 能力的所有权边界(Provider/Channel/Tool/Hook 等)
6
- * - definePluginEntry() = 创建 plugin 的标准方式
7
- * - PluginApi = plugin register() 回调中接收的 api 对象
8
- * - PluginManifest = 声明式元数据(octopi.plugin.json)
9
- * - PluginLoader = 发现和加载 plugins
10
- * - PluginManager = 管理 plugin 生命周期和 hook 执行
11
- * - CapabilityRegistry = 能力注册中心
12
- */
13
- // ── 定义和创建 ──
14
- export { definePluginEntry, defineChannelPluginEntry } from './entry.js';
15
- // ── Plugin API ──
1
+ /** Plugin author contract. Host loading and mounting live under ./harness/. */
2
+ export { definePlugin } from './entry.js';
16
3
  export { PluginApi } from './api.js';
17
- // ── Manifest ──
18
- export { validateManifest, parseManifest } from './manifest.js';
19
- // ── Capability Registry ──
20
- export { CapabilityRegistry, registerManifestCapabilities } from './capability.js';
21
- // ── Plugin Loader ──
22
- export { PluginLoader } from './loader.js';
23
- // ── Plugin Manager ──
24
- export { PluginManager } from './manager.js';
4
+ export { PLUGIN_API_VERSION, PLUGIN_HOOK_NAMES, validateManifest, parseManifest, validatePluginConfig, } from './manifest.js';
@@ -1,133 +1,66 @@
1
- /**
2
- * Plugin Loader — Plugin 发现和加载
3
- *
4
- * 加载流程:
5
- * 1. Discovery — 从配置路径发现候选 plugins
6
- * 2. Validation — 验证 manifest、检查 enable/disable 状态
7
- * 3. Loading — 进程内加载 plugin 代码
8
- * 4. Registration — 调用 register() 注册能力
9
- */
10
- import type { PluginManifest } from './manifest.js';
1
+ /** Manifest-first discovery: no plugin code runs before eligibility and config validation. */
2
+ import { type PluginManifest } from './manifest.js';
11
3
  import type { OctopiPluginDefinition } from './entry.js';
12
- import type { PluginApi } from './api.js';
13
- import { CapabilityRegistry } from './capability.js';
14
- /**
15
- * 加载后的 Plugin 实例
16
- */
17
- export interface LoadedPlugin {
18
- /** Plugin ID */
19
- id: string;
20
- /** Plugin Manifest */
21
- manifest: PluginManifest;
22
- /** Plugin 定义(包含 register 回调) */
23
- definition: OctopiPluginDefinition;
24
- /** Plugin API 实例 */
25
- api: PluginApi;
26
- /** Plugin 源路径 */
27
- source: string;
28
- /** Plugin root 目录 */
29
- rootDir: string;
30
- /** 是否已执行 register() */
31
- registered: boolean;
32
- }
33
- /**
34
- * Plugin Loader 配置
35
- */
36
- export interface PluginLoaderConfig {
37
- /** Plugin 搜索路径列表 */
38
- loadPaths: string[];
39
- /** 允许的 plugin IDs(白名单,空 = 全部允许) */
40
- allowList?: string[];
41
- /** 禁用的 plugin IDs */
42
- blockList?: string[];
43
- /** Plugin 配置 entries */
44
- pluginEntries?: Record<string, PluginEntryConfig>;
45
- }
46
- /**
47
- * Plugin Entry 配置(来自宿主配置)
48
- */
4
+ import { PluginContributionRegistry, type RegisteredPlugin } from './contribution-registry.js';
49
5
  export interface PluginEntryConfig {
50
- /** 是否启用 */
51
6
  enabled?: boolean;
52
- /** Plugin 配置 */
53
7
  config?: Record<string, unknown>;
54
- /** Hook 配置 */
8
+ /** Per-plugin hook timeout policy; consumed by the Hook adapter (timeouts keyed by hook name). */
55
9
  hooks?: {
56
- /** 全局 hook 超时 */
57
10
  timeoutMs?: number;
58
- /** 按 hook 名称的超时 */
59
11
  timeouts?: Record<string, number>;
60
- /** 超时后是否中断 hook 链(默认 false:跳过并继续) */
61
- abortOnTimeout?: Record<string, boolean>;
62
- /** 是否允许 conversation access */
63
- allowConversationAccess?: boolean;
64
- /** 是否允许 prompt injection */
65
- allowPromptInjection?: boolean;
66
12
  };
67
13
  }
68
- /**
69
- * Plugin Loader
70
- *
71
- * 负责从文件系统发现和加载 plugins。
72
- */
14
+ export interface PluginLoaderConfig {
15
+ loadPaths: string[];
16
+ allowList?: string[];
17
+ blockList?: string[];
18
+ entries?: Record<string, PluginEntryConfig>;
19
+ engineVersion?: string;
20
+ }
21
+ export type PluginDiagnosticStatus = 'disabled' | 'failed' | 'registered';
22
+ export interface PluginDiagnostic {
23
+ id: string;
24
+ status: PluginDiagnosticStatus;
25
+ stage: 'manifest' | 'policy' | 'dependency' | 'config' | 'entry' | 'import' | 'register' | 'publish';
26
+ reason: string;
27
+ path?: string;
28
+ }
29
+ export interface LoadedPlugin extends RegisteredPlugin {
30
+ id: string;
31
+ name: string;
32
+ version: string;
33
+ description?: string;
34
+ manifest: PluginManifest;
35
+ definition: OctopiPluginDefinition;
36
+ source: 'local' | 'npm';
37
+ registered: true;
38
+ }
73
39
  export declare class PluginLoader {
74
- /** 已加载的 plugins */
75
- private plugins;
76
- /** Capability Registry */
77
- readonly capabilities: CapabilityRegistry;
78
- /** 配置 */
40
+ readonly contributions: PluginContributionRegistry;
79
41
  private config;
42
+ private plugins;
43
+ private diagnostics;
80
44
  constructor(config: PluginLoaderConfig);
81
- /**
82
- * 发现并加载所有 plugins
83
- *
84
- * 扫描所有配置路径,查找包含 octopi.plugin.json 的目录。
85
- *
86
- * @returns 加载的 plugin 列表
87
- */
45
+ /** Resolve a loaded plugin's configured hook policy, including legacy aliases. */
46
+ getPluginConfig(id: string): PluginEntryConfig | undefined;
47
+ /** Discover, validate and atomically publish the successful plugin set. */
88
48
  discover(): Promise<LoadedPlugin[]>;
89
- /**
90
- * 扫描单个目录,发现 plugins
91
- */
92
- private scanDirectory;
93
- /**
94
- * 从目录加载单个 plugin
95
- */
96
- private loadPluginFromDir;
97
- /**
98
- * 解析 plugin 入口文件
99
- *
100
- * 查找顺序:
101
- * 1. package.json 中的 main / exports
102
- * 2. index.ts / index.js
103
- * 3. src/index.ts / src/index.js
104
- */
105
- private resolveEntryPoint;
106
- /**
107
- * 过滤 plugins(allowlist / blocklist / enabled)
108
- */
109
- private filterPlugins;
110
- /**
111
- * 拓扑排序:按依赖关系排列 plugin 顺序
112
- *
113
- * 使用 Kahn 算法。被依赖的 plugin 排在前面。
114
- * 存在循环依赖时,剩余的 plugin 按原始顺序追加并警告。
115
- */
116
- private resolveDependencyOrder;
117
- /**
118
- * 执行 plugin 的 register()
119
- */
120
- private registerPlugin;
121
- /**
122
- * 获取已加载的 plugin
123
- */
49
+ private scanDirectories;
50
+ private readCandidate;
51
+ private addCandidate;
52
+ private applyAliases;
53
+ private isEligible;
54
+ private prepareCandidate;
55
+ private markDependencyFailures;
56
+ private checkDeclaredConflicts;
57
+ private importAndRegister;
58
+ private resolveEntry;
59
+ private assertActualContributions;
60
+ private disabled;
61
+ private fail;
62
+ getDiagnostics(): PluginDiagnostic[];
63
+ getRegisteredIds(): string[];
124
64
  getPlugin(id: string): LoadedPlugin | undefined;
125
- /**
126
- * 获取所有已加载的 plugins
127
- */
128
65
  getAllPlugins(): LoadedPlugin[];
129
- /**
130
- * 获取所有已注册的 plugin IDs
131
- */
132
- getRegisteredIds(): string[];
133
66
  }