@octopi-agent/engine 0.55.0

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 (705) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +7 -0
  3. package/README.md +26 -0
  4. package/dist/builtin-model-info.d.ts +30 -0
  5. package/dist/builtin-model-info.js +118 -0
  6. package/dist/config-schema/agent.d.ts +72 -0
  7. package/dist/config-schema/agent.js +38 -0
  8. package/dist/config-schema/context.d.ts +122 -0
  9. package/dist/config-schema/context.js +100 -0
  10. package/dist/config-schema/engine.d.ts +665 -0
  11. package/dist/config-schema/engine.js +55 -0
  12. package/dist/config-schema/governance.d.ts +81 -0
  13. package/dist/config-schema/governance.js +55 -0
  14. package/dist/config-schema/models.d.ts +159 -0
  15. package/dist/config-schema/models.js +92 -0
  16. package/dist/config-schema/observability.d.ts +57 -0
  17. package/dist/config-schema/observability.js +59 -0
  18. package/dist/config-schema/run.d.ts +102 -0
  19. package/dist/config-schema/run.js +99 -0
  20. package/dist/config-schema/shared.d.ts +54 -0
  21. package/dist/config-schema/shared.js +43 -0
  22. package/dist/config-schema/substrate.d.ts +156 -0
  23. package/dist/config-schema/substrate.js +191 -0
  24. package/dist/config-schema/subsystems.d.ts +11 -0
  25. package/dist/config-schema/subsystems.js +13 -0
  26. package/dist/config-schema/web-search.d.ts +32 -0
  27. package/dist/config-schema/web-search.js +38 -0
  28. package/dist/config.d.ts +840 -0
  29. package/dist/config.js +161 -0
  30. package/dist/harness/activation/coalesce.d.ts +38 -0
  31. package/dist/harness/activation/coalesce.js +80 -0
  32. package/dist/harness/activation/compiler.d.ts +15 -0
  33. package/dist/harness/activation/compiler.js +136 -0
  34. package/dist/harness/activation/dispatcher.d.ts +19 -0
  35. package/dist/harness/activation/dispatcher.js +31 -0
  36. package/dist/harness/activation/event-source-types.d.ts +63 -0
  37. package/dist/harness/activation/event-source-types.js +13 -0
  38. package/dist/harness/activation/index.d.ts +20 -0
  39. package/dist/harness/activation/index.js +14 -0
  40. package/dist/harness/activation/router.d.ts +16 -0
  41. package/dist/harness/activation/router.js +28 -0
  42. package/dist/harness/activation/runtime.d.ts +78 -0
  43. package/dist/harness/activation/runtime.js +310 -0
  44. package/dist/harness/activation/sources/agent-signal.d.ts +34 -0
  45. package/dist/harness/activation/sources/agent-signal.js +93 -0
  46. package/dist/harness/activation/sources/escalate-bridge.d.ts +43 -0
  47. package/dist/harness/activation/sources/escalate-bridge.js +85 -0
  48. package/dist/harness/activation/sources/index.d.ts +6 -0
  49. package/dist/harness/activation/sources/index.js +3 -0
  50. package/dist/harness/activation/sources/schedule.d.ts +43 -0
  51. package/dist/harness/activation/sources/schedule.js +102 -0
  52. package/dist/harness/activation/types.d.ts +166 -0
  53. package/dist/harness/activation/types.js +15 -0
  54. package/dist/harness/agent/builder.d.ts +456 -0
  55. package/dist/harness/agent/builder.js +1414 -0
  56. package/dist/harness/agent/config-bridge.d.ts +80 -0
  57. package/dist/harness/agent/config-bridge.js +424 -0
  58. package/dist/harness/agent/index.d.ts +15 -0
  59. package/dist/harness/agent/index.js +12 -0
  60. package/dist/harness/agent/persona.d.ts +52 -0
  61. package/dist/harness/agent/persona.js +166 -0
  62. package/dist/harness/collaboration/autonomous-subsystem/audit/index.d.ts +4 -0
  63. package/dist/harness/collaboration/autonomous-subsystem/audit/index.js +2 -0
  64. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +18 -0
  65. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +83 -0
  66. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +36 -0
  67. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +54 -0
  68. package/dist/harness/collaboration/autonomous-subsystem/boundary/index.d.ts +2 -0
  69. package/dist/harness/collaboration/autonomous-subsystem/boundary/index.js +1 -0
  70. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +24 -0
  71. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +142 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/errors.d.ts +8 -0
  73. package/dist/harness/collaboration/autonomous-subsystem/errors.js +11 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +25 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/index.js +28 -0
  76. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +34 -0
  77. package/dist/harness/collaboration/autonomous-subsystem/loader.js +368 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +131 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +531 -0
  80. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +116 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +551 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/index.d.ts +5 -0
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/index.js +3 -0
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.d.ts +13 -0
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +128 -0
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +46 -0
  87. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +57 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +48 -0
  89. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +108 -0
  90. package/dist/harness/collaboration/autonomous-subsystem/session/index.d.ts +2 -0
  91. package/dist/harness/collaboration/autonomous-subsystem/session/index.js +1 -0
  92. package/dist/harness/collaboration/autonomous-subsystem/session/manager.d.ts +26 -0
  93. package/dist/harness/collaboration/autonomous-subsystem/session/manager.js +78 -0
  94. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +110 -0
  95. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +190 -0
  96. package/dist/harness/collaboration/autonomous-subsystem/signal/index.d.ts +2 -0
  97. package/dist/harness/collaboration/autonomous-subsystem/signal/index.js +1 -0
  98. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +107 -0
  99. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +405 -0
  100. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +6 -0
  101. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +3 -0
  102. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +65 -0
  103. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +116 -0
  104. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +64 -0
  105. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +89 -0
  106. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +559 -0
  107. package/dist/harness/collaboration/autonomous-subsystem/types.js +21 -0
  108. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +144 -0
  109. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +25 -0
  110. package/dist/harness/collaboration/multi-agent/index.d.ts +17 -0
  111. package/dist/harness/collaboration/multi-agent/index.js +15 -0
  112. package/dist/harness/collaboration/multi-agent/message-channel-types.d.ts +69 -0
  113. package/dist/harness/collaboration/multi-agent/message-channel-types.js +16 -0
  114. package/dist/harness/collaboration/multi-agent/process.d.ts +167 -0
  115. package/dist/harness/collaboration/multi-agent/process.js +256 -0
  116. package/dist/harness/collaboration/multi-agent/registry.d.ts +36 -0
  117. package/dist/harness/collaboration/multi-agent/registry.js +137 -0
  118. package/dist/harness/collaboration/multi-agent/swarm.d.ts +135 -0
  119. package/dist/harness/collaboration/multi-agent/swarm.js +317 -0
  120. package/dist/harness/collaboration/multi-agent/types.d.ts +66 -0
  121. package/dist/harness/collaboration/multi-agent/types.js +15 -0
  122. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +107 -0
  123. package/dist/harness/collaboration/orchestration/async-task-store.js +12 -0
  124. package/dist/harness/collaboration/orchestration/async-task.d.ts +156 -0
  125. package/dist/harness/collaboration/orchestration/async-task.js +359 -0
  126. package/dist/harness/collaboration/orchestration/cognitive-loop.d.ts +93 -0
  127. package/dist/harness/collaboration/orchestration/cognitive-loop.js +6 -0
  128. package/dist/harness/collaboration/orchestration/index.d.ts +19 -0
  129. package/dist/harness/collaboration/orchestration/index.js +16 -0
  130. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +47 -0
  131. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +61 -0
  132. package/dist/harness/collaboration/orchestration/planner/index.d.ts +9 -0
  133. package/dist/harness/collaboration/orchestration/planner/index.js +6 -0
  134. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +54 -0
  135. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +167 -0
  136. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +85 -0
  137. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +175 -0
  138. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +21 -0
  139. package/dist/harness/collaboration/orchestration/quality/classifier.js +235 -0
  140. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +29 -0
  141. package/dist/harness/collaboration/orchestration/quality/gate.js +409 -0
  142. package/dist/harness/collaboration/orchestration/quality/index.d.ts +9 -0
  143. package/dist/harness/collaboration/orchestration/quality/index.js +8 -0
  144. package/dist/harness/collaboration/orchestration/quality/types.d.ts +159 -0
  145. package/dist/harness/collaboration/orchestration/quality/types.js +33 -0
  146. package/dist/harness/collaboration/orchestration/reflector/index.d.ts +5 -0
  147. package/dist/harness/collaboration/orchestration/reflector/index.js +4 -0
  148. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +41 -0
  149. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +142 -0
  150. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +5 -0
  151. package/dist/harness/collaboration/orchestration/scheduler/index.js +4 -0
  152. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +143 -0
  153. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +297 -0
  154. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +12 -0
  155. package/dist/harness/collaboration/orchestration/strategy/classifier.js +81 -0
  156. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +3 -0
  157. package/dist/harness/collaboration/orchestration/strategy/index.js +2 -0
  158. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +28 -0
  159. package/dist/harness/collaboration/orchestration/strategy/router.js +105 -0
  160. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +49 -0
  161. package/dist/harness/collaboration/orchestration/strategy/types.js +4 -0
  162. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +86 -0
  163. package/dist/harness/collaboration/orchestration/workflow/engine.js +298 -0
  164. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +9 -0
  165. package/dist/harness/collaboration/orchestration/workflow/index.js +7 -0
  166. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +143 -0
  167. package/dist/harness/collaboration/orchestration/workflow/types.js +7 -0
  168. package/dist/harness/context/assembler.d.ts +74 -0
  169. package/dist/harness/context/assembler.js +315 -0
  170. package/dist/harness/context/budget-allocator.d.ts +41 -0
  171. package/dist/harness/context/budget-allocator.js +80 -0
  172. package/dist/harness/context/capabilities/compact/engine.d.ts +15 -0
  173. package/dist/harness/context/capabilities/compact/engine.js +320 -0
  174. package/dist/harness/context/capabilities/compact/index.d.ts +7 -0
  175. package/dist/harness/context/capabilities/compact/index.js +6 -0
  176. package/dist/harness/context/capabilities/compact/types.d.ts +78 -0
  177. package/dist/harness/context/capabilities/compact/types.js +6 -0
  178. package/dist/harness/context/capabilities/index.d.ts +10 -0
  179. package/dist/harness/context/capabilities/index.js +10 -0
  180. package/dist/harness/context/capabilities/summary/budget.d.ts +23 -0
  181. package/dist/harness/context/capabilities/summary/budget.js +26 -0
  182. package/dist/harness/context/capabilities/summary/executor.d.ts +37 -0
  183. package/dist/harness/context/capabilities/summary/executor.js +189 -0
  184. package/dist/harness/context/capabilities/summary/gate.d.ts +43 -0
  185. package/dist/harness/context/capabilities/summary/gate.js +69 -0
  186. package/dist/harness/context/capabilities/summary/index.d.ts +17 -0
  187. package/dist/harness/context/capabilities/summary/index.js +15 -0
  188. package/dist/harness/context/capabilities/summary/memory-cache.d.ts +16 -0
  189. package/dist/harness/context/capabilities/summary/memory-cache.js +42 -0
  190. package/dist/harness/context/capabilities/summary/oversized.d.ts +51 -0
  191. package/dist/harness/context/capabilities/summary/oversized.js +80 -0
  192. package/dist/harness/context/capabilities/summary/policies.d.ts +12 -0
  193. package/dist/harness/context/capabilities/summary/policies.js +139 -0
  194. package/dist/harness/context/capabilities/summary/port.d.ts +29 -0
  195. package/dist/harness/context/capabilities/summary/port.js +124 -0
  196. package/dist/harness/context/capabilities/summary/registry.d.ts +50 -0
  197. package/dist/harness/context/capabilities/summary/registry.js +182 -0
  198. package/dist/harness/context/capabilities/summary/resolver.d.ts +35 -0
  199. package/dist/harness/context/capabilities/summary/resolver.js +145 -0
  200. package/dist/harness/context/capabilities/summary/structured.d.ts +35 -0
  201. package/dist/harness/context/capabilities/summary/structured.js +163 -0
  202. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +86 -0
  203. package/dist/harness/context/capabilities/summary/tool-binding.js +166 -0
  204. package/dist/harness/context/capabilities/summary/types.d.ts +171 -0
  205. package/dist/harness/context/capabilities/summary/types.js +6 -0
  206. package/dist/harness/context/compact-key.d.ts +13 -0
  207. package/dist/harness/context/compact-key.js +17 -0
  208. package/dist/harness/context/constitution/default-agents.md +227 -0
  209. package/dist/harness/context/constitution/load-constitution.d.ts +30 -0
  210. package/dist/harness/context/constitution/load-constitution.js +66 -0
  211. package/dist/harness/context/default-context-engine.d.ts +171 -0
  212. package/dist/harness/context/default-context-engine.js +836 -0
  213. package/dist/harness/context/hybrid-compressor.d.ts +41 -0
  214. package/dist/harness/context/hybrid-compressor.js +158 -0
  215. package/dist/harness/context/index.d.ts +26 -0
  216. package/dist/harness/context/index.js +17 -0
  217. package/dist/harness/context/layer-health.d.ts +58 -0
  218. package/dist/harness/context/layer-health.js +160 -0
  219. package/dist/harness/context/layer-snapshot.d.ts +69 -0
  220. package/dist/harness/context/layer-snapshot.js +133 -0
  221. package/dist/harness/context/layer-types.d.ts +184 -0
  222. package/dist/harness/context/layer-types.js +79 -0
  223. package/dist/harness/context/layers.d.ts +146 -0
  224. package/dist/harness/context/layers.js +371 -0
  225. package/dist/harness/context/llm-summarizer.d.ts +38 -0
  226. package/dist/harness/context/llm-summarizer.js +220 -0
  227. package/dist/harness/context/message-selector.d.ts +44 -0
  228. package/dist/harness/context/message-selector.js +180 -0
  229. package/dist/harness/context/runtime-datetime.d.ts +49 -0
  230. package/dist/harness/context/runtime-datetime.js +74 -0
  231. package/dist/harness/context/smart-router.d.ts +75 -0
  232. package/dist/harness/context/smart-router.js +118 -0
  233. package/dist/harness/context/summarize.d.ts +39 -0
  234. package/dist/harness/context/summarize.js +50 -0
  235. package/dist/harness/context/system-prompt-assembler.d.ts +56 -0
  236. package/dist/harness/context/system-prompt-assembler.js +122 -0
  237. package/dist/harness/context/token-constants.d.ts +24 -0
  238. package/dist/harness/context/token-constants.js +27 -0
  239. package/dist/harness/context/token-estimate-fns.d.ts +70 -0
  240. package/dist/harness/context/token-estimate-fns.js +117 -0
  241. package/dist/harness/context/token-estimator.d.ts +63 -0
  242. package/dist/harness/context/token-estimator.js +126 -0
  243. package/dist/harness/context/truncate-compressor.d.ts +28 -0
  244. package/dist/harness/context/truncate-compressor.js +100 -0
  245. package/dist/harness/context/types.d.ts +316 -0
  246. package/dist/harness/context/types.js +9 -0
  247. package/dist/harness/extension/execution-environment/index.d.ts +10 -0
  248. package/dist/harness/extension/execution-environment/index.js +8 -0
  249. package/dist/harness/extension/execution-environment/isolation.d.ts +56 -0
  250. package/dist/harness/extension/execution-environment/isolation.js +56 -0
  251. package/dist/harness/extension/execution-environment/sandbox.d.ts +12 -0
  252. package/dist/harness/extension/execution-environment/sandbox.js +87 -0
  253. package/dist/harness/extension/execution-environment/types.d.ts +157 -0
  254. package/dist/harness/extension/execution-environment/types.js +6 -0
  255. package/dist/harness/extension/execution-environment/workspace.d.ts +26 -0
  256. package/dist/harness/extension/execution-environment/workspace.js +171 -0
  257. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +34 -0
  258. package/dist/harness/extension/plugin-ecosystem/channel-types.js +12 -0
  259. package/dist/harness/extension/plugin-ecosystem/commands/builtin.d.ts +34 -0
  260. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +185 -0
  261. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +15 -0
  262. package/dist/harness/extension/plugin-ecosystem/commands/index.js +11 -0
  263. package/dist/harness/extension/plugin-ecosystem/commands/parse.d.ts +17 -0
  264. package/dist/harness/extension/plugin-ecosystem/commands/parse.js +41 -0
  265. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +6 -0
  266. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +49 -0
  267. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +71 -0
  268. package/dist/harness/extension/plugin-ecosystem/commands/router.js +302 -0
  269. package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.d.ts +10 -0
  270. package/dist/harness/extension/plugin-ecosystem/commands/skill-bridge.js +59 -0
  271. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +126 -0
  272. package/dist/harness/extension/plugin-ecosystem/commands/types.js +7 -0
  273. package/dist/harness/extension/plugin-ecosystem/commands/user-source.d.ts +16 -0
  274. package/dist/harness/extension/plugin-ecosystem/commands/user-source.js +102 -0
  275. package/dist/harness/extension/plugin-ecosystem/index.d.ts +13 -0
  276. package/dist/harness/extension/plugin-ecosystem/index.js +10 -0
  277. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.d.ts +42 -0
  278. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +88 -0
  279. package/dist/harness/extension/plugin-ecosystem/mcp/discovery.d.ts +39 -0
  280. package/dist/harness/extension/plugin-ecosystem/mcp/discovery.js +117 -0
  281. package/dist/harness/extension/plugin-ecosystem/mcp/index.d.ts +10 -0
  282. package/dist/harness/extension/plugin-ecosystem/mcp/index.js +8 -0
  283. package/dist/harness/extension/plugin-ecosystem/mcp/manager.d.ts +74 -0
  284. package/dist/harness/extension/plugin-ecosystem/mcp/manager.js +146 -0
  285. package/dist/harness/extension/plugin-ecosystem/mcp/types.d.ts +149 -0
  286. package/dist/harness/extension/plugin-ecosystem/mcp/types.js +12 -0
  287. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +294 -0
  288. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +270 -0
  289. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +100 -0
  290. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +158 -0
  291. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +101 -0
  292. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +65 -0
  293. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +7 -0
  294. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +7 -0
  295. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +26 -0
  296. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +26 -0
  297. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +86 -0
  298. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +139 -0
  299. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +135 -0
  300. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +353 -0
  301. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +504 -0
  302. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +368 -0
  303. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +261 -0
  304. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +44 -0
  305. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +123 -0
  306. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +210 -0
  307. package/dist/harness/extension/plugin-ecosystem/skills/types.d.ts +29 -0
  308. package/dist/harness/extension/plugin-ecosystem/skills/types.js +7 -0
  309. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +34 -0
  310. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +92 -0
  311. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +101 -0
  312. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +570 -0
  313. package/dist/harness/extension/plugin-ecosystem/tools/env-info.d.ts +8 -0
  314. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +49 -0
  315. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.d.ts +14 -0
  316. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +126 -0
  317. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +23 -0
  318. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +659 -0
  319. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +28 -0
  320. package/dist/harness/extension/plugin-ecosystem/tools/http.js +170 -0
  321. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +14 -0
  322. package/dist/harness/extension/plugin-ecosystem/tools/index.js +12 -0
  323. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.d.ts +25 -0
  324. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +164 -0
  325. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +19 -0
  326. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +197 -0
  327. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +82 -0
  328. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +251 -0
  329. package/dist/harness/extension/plugin-ecosystem/tools/session-history.d.ts +21 -0
  330. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +165 -0
  331. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +65 -0
  332. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +262 -0
  333. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +34 -0
  334. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +30 -0
  335. package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.d.ts +66 -0
  336. package/dist/harness/extension/plugin-ecosystem/tools/web-search-types.js +12 -0
  337. package/dist/harness/extension/plugin-ecosystem/tools/web-search.d.ts +23 -0
  338. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +84 -0
  339. package/dist/harness/governance/accounting/index.d.ts +5 -0
  340. package/dist/harness/governance/accounting/index.js +3 -0
  341. package/dist/harness/governance/accounting/session-ledger.d.ts +67 -0
  342. package/dist/harness/governance/accounting/session-ledger.js +84 -0
  343. package/dist/harness/governance/accounting/usage-ledger.d.ts +107 -0
  344. package/dist/harness/governance/accounting/usage-ledger.js +137 -0
  345. package/dist/harness/governance/credentials/crypto.d.ts +34 -0
  346. package/dist/harness/governance/credentials/crypto.js +79 -0
  347. package/dist/harness/governance/credentials/db.d.ts +32 -0
  348. package/dist/harness/governance/credentials/db.js +87 -0
  349. package/dist/harness/governance/credentials/index.d.ts +9 -0
  350. package/dist/harness/governance/credentials/index.js +7 -0
  351. package/dist/harness/governance/credentials/store.d.ts +47 -0
  352. package/dist/harness/governance/credentials/store.js +228 -0
  353. package/dist/harness/governance/credentials/types.d.ts +67 -0
  354. package/dist/harness/governance/credentials/types.js +30 -0
  355. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +32 -0
  356. package/dist/harness/governance/human-in-the-loop/approval-manager.js +93 -0
  357. package/dist/harness/governance/human-in-the-loop/index.d.ts +9 -0
  358. package/dist/harness/governance/human-in-the-loop/index.js +7 -0
  359. package/dist/harness/governance/human-in-the-loop/types.d.ts +66 -0
  360. package/dist/harness/governance/human-in-the-loop/types.js +6 -0
  361. package/dist/harness/governance/index.d.ts +10 -0
  362. package/dist/harness/governance/index.js +10 -0
  363. package/dist/harness/governance/security/capability-enforcer.d.ts +56 -0
  364. package/dist/harness/governance/security/capability-enforcer.js +132 -0
  365. package/dist/harness/governance/security/default-risk-policy.d.ts +66 -0
  366. package/dist/harness/governance/security/default-risk-policy.js +75 -0
  367. package/dist/harness/governance/security/default-security-guard.d.ts +105 -0
  368. package/dist/harness/governance/security/default-security-guard.js +578 -0
  369. package/dist/harness/governance/security/degradation.d.ts +14 -0
  370. package/dist/harness/governance/security/degradation.js +208 -0
  371. package/dist/harness/governance/security/index.d.ts +10 -0
  372. package/dist/harness/governance/security/index.js +10 -0
  373. package/dist/harness/governance/security/risk-evaluator.d.ts +68 -0
  374. package/dist/harness/governance/security/risk-evaluator.js +1043 -0
  375. package/dist/harness/governance/security/risk-types.d.ts +74 -0
  376. package/dist/harness/governance/security/risk-types.js +7 -0
  377. package/dist/harness/governance/security/shell-parser.d.ts +35 -0
  378. package/dist/harness/governance/security/shell-parser.js +525 -0
  379. package/dist/harness/governance/security/tool-call-risk-policy.d.ts +6 -0
  380. package/dist/harness/governance/security/tool-call-risk-policy.js +6 -0
  381. package/dist/harness/governance/session-acl/index.d.ts +11 -0
  382. package/dist/harness/governance/session-acl/index.js +7 -0
  383. package/dist/harness/governance/session-acl/rights.d.ts +78 -0
  384. package/dist/harness/governance/session-acl/rights.js +142 -0
  385. package/dist/harness/governance/session-acl/seed-roles.d.ts +16 -0
  386. package/dist/harness/governance/session-acl/seed-roles.js +85 -0
  387. package/dist/harness/governance/session-acl/service.d.ts +136 -0
  388. package/dist/harness/governance/session-acl/service.js +407 -0
  389. package/dist/harness/governance/session-acl/types.d.ts +102 -0
  390. package/dist/harness/governance/session-acl/types.js +5 -0
  391. package/dist/harness/index.d.ts +137 -0
  392. package/dist/harness/index.js +106 -0
  393. package/dist/harness/knowledge/adapters.d.ts +68 -0
  394. package/dist/harness/knowledge/adapters.js +421 -0
  395. package/dist/harness/knowledge/catalog-index.d.ts +7 -0
  396. package/dist/harness/knowledge/catalog-index.js +7 -0
  397. package/dist/harness/knowledge/catalog-types.d.ts +33 -0
  398. package/dist/harness/knowledge/catalog-types.js +10 -0
  399. package/dist/harness/knowledge/connector-fetcher.d.ts +13 -0
  400. package/dist/harness/knowledge/connector-fetcher.js +27 -0
  401. package/dist/harness/knowledge/connectors.d.ts +55 -0
  402. package/dist/harness/knowledge/connectors.js +181 -0
  403. package/dist/harness/knowledge/db.d.ts +26 -0
  404. package/dist/harness/knowledge/db.js +235 -0
  405. package/dist/harness/knowledge/describe.d.ts +40 -0
  406. package/dist/harness/knowledge/describe.js +52 -0
  407. package/dist/harness/knowledge/fetchers.d.ts +66 -0
  408. package/dist/harness/knowledge/fetchers.js +342 -0
  409. package/dist/harness/knowledge/grounding.d.ts +98 -0
  410. package/dist/harness/knowledge/grounding.js +208 -0
  411. package/dist/harness/knowledge/hit-log.d.ts +74 -0
  412. package/dist/harness/knowledge/hit-log.js +99 -0
  413. package/dist/harness/knowledge/html.d.ts +20 -0
  414. package/dist/harness/knowledge/html.js +103 -0
  415. package/dist/harness/knowledge/index-store.d.ts +150 -0
  416. package/dist/harness/knowledge/index-store.js +394 -0
  417. package/dist/harness/knowledge/index.d.ts +38 -0
  418. package/dist/harness/knowledge/index.js +24 -0
  419. package/dist/harness/knowledge/ingest.d.ts +162 -0
  420. package/dist/harness/knowledge/ingest.js +814 -0
  421. package/dist/harness/knowledge/network-guard.d.ts +57 -0
  422. package/dist/harness/knowledge/network-guard.js +242 -0
  423. package/dist/harness/knowledge/paths.d.ts +14 -0
  424. package/dist/harness/knowledge/paths.js +17 -0
  425. package/dist/harness/knowledge/purge.d.ts +34 -0
  426. package/dist/harness/knowledge/purge.js +51 -0
  427. package/dist/harness/knowledge/retriever.d.ts +83 -0
  428. package/dist/harness/knowledge/retriever.js +184 -0
  429. package/dist/harness/knowledge/secret-scan.d.ts +11 -0
  430. package/dist/harness/knowledge/secret-scan.js +32 -0
  431. package/dist/harness/knowledge/source-store.d.ts +107 -0
  432. package/dist/harness/knowledge/source-store.js +516 -0
  433. package/dist/harness/knowledge/types.d.ts +129 -0
  434. package/dist/harness/knowledge/types.js +14 -0
  435. package/dist/harness/memory/backfill-coverage.d.ts +80 -0
  436. package/dist/harness/memory/backfill-coverage.js +146 -0
  437. package/dist/harness/memory/backfill-trigger.d.ts +83 -0
  438. package/dist/harness/memory/backfill-trigger.js +247 -0
  439. package/dist/harness/memory/cognition-types.d.ts +4 -0
  440. package/dist/harness/memory/cognition-types.js +4 -0
  441. package/dist/harness/memory/cognition.d.ts +16 -0
  442. package/dist/harness/memory/cognition.js +107 -0
  443. package/dist/harness/memory/confidence.d.ts +63 -0
  444. package/dist/harness/memory/confidence.js +157 -0
  445. package/dist/harness/memory/decay-policy.d.ts +22 -0
  446. package/dist/harness/memory/decay-policy.js +28 -0
  447. package/dist/harness/memory/gates.d.ts +39 -0
  448. package/dist/harness/memory/gates.js +176 -0
  449. package/dist/harness/memory/health-probe.d.ts +36 -0
  450. package/dist/harness/memory/health-probe.js +78 -0
  451. package/dist/harness/memory/index.d.ts +32 -0
  452. package/dist/harness/memory/index.js +26 -0
  453. package/dist/harness/memory/similarity.d.ts +33 -0
  454. package/dist/harness/memory/similarity.js +69 -0
  455. package/dist/harness/memory/sqlite/agent-db.d.ts +73 -0
  456. package/dist/harness/memory/sqlite/agent-db.js +277 -0
  457. package/dist/harness/memory/sqlite/backfill-coverage.d.ts +13 -0
  458. package/dist/harness/memory/sqlite/backfill-coverage.js +57 -0
  459. package/dist/harness/memory/sqlite/cognition-store.d.ts +34 -0
  460. package/dist/harness/memory/sqlite/cognition-store.js +188 -0
  461. package/dist/harness/memory/sqlite/embedding-from-models.d.ts +47 -0
  462. package/dist/harness/memory/sqlite/embedding-from-models.js +90 -0
  463. package/dist/harness/memory/sqlite/embedding.d.ts +93 -0
  464. package/dist/harness/memory/sqlite/embedding.js +268 -0
  465. package/dist/harness/memory/sqlite/index.d.ts +22 -0
  466. package/dist/harness/memory/sqlite/index.js +17 -0
  467. package/dist/harness/memory/sqlite/keyword-search.d.ts +37 -0
  468. package/dist/harness/memory/sqlite/keyword-search.js +113 -0
  469. package/dist/harness/memory/sqlite/knowledge-registry.d.ts +45 -0
  470. package/dist/harness/memory/sqlite/knowledge-registry.js +59 -0
  471. package/dist/harness/memory/sqlite/memory-store.d.ts +80 -0
  472. package/dist/harness/memory/sqlite/memory-store.js +548 -0
  473. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +45 -0
  474. package/dist/harness/memory/sqlite/sqlite-vec.js +159 -0
  475. package/dist/harness/memory/sqlite/vector-search.d.ts +41 -0
  476. package/dist/harness/memory/sqlite/vector-search.js +72 -0
  477. package/dist/harness/memory/sqlite/wisdom-store.d.ts +23 -0
  478. package/dist/harness/memory/sqlite/wisdom-store.js +64 -0
  479. package/dist/harness/memory/steward-policy.d.ts +122 -0
  480. package/dist/harness/memory/steward-policy.js +369 -0
  481. package/dist/harness/memory/store.d.ts +33 -0
  482. package/dist/harness/memory/store.js +173 -0
  483. package/dist/harness/memory/types.d.ts +170 -0
  484. package/dist/harness/memory/types.js +7 -0
  485. package/dist/harness/memory/wisdom-types.d.ts +4 -0
  486. package/dist/harness/memory/wisdom-types.js +4 -0
  487. package/dist/harness/observability/diagnostics/index.d.ts +5 -0
  488. package/dist/harness/observability/diagnostics/index.js +4 -0
  489. package/dist/harness/observability/diagnostics/registry.d.ts +19 -0
  490. package/dist/harness/observability/diagnostics/registry.js +74 -0
  491. package/dist/harness/observability/diagnostics/types.d.ts +42 -0
  492. package/dist/harness/observability/diagnostics/types.js +6 -0
  493. package/dist/harness/observability/observer/hub.d.ts +107 -0
  494. package/dist/harness/observability/observer/hub.js +907 -0
  495. package/dist/harness/observability/observer/index.d.ts +4 -0
  496. package/dist/harness/observability/observer/index.js +3 -0
  497. package/dist/harness/observability/observer/run-snapshot.d.ts +47 -0
  498. package/dist/harness/observability/observer/run-snapshot.js +65 -0
  499. package/dist/harness/observability/observer/types.d.ts +370 -0
  500. package/dist/harness/observability/observer/types.js +379 -0
  501. package/dist/harness/observability/run-telemetry.d.ts +51 -0
  502. package/dist/harness/observability/run-telemetry.js +28 -0
  503. package/dist/harness/run/agent/agent.d.ts +142 -0
  504. package/dist/harness/run/agent/agent.js +192 -0
  505. package/dist/harness/run/agent/index.d.ts +8 -0
  506. package/dist/harness/run/agent/index.js +7 -0
  507. package/dist/harness/run/budget/budget.d.ts +94 -0
  508. package/dist/harness/run/budget/budget.js +124 -0
  509. package/dist/harness/run/budget/index.d.ts +7 -0
  510. package/dist/harness/run/budget/index.js +6 -0
  511. package/dist/harness/run/concurrency/index.d.ts +18 -0
  512. package/dist/harness/run/concurrency/index.js +14 -0
  513. package/dist/harness/run/concurrency/provider-pool.d.ts +128 -0
  514. package/dist/harness/run/concurrency/provider-pool.js +329 -0
  515. package/dist/harness/run/concurrency/rate-limiter.d.ts +109 -0
  516. package/dist/harness/run/concurrency/rate-limiter.js +233 -0
  517. package/dist/harness/run/concurrency/session-gate.d.ts +85 -0
  518. package/dist/harness/run/concurrency/session-gate.js +176 -0
  519. package/dist/harness/run/concurrency/session-lease.d.ts +79 -0
  520. package/dist/harness/run/concurrency/session-lease.js +100 -0
  521. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +41 -0
  522. package/dist/harness/run/concurrency/tool-loop-detection-core.js +239 -0
  523. package/dist/harness/run/concurrency/tool-loop-detection.d.ts +8 -0
  524. package/dist/harness/run/concurrency/tool-loop-detection.js +7 -0
  525. package/dist/harness/run/concurrency/tool-validator.d.ts +96 -0
  526. package/dist/harness/run/concurrency/tool-validator.js +195 -0
  527. package/dist/harness/run/index.d.ts +14 -0
  528. package/dist/harness/run/index.js +14 -0
  529. package/dist/harness/run/model/index.d.ts +9 -0
  530. package/dist/harness/run/model/index.js +7 -0
  531. package/dist/harness/run/model/resolver.d.ts +111 -0
  532. package/dist/harness/run/model/resolver.js +192 -0
  533. package/dist/harness/run/model/run-scope.d.ts +43 -0
  534. package/dist/harness/run/model/run-scope.js +64 -0
  535. package/dist/harness/run/model/types.d.ts +47 -0
  536. package/dist/harness/run/model/types.js +9 -0
  537. package/dist/harness/run/reliability/circuit-breaker.d.ts +87 -0
  538. package/dist/harness/run/reliability/circuit-breaker.js +130 -0
  539. package/dist/harness/run/reliability/fallback-provider.d.ts +40 -0
  540. package/dist/harness/run/reliability/fallback-provider.js +118 -0
  541. package/dist/harness/run/reliability/harness-events.d.ts +109 -0
  542. package/dist/harness/run/reliability/harness-events.js +7 -0
  543. package/dist/harness/run/reliability/index.d.ts +12 -0
  544. package/dist/harness/run/reliability/index.js +7 -0
  545. package/dist/harness/run/reliability/model-binding.d.ts +22 -0
  546. package/dist/harness/run/reliability/model-binding.js +27 -0
  547. package/dist/harness/run/reliability/provider-wrapper.d.ts +26 -0
  548. package/dist/harness/run/reliability/provider-wrapper.js +61 -0
  549. package/dist/harness/run/reliability/run-agent.d.ts +86 -0
  550. package/dist/harness/run/reliability/run-agent.js +932 -0
  551. package/dist/harness/run/reliability/run-metrics-collector.d.ts +80 -0
  552. package/dist/harness/run/reliability/run-metrics-collector.js +194 -0
  553. package/dist/harness/run/reliability/run-model-context.d.ts +19 -0
  554. package/dist/harness/run/reliability/run-model-context.js +32 -0
  555. package/dist/harness/run/run-guard/default-run-guard.d.ts +75 -0
  556. package/dist/harness/run/run-guard/default-run-guard.js +347 -0
  557. package/dist/harness/run/run-guard/index.d.ts +9 -0
  558. package/dist/harness/run/run-guard/index.js +8 -0
  559. package/dist/harness/run/run-scope.d.ts +81 -0
  560. package/dist/harness/run/run-scope.js +58 -0
  561. package/dist/harness/run/runner.d.ts +362 -0
  562. package/dist/harness/run/runner.js +1290 -0
  563. package/dist/harness/session/attachments/extract.d.ts +35 -0
  564. package/dist/harness/session/attachments/extract.js +72 -0
  565. package/dist/harness/session/attachments/index.d.ts +11 -0
  566. package/dist/harness/session/attachments/index.js +11 -0
  567. package/dist/harness/session/attachments/inject.d.ts +71 -0
  568. package/dist/harness/session/attachments/inject.js +142 -0
  569. package/dist/harness/session/attachments/intent.d.ts +32 -0
  570. package/dist/harness/session/attachments/intent.js +69 -0
  571. package/dist/harness/session/attachments/llm-intent.d.ts +17 -0
  572. package/dist/harness/session/attachments/llm-intent.js +74 -0
  573. package/dist/harness/session/attachments/paths.d.ts +15 -0
  574. package/dist/harness/session/attachments/paths.js +18 -0
  575. package/dist/harness/session/attachments/sanitize.d.ts +23 -0
  576. package/dist/harness/session/attachments/sanitize.js +55 -0
  577. package/dist/harness/session/attachments/service.d.ts +105 -0
  578. package/dist/harness/session/attachments/service.js +320 -0
  579. package/dist/harness/session/attachments/types.d.ts +64 -0
  580. package/dist/harness/session/attachments/types.js +17 -0
  581. package/dist/harness/session/compact.d.ts +23 -0
  582. package/dist/harness/session/compact.js +53 -0
  583. package/dist/harness/session/history/index.d.ts +4 -0
  584. package/dist/harness/session/history/index.js +3 -0
  585. package/dist/harness/session/history/port.d.ts +51 -0
  586. package/dist/harness/session/history/port.js +480 -0
  587. package/dist/harness/session/history/score.d.ts +71 -0
  588. package/dist/harness/session/history/score.js +225 -0
  589. package/dist/harness/session/history/types.d.ts +157 -0
  590. package/dist/harness/session/history/types.js +29 -0
  591. package/dist/harness/session/in-memory-store.d.ts +21 -0
  592. package/dist/harness/session/in-memory-store.js +48 -0
  593. package/dist/harness/session/index.d.ts +12 -0
  594. package/dist/harness/session/index.js +12 -0
  595. package/dist/harness/session/state-machine.d.ts +18 -0
  596. package/dist/harness/session/state-machine.js +31 -0
  597. package/dist/harness/session/tasks/index.d.ts +11 -0
  598. package/dist/harness/session/tasks/index.js +9 -0
  599. package/dist/harness/session/tasks/render.d.ts +12 -0
  600. package/dist/harness/session/tasks/render.js +57 -0
  601. package/dist/harness/session/tasks/service.d.ts +69 -0
  602. package/dist/harness/session/tasks/service.js +327 -0
  603. package/dist/harness/session/tasks/tools.d.ts +17 -0
  604. package/dist/harness/session/tasks/tools.js +210 -0
  605. package/dist/harness/session/tasks/types.d.ts +29 -0
  606. package/dist/harness/session/tasks/types.js +11 -0
  607. package/dist/harness/session/types.d.ts +88 -0
  608. package/dist/harness/session/types.js +7 -0
  609. package/dist/harness/shared/events/agent-event-map.d.ts +264 -0
  610. package/dist/harness/shared/events/agent-event-map.js +51 -0
  611. package/dist/harness/shared/events/index.d.ts +6 -0
  612. package/dist/harness/shared/events/index.js +4 -0
  613. package/dist/harness/shared/events/scenario-events.d.ts +96 -0
  614. package/dist/harness/shared/events/scenario-events.js +7 -0
  615. package/dist/harness/shared/types/agent-definition.d.ts +51 -0
  616. package/dist/harness/shared/types/agent-definition.js +8 -0
  617. package/dist/harness/shared/types/hook-context.d.ts +10 -0
  618. package/dist/harness/shared/types/hook-context.js +6 -0
  619. package/dist/harness/shared/types/index.d.ts +7 -0
  620. package/dist/harness/shared/types/index.js +4 -0
  621. package/dist/harness/shared/types/queue-mode.d.ts +4 -0
  622. package/dist/harness/shared/types/queue-mode.js +1 -0
  623. package/dist/harness/shared/types/thinking-level.d.ts +4 -0
  624. package/dist/harness/shared/types/thinking-level.js +1 -0
  625. package/dist/index.d.ts +117 -0
  626. package/dist/index.js +80 -0
  627. package/dist/integration/agent-runtime/channel-message-source.d.ts +27 -0
  628. package/dist/integration/agent-runtime/channel-message-source.js +58 -0
  629. package/dist/integration/agent-runtime/file-watch-source.d.ts +31 -0
  630. package/dist/integration/agent-runtime/file-watch-source.js +63 -0
  631. package/dist/integration/agent-runtime/index.d.ts +6 -0
  632. package/dist/integration/agent-runtime/index.js +3 -0
  633. package/dist/integration/agent-runtime/webhook-source.d.ts +39 -0
  634. package/dist/integration/agent-runtime/webhook-source.js +112 -0
  635. package/dist/integration/index.d.ts +23 -0
  636. package/dist/integration/index.js +23 -0
  637. package/dist/integration/mcp/index.d.ts +6 -0
  638. package/dist/integration/mcp/index.js +6 -0
  639. package/dist/integration/mcp/sdk-client.d.ts +39 -0
  640. package/dist/integration/mcp/sdk-client.js +157 -0
  641. package/dist/integration/observability/exporters.d.ts +111 -0
  642. package/dist/integration/observability/exporters.js +167 -0
  643. package/dist/integration/observability/index.d.ts +21 -0
  644. package/dist/integration/observability/index.js +16 -0
  645. package/dist/integration/observability/log-observer.d.ts +12 -0
  646. package/dist/integration/observability/log-observer.js +59 -0
  647. package/dist/integration/observability/metrics.d.ts +116 -0
  648. package/dist/integration/observability/metrics.js +237 -0
  649. package/dist/integration/observability/noop-observer.d.ts +12 -0
  650. package/dist/integration/observability/noop-observer.js +22 -0
  651. package/dist/integration/observability/observer-bridge.d.ts +56 -0
  652. package/dist/integration/observability/observer-bridge.js +195 -0
  653. package/dist/integration/observability/run-telemetry.d.ts +28 -0
  654. package/dist/integration/observability/run-telemetry.js +83 -0
  655. package/dist/integration/observability/trace-collector.d.ts +124 -0
  656. package/dist/integration/observability/trace-collector.js +253 -0
  657. package/dist/integration/observability/trace-events.d.ts +69 -0
  658. package/dist/integration/observability/trace-events.js +83 -0
  659. package/dist/integration/observability/trace-logger.d.ts +110 -0
  660. package/dist/integration/observability/trace-logger.js +219 -0
  661. package/dist/integration/providers/anthropic.d.ts +92 -0
  662. package/dist/integration/providers/anthropic.js +432 -0
  663. package/dist/integration/providers/index.d.ts +4 -0
  664. package/dist/integration/providers/index.js +2 -0
  665. package/dist/integration/providers/openai.d.ts +120 -0
  666. package/dist/integration/providers/openai.js +429 -0
  667. package/dist/integration/providers/usage.d.ts +20 -0
  668. package/dist/integration/providers/usage.js +69 -0
  669. package/dist/integration/storage/archive-manager.d.ts +79 -0
  670. package/dist/integration/storage/archive-manager.js +223 -0
  671. package/dist/integration/storage/jsonl.d.ts +51 -0
  672. package/dist/integration/storage/jsonl.js +246 -0
  673. package/dist/integration/storage/memory.d.ts +7 -0
  674. package/dist/integration/storage/memory.js +7 -0
  675. package/dist/integration/storage/session-index.d.ts +57 -0
  676. package/dist/integration/storage/session-index.js +379 -0
  677. package/dist/integration/web-search/brave.d.ts +13 -0
  678. package/dist/integration/web-search/brave.js +64 -0
  679. package/dist/integration/web-search/duckduckgo.d.ts +12 -0
  680. package/dist/integration/web-search/duckduckgo.js +102 -0
  681. package/dist/integration/web-search/factory.d.ts +91 -0
  682. package/dist/integration/web-search/factory.js +166 -0
  683. package/dist/integration/web-search/http.d.ts +22 -0
  684. package/dist/integration/web-search/http.js +94 -0
  685. package/dist/integration/web-search/index.d.ts +16 -0
  686. package/dist/integration/web-search/index.js +9 -0
  687. package/dist/integration/web-search/mimo.d.ts +57 -0
  688. package/dist/integration/web-search/mimo.js +226 -0
  689. package/dist/integration/web-search/serper.d.ts +13 -0
  690. package/dist/integration/web-search/serper.js +59 -0
  691. package/dist/integration/web-search/tavily.d.ts +16 -0
  692. package/dist/integration/web-search/tavily.js +56 -0
  693. package/dist/paths.d.ts +14 -0
  694. package/dist/paths.js +22 -0
  695. package/dist/subsystems/memory-steward/backfill/SUBSYSTEM.md +30 -0
  696. package/dist/subsystems/memory-steward/backfill/config.yaml +51 -0
  697. package/dist/subsystems/memory-steward/backfill/handler.d.ts +18 -0
  698. package/dist/subsystems/memory-steward/backfill/handler.js +343 -0
  699. package/dist/subsystems/memory-steward/govern/SUBSYSTEM.md +12 -0
  700. package/dist/subsystems/memory-steward/govern/config.yaml +65 -0
  701. package/dist/subsystems/memory-steward/govern/handler.d.ts +19 -0
  702. package/dist/subsystems/memory-steward/govern/handler.js +79 -0
  703. package/dist/subsystems/safety-guard/SUBSYSTEM.md +60 -0
  704. package/dist/subsystems/safety-guard/config.yaml +40 -0
  705. package/package.json +110 -0
@@ -0,0 +1,840 @@
1
+ /**
2
+ * Engine config types + factories (arch/npm-package-split.md §10.3).
3
+ * IO (loadConfig) and gateway mapping stay in the root package.
4
+ */
5
+ import type { ToolPolicy } from '@octopi-agent/core/types.js';
6
+ import type { ModelConfig as _ModelConfig } from './harness/shared/types/agent-definition.js';
7
+ import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
8
+ import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
9
+ /** 产品默认上下文窗口(与 core/types/model-info 一致,未声明能力时按此预算) */
10
+ export { DEFAULT_CONTEXT_WINDOW };
11
+ /**
12
+ * Agent 配置
13
+ *
14
+ * persona 字段支持两种形式:
15
+ * - string: persona 目录路径(文件式 persona)
16
+ * - object: 内联 persona 定义(向后兼容 v0.1.x)
17
+ */
18
+ export interface AgentConfig {
19
+ /** Agent 唯一标识 */
20
+ id: string;
21
+ /** Agent home 目录:persona、skills 的根目录(session 在 OCTOPI_HOME/sessions;memory/wisdom 走 AgentDatabase SQLite) */
22
+ home?: string;
23
+ /** 沙箱工作目录:agent 工具操作的 cwd,默认为 home 下的 workspace 子目录 */
24
+ workspace?: string;
25
+ /**
26
+ * Persona 配置(向后兼容:string 形式等价于 home)
27
+ * - string: persona 目录路径(已废弃,请使用 home)
28
+ * - object: 内联 persona 定义
29
+ */
30
+ persona?: string | {
31
+ name?: string;
32
+ description?: string;
33
+ systemPrompt: string;
34
+ };
35
+ /**
36
+ * 模型配置
37
+ *
38
+ * 两种形式:
39
+ * - string: 引用 models[] 中的 id,或 "provider/model" 格式
40
+ * - object: 内联模型配置(向后兼容)
41
+ */
42
+ model: string | _ModelConfig;
43
+ /** 工具策略 */
44
+ tools?: ToolPolicy;
45
+ /** Skill 目录 */
46
+ skillDirectory?: string;
47
+ /** 启用的 Skill 列表 */
48
+ skills?: string[];
49
+ /** Channel 绑定 */
50
+ channelBindings?: Record<string, string>;
51
+ /** Session ACL 天花板(E6 L1) */
52
+ maxSessionRights?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionRights;
53
+ /** Knowledge 召回姿态(覆盖全局 knowledge.recall;见 arch/knowledge-layer.md) */
54
+ knowledge?: {
55
+ recall?: KnowledgeRecallMode;
56
+ };
57
+ }
58
+ /**
59
+ * Knowledge 内容召回模式
60
+ * - off:只 catalog;深度走 knowledge_search/read
61
+ * - hint:只提示「有相关材料」,不自动注入正文
62
+ * - hybrid:高分 inject + 中分 hint(引擎缺省)
63
+ * - inject:更积极自动注入(嵌入式/文档问答)
64
+ */
65
+ export type KnowledgeRecallMode = 'off' | 'hint' | 'hybrid' | 'inject';
66
+ /** Knowledge 全局配置(agents[].knowledge 覆盖 recall 等) */
67
+ export interface KnowledgeRuntimeConfig {
68
+ recall?: KnowledgeRecallMode;
69
+ autoInject?: {
70
+ minScore?: number;
71
+ maxChunks?: number;
72
+ budgetTokens?: number;
73
+ budgetRatio?: number;
74
+ maxBudgetTokens?: number;
75
+ minCoverage?: number;
76
+ };
77
+ hint?: {
78
+ minScore?: number;
79
+ };
80
+ /** hybrid 融合 keyword 权重(默认 0.45) */
81
+ keywordWeight?: number;
82
+ catalog?: {
83
+ maxEntries?: number;
84
+ showProgress?: 'off' | 'bucket' | 'exact';
85
+ autoDescribe?: boolean;
86
+ groupByScope?: boolean;
87
+ };
88
+ query?: {
89
+ includePriorUserTurns?: number;
90
+ skipIfUserTokensBelow?: number;
91
+ };
92
+ index?: {
93
+ embedding?: boolean;
94
+ hybridKeyword?: boolean;
95
+ phaseA?: {
96
+ concurrency?: number;
97
+ debounceMs?: number;
98
+ };
99
+ phaseB?: {
100
+ embedBatch?: number;
101
+ concurrency?: number;
102
+ ratePerMin?: number;
103
+ };
104
+ queue?: {
105
+ maxDepth?: number;
106
+ };
107
+ };
108
+ load?: {
109
+ parseConcurrency?: number;
110
+ diskWatermarkAlert?: boolean;
111
+ };
112
+ promotion?: {
113
+ metrics?: {
114
+ minSessions?: number;
115
+ minHits?: number;
116
+ };
117
+ stewardOnConverge?: boolean;
118
+ };
119
+ /** 会话附件(OP-15) */
120
+ attachments?: {
121
+ maxFiles?: number;
122
+ maxFileBytes?: number;
123
+ maxTotalBytes?: number;
124
+ allowedExtensions?: string[];
125
+ parse?: {
126
+ extract?: boolean;
127
+ keywordIndex?: boolean;
128
+ embedding?: 'off' | 'lazy' | 'on-upload';
129
+ };
130
+ inject?: {
131
+ fullTextMaxChars?: number;
132
+ recallTopK?: number;
133
+ inventory?: boolean;
134
+ intent?: 'llm' | 'off';
135
+ intentTimeoutMs?: number;
136
+ emptyMessagePrompt?: string;
137
+ };
138
+ tools?: {
139
+ attachmentsRootReadOnly?: boolean;
140
+ };
141
+ };
142
+ }
143
+ /** 单个 web search provider slot */
144
+ export interface WebSearchProviderSlot {
145
+ /** 实现类型 */
146
+ api: 'duckduckgo' | 'tavily' | 'brave' | 'serper' | 'mimo';
147
+ /** API Key(支持 ${ENV_VAR};duckduckgo 可省略) */
148
+ apiKey?: string;
149
+ /** 覆盖默认 baseUrl */
150
+ baseUrl?: string;
151
+ /** 覆盖默认超时(毫秒) */
152
+ timeoutMs?: number;
153
+ /** MiMo 专用:模型 ID(默认 mimo-v2.5-pro) */
154
+ model?: string;
155
+ /** MiMo 专用:搜索关键词数上限(max_keyword,默认 3) */
156
+ maxKeyword?: number;
157
+ /** MiMo 专用:是否强制搜索(force_search,默认 true) */
158
+ forceSearch?: boolean;
159
+ /** MiMo 专用:用户位置(approximate) */
160
+ userLocation?: {
161
+ country?: string;
162
+ region?: string;
163
+ city?: string;
164
+ };
165
+ }
166
+ /** web_search 工具顶层配置 */
167
+ export interface WebSearchToolConfig {
168
+ /** 主 provider(providers 的 key);未指定时取 providers 第一个 */
169
+ provider?: string;
170
+ /** 失败降级链(provider key 列表) */
171
+ fallbacks?: string[];
172
+ /** 默认返回条数(默认 5) */
173
+ defaultLimit?: number;
174
+ /** 全局超时(毫秒,默认 15000) */
175
+ timeoutMs?: number;
176
+ /** provider 映射 */
177
+ providers?: Record<string, WebSearchProviderSlot>;
178
+ }
179
+ /**
180
+ * Session 配置(合并了旧的 store + session 节点)
181
+ */
182
+ export interface SessionConfig {
183
+ /** DM 作用域: main / per-peer / per-channel-peer */
184
+ dmScope?: 'main' | 'per-peer' | 'per-channel-peer';
185
+ }
186
+ /**
187
+ * Plugin 配置
188
+ */
189
+ export interface PluginConfig {
190
+ /** Plugin 目录扫描路径 */
191
+ loadPaths?: string[];
192
+ /** 单个 plugin 的配置(plugin id → config) */
193
+ configs?: Record<string, Record<string, unknown>>;
194
+ }
195
+ /**
196
+ * 监听 host 配置值
197
+ *
198
+ * - `local`(默认):仅本机访问
199
+ * - `lan`:局域网访问(绑定全部网卡)
200
+ * - 具体 IP / 主机名:绑定该地址
201
+ */
202
+ export type NetworkHostConfig = 'local' | 'lan' | (string & {});
203
+ /**
204
+ * 将 host 配置解析为 HTTP listen 地址
205
+ *
206
+ * @param host - 配置值(`local` / `lan` / IP / 主机名)
207
+ * @returns listen 用的 host 字符串
208
+ */
209
+ export declare function resolveListenHost(host?: NetworkHostConfig): string;
210
+ /**
211
+ * 将 host 配置解析为 Vite `--host` 参数
212
+ *
213
+ * @param host - 配置值(`local` / `lan` / IP / 主机名)
214
+ * @returns 传给 Vite 的 host 参数
215
+ */
216
+ export declare function resolveViteHostArg(host?: NetworkHostConfig): string;
217
+ /**
218
+ * 判断 host 配置是否对局域网开放
219
+ *
220
+ * @param host - 配置值
221
+ * @returns 是否非仅本机
222
+ */
223
+ export declare function isLanHost(host?: NetworkHostConfig): boolean;
224
+ /**
225
+ * Channel 配置
226
+ */
227
+ export interface ChannelConfig {
228
+ /** 类型(http) */
229
+ type: string;
230
+ /** 端口(HTTP channel 用) */
231
+ port?: number;
232
+ /**
233
+ * 监听 host(HTTP channel 用)
234
+ *
235
+ * `local`(默认,仅本机)| `lan`(局域网)| 具体 IP/主机名
236
+ */
237
+ host?: NetworkHostConfig;
238
+ /** 路径(HTTP channel 用) */
239
+ path?: string;
240
+ /** API Key(HTTP channel 认证) */
241
+ apiKey?: string;
242
+ /** 允许的 CORS 源 */
243
+ corsOrigins?: string[];
244
+ }
245
+ /**
246
+ * BudgetPolicyJsonConfig — octopi.json 中的 budgetPolicy 字段
247
+ *
248
+ * 见 arch/budget-redesign.md:
249
+ * - 默认 **无** nominal token hard(Σ nominalTotalTokens 不作为出厂熔断)
250
+ * - P0:仅 wall-clock 安全阀 + 可显式 iteration/tool 上限
251
+ * - P2:控制梯配置(wrap-up 策略)
252
+ * - P3:扩展 usd / uncached 等 opt-in 单位;键名仅 budgetPolicy(无 budget)
253
+ */
254
+ export interface BudgetPolicyJsonConfig {
255
+ /** 安全阀:最大运行时间毫秒(默认 6h) */
256
+ maxWallClockMs?: number;
257
+ /** 最大迭代次数。仅显式设置时硬停 */
258
+ maxIterations?: number;
259
+ /** 最大工具调用次数。仅显式设置时硬停 */
260
+ maxToolCalls?: number;
261
+ /** Policy 触达时的行为:'stop' 立即停止 | 'wrap_up_then_stop' 先总结再停止(默认) */
262
+ onPolicyHit?: 'stop' | 'wrap_up_then_stop';
263
+ /** wrap-up 窗口的轮次数(默认 3) */
264
+ wrapUpTurns?: number;
265
+ /** context 轴 wrap-up 触发阈值比例(默认 0.85) */
266
+ contextWrapUpRatio?: number;
267
+ /** 预算单位配置(仅显式配置才启用 hard) */
268
+ units?: {
269
+ /** 最大花费(币种由 pricing 决定) */
270
+ maxCost?: number;
271
+ /** 最大 uncached input tokens */
272
+ maxUncachedInputTokens?: number;
273
+ /** 最大 output tokens */
274
+ maxOutputTokens?: number;
275
+ /** 最大 LLM 调用次数 */
276
+ maxLlmCalls?: number;
277
+ };
278
+ /** 模型定价(用于 cost 估算,币种自定义) */
279
+ pricing?: Record<string, {
280
+ /** 每 1M input tokens 价格 */
281
+ inputPer1M: number;
282
+ /** 每 1M cached input tokens 价格(可选) */
283
+ cachedInputPer1M?: number;
284
+ /** 每 1M output tokens 价格 */
285
+ outputPer1M: number;
286
+ }>;
287
+ /** advisory 告警配置 */
288
+ advisory?: {
289
+ /** 告警单位 */
290
+ unit: 'wall_clock_ms' | 'cost' | 'uncached_input_tokens' | 'output_tokens' | 'llm_calls';
291
+ /** 告警阈值 */
292
+ threshold: number;
293
+ };
294
+ }
295
+ /**
296
+ * RunGuardJsonConfig — octopi.json 中的 runGuard 字段形状
297
+ *
298
+ * 过程监督,与 budget 组合:Budget 管资源,RunGuard 管行为是否跑飞。
299
+ * 通过检查点机制实现:每 N 轮迭代审查一次,决定继续/恢复/终止。
300
+ *
301
+ * 注意:与 harness/run/run-guard 的 `RunGuardConfig`(实现配置)同结构但不同名,
302
+ * 避免调用方 import 错模块。
303
+ */
304
+ export interface RunGuardJsonConfig {
305
+ /** 是否启用(默认 true) */
306
+ enabled?: boolean;
307
+ /** 基础检查间隔(迭代数,默认 15) */
308
+ checkpointInterval?: number;
309
+ /** 最小检查间隔(默认 5) */
310
+ minCheckpointInterval?: number;
311
+ /** 最大检查间隔(默认 50) */
312
+ maxCheckpointInterval?: number;
313
+ /** 启用 LLM 审查(默认 true) */
314
+ enableLLMReview?: boolean;
315
+ /** LLM 审查频率(每 N 个检查点审查一次,默认 3) */
316
+ llmReviewInterval?: number;
317
+ /**
318
+ * 审查用的模型
319
+ *
320
+ * 支持两种格式:
321
+ * - 模型名(如 "qwen-turbo"):使用主 provider
322
+ * - 完整名(如 "ollama/qwen3:4b"):使用指定 provider
323
+ */
324
+ llmModel?: string;
325
+ /** 硬上限:最大迭代数(默认 1000) */
326
+ hardLimit?: number;
327
+ /** 硬上限:最大 wall-clock 时间(毫秒,默认 10 小时) */
328
+ hardWallClockMs?: number;
329
+ }
330
+ /**
331
+ * AgentRuntimeJsonConfig — long-lived 激活宿主(arch/agent-runtime.md)
332
+ *
333
+ * 消息路径始终经 Runtime dispatch。
334
+ * Schedule/Escalate 等 Source:**配置块存在才挂载**;不要则不写该块(无 enabled 总开关)。
335
+ */
336
+ export interface AgentRuntimeJsonConfig {
337
+ /** 默认合批窗口 ms(建议 300–500) */
338
+ coalesceWindowMs?: number;
339
+ /** 合批缓冲条目上限(防事件风暴) */
340
+ coalesceBufferLimit?: number;
341
+ /** 期望最大并发 Run(仅观测/告警;硬闸归 SessionGate) */
342
+ expectedMaxConcurrentRuns?: number;
343
+ /** 定时触发;每条 job 绑定 agentId */
344
+ schedule?: Array<{
345
+ agentId: string;
346
+ sessionId?: string;
347
+ /** 与 cron 二选一 */
348
+ intervalMs?: number;
349
+ /** 简化 cron:分 时 日 月 周;非法表达式跳过 */
350
+ cron?: string;
351
+ /** 注入内容(system note) */
352
+ content: string;
353
+ coalesceKey?: string;
354
+ runOnStart?: boolean;
355
+ }>;
356
+ /**
357
+ * 子系统 escalate → 唤醒主 Agent。
358
+ * 需与 Subsystem 使用同一 EventBus(Gateway 已接 gatewayBus)。
359
+ */
360
+ escalate?: {
361
+ /** 事件缺 agentId 时的默认目标 */
362
+ defaultAgentId?: string;
363
+ /** 默认同时订 subsystem.signal.escalate 与 subsystem.escalate */
364
+ eventType?: string | string[];
365
+ };
366
+ /** 订阅 runtime.agent_signal(多 Agent 通知);默认随 escalate 一起挂 */
367
+ agentSignal?: boolean;
368
+ }
369
+ /**
370
+ * 上下文引擎配置
371
+ *
372
+ * 控制上下文管理行为:消息选择、压缩策略、预算分配。
373
+ */
374
+ export interface ContextEngineConfig {
375
+ /** 引擎类型(默认 'default') */
376
+ type?: 'default' | 'custom';
377
+ /** 头部保护消息数(默认 3) */
378
+ protectFirstN?: number;
379
+ /** 尾部保护消息数(默认 20) */
380
+ protectLastN?: number;
381
+ /** 触发压缩的阈值比例(默认 0.5) */
382
+ compactThreshold?: number;
383
+ /**
384
+ * 主动摘要阈值:消息 token / messagesBudget 超过该比例时,
385
+ * 在硬溢出前先 LLM 摘要(默认 0.6;0 = 关闭)
386
+ */
387
+ proactiveCompactRatio?: number;
388
+ /**
389
+ * 主动 LLM 摘要冷却 ms(默认 30000;0 = 不冷却)。
390
+ * 冷却期内优先缓存重建,降低单 turn 双摘要。
391
+ */
392
+ proactiveCooldownMs?: number;
393
+ /** 输出预留比例(默认 0.20) */
394
+ outputRatio?: number;
395
+ /** 输出预留最小值(默认 2000) */
396
+ minOutputReserve?: number;
397
+ /** 输出预留最大值(默认 8000) */
398
+ maxOutputReserve?: number;
399
+ /** 是否启用 LLM 摘要(默认 true) */
400
+ enableLLMSummary?: boolean;
401
+ /** 摘要模型(可选,使用主模型) */
402
+ summaryModel?: string;
403
+ }
404
+ /**
405
+ * 公用能力 summary 配置(harness/context/capabilities)
406
+ */
407
+ export interface SummaryCapabilityConfig {
408
+ /** 模型档名;缺省解析链使用 summary */
409
+ modelLevel?: string;
410
+ /** 显式 provider/model */
411
+ model?: string;
412
+ defaultInputBudgetTokens?: number;
413
+ safetyMarginTokens?: number;
414
+ oversizedStrategy?: 'map_reduce' | 'window' | 'truncate_fallback' | 'fail';
415
+ gate?: {
416
+ minTokens?: number;
417
+ minBytes?: number;
418
+ respectPolicyBudget?: boolean;
419
+ };
420
+ /** policy id → 整策略对象(全量替换) */
421
+ policies?: Record<string, unknown>;
422
+ tools?: {
423
+ maxReturnChars?: number;
424
+ http_request?: Record<string, unknown>;
425
+ file_read?: Record<string, unknown>;
426
+ } & Record<string, unknown>;
427
+ cache?: {
428
+ enabled?: boolean;
429
+ backend?: 'memory' | 'file';
430
+ ttlMs?: number;
431
+ maxEntries?: number;
432
+ dir?: string;
433
+ };
434
+ }
435
+ /**
436
+ * 公用能力 compact 缺省配置
437
+ */
438
+ export interface CompactCapabilityConfig {
439
+ defaultProtectHead?: number;
440
+ defaultProtectTail?: number;
441
+ defaultTargetTokens?: number;
442
+ defaultMode?: 'structure_only' | 'summary_only' | 'head_tail_only' | 'auto';
443
+ }
444
+ /**
445
+ * system prompt 层装配器配置(七层 ContextAssembler)
446
+ *
447
+ * 与 contextEngine 分工:本配置管 **system 总预算与可选单层硬顶**;
448
+ * contextEngine 管 **消息窗口压缩**。
449
+ *
450
+ * 预算语义:默认只控 system 总量 + priority 竞争;
451
+ * `layerShares` 仅对显式配置的层生效(硬顶 = contentBudget × share)。
452
+ */
453
+ export interface ContextAssemblerConfig {
454
+ /** system 预算占 contextWindow 比例(默认 0.22);窗口未知时不生效 */
455
+ systemBudgetRatio?: number;
456
+ /** 显式 system 预算 token(窗口未知时仍可用,优先于 ratio) */
457
+ systemBudgetTokens?: number;
458
+ /** 显式压缩目标 token;窗口未知时用于结构压缩/assemble 预算 */
459
+ compactTargetTokens?: number;
460
+ /**
461
+ * 单层硬顶:层 id → contentBudget 比例 [0,1]。
462
+ * 默认不配置 = 无单层配额。配置了的层超出会先被截断到硬顶。
463
+ */
464
+ layerShares?: Partial<Record<'wisdom' | 'persona' | 'skill' | 'knowledge' | 'cognition' | 'memory' | 'runtime', number>>;
465
+ /**
466
+ * 是否在 AssembleManifest.layers[].preview 写入层正文截断(默认 true)
467
+ * 开启后 Web「上下文」面板可展示层预览;正文不进入模型输入。
468
+ */
469
+ includeLayerPreview?: boolean;
470
+ /** preview 最大字符数(默认 400) */
471
+ layerPreviewChars?: number;
472
+ /**
473
+ * 是否在 AssembleManifest.layers[].content 写入层正文全文(默认 true)
474
+ * 点选层时 Web 展示具体内容。
475
+ */
476
+ includeLayerContent?: boolean;
477
+ }
478
+ /** 全局运行宪法配置 */
479
+ export interface ConstitutionConfig {
480
+ mode: 'product' | 'custom' | 'off';
481
+ /** custom 模式必填 */
482
+ path?: string | null;
483
+ }
484
+ /**
485
+ * 集中模型定义
486
+ *
487
+ * 在 models[] 中集中定义,agent 通过 id 或 "provider/model" 引用。
488
+ * 避免多 agent 使用同一模型时重复配置。
489
+ */
490
+ export interface ModelDefinition {
491
+ /** 模型唯一标识(可选,默认为 "provider/model") */
492
+ id?: string;
493
+ /** Provider 名称(引用 providers[].name) */
494
+ provider: string;
495
+ /** 模型名称 */
496
+ model: string;
497
+ /** 温度 */
498
+ temperature?: number;
499
+ /** 最大 token 数 */
500
+ maxTokens?: number;
501
+ /** 上下文窗口大小 */
502
+ contextWindow?: number;
503
+ /** 失败时的备选模型(支持 string 引用或内联配置) */
504
+ fallbackModels?: (string | ModelDefinition)[];
505
+ }
506
+ /**
507
+ * 全局默认值
508
+ */
509
+ export interface Defaults {
510
+ /**
511
+ * 默认上下文窗口(仅当用户显式配置时生效)。
512
+ * 未配置时模型 contextWindow 保持未知,不自动填 200k。
513
+ */
514
+ contextWindow?: number;
515
+ }
516
+ /** 模型输入类型 */
517
+ export type ModelInputType = 'text' | 'image' | 'audio' | 'video';
518
+ /** 单个模型能力定义(models.providers[].models[] 中的元素) */
519
+ export interface ModelCapability {
520
+ /** 模型 ID(provider 内唯一,如 "mimo-v2.5-pro") */
521
+ id: string;
522
+ /** 模型名称(实际发送给 API 的名称,默认等于 id) */
523
+ name?: string;
524
+ /** 是否支持推理/思考模式 */
525
+ reasoning?: boolean;
526
+ /** 支持的输入类型 */
527
+ input?: ModelInputType[];
528
+ /** 上下文窗口大小 */
529
+ contextWindow?: number;
530
+ /** 最大输出 token 数 */
531
+ maxTokens?: number;
532
+ }
533
+ /** Provider 定义(新格式,嵌入在 models.providers 中) */
534
+ export interface ModelProviderConfig {
535
+ /** API 基础 URL */
536
+ baseUrl: string;
537
+ /** API Key(支持 ${ENV_VAR} 语法) */
538
+ apiKey: string;
539
+ /** API 协议类型 */
540
+ api: 'openai-completions' | 'anthropic-messages';
541
+ /** 此 provider 下的模型列表 */
542
+ models: ModelCapability[];
543
+ /** 请求超时(秒) */
544
+ timeoutSeconds?: number;
545
+ }
546
+ /** 模型级别定义(primary + fallback 降级链) */
547
+ export interface LevelConfig {
548
+ /** 主模型,格式: provider/model */
549
+ primary: string;
550
+ /** 降级模型列表(按优先级排列,格式: provider/model) */
551
+ fallback?: string[];
552
+ }
553
+ /** 模型级别映射表(级别名 → 级别定义) */
554
+ export type LevelMap = Record<string, LevelConfig>;
555
+ /** Embedding API 协议 */
556
+ export type EmbeddingApiType = 'openai' | 'ollama' | 'http' | 'custom';
557
+ /** 向量检索引擎 */
558
+ export type VectorEngineChoice = 'auto' | 'js' | 'sqlite-vec';
559
+ /** HTTP 请求/响应字段映射(通用远程 embedding) */
560
+ export interface EmbeddingHttpMappingConfig {
561
+ inputField?: string;
562
+ modelField?: string;
563
+ embeddingsPath?: string;
564
+ itemEmbeddingPath?: string;
565
+ extraBody?: Record<string, unknown>;
566
+ }
567
+ /**
568
+ * Embedding 模型配置(models.embedding)
569
+ *
570
+ * 放在 models 节点下:memory / knowledge / plugin 等可共用同一 embedding。
571
+ * 未配置时检索退化为关键词路径。
572
+ *
573
+ * 鉴权:apiKey 可省略或 ""(不发 Authorization),适合内网/无鉴权远程。
574
+ * provider 仅在 apiKey 未写出时继承其凭据。
575
+ */
576
+ export interface EmbeddingModelConfig {
577
+ /** 显式关闭;缺省视为开启(仅当节点存在时才启用向量) */
578
+ enabled?: boolean;
579
+ /** 嵌入 API 协议;缺省按 provider/baseUrl 推断(openai 兼容) */
580
+ type?: EmbeddingApiType;
581
+ /** 引用 models.providers 的 key,继承 baseUrl;apiKey 仅在未写出时继承 */
582
+ provider?: string;
583
+ /** 模型名 */
584
+ model: string;
585
+ baseUrl?: string;
586
+ /** API Key;"" 或省略且未继承 = 不发送鉴权头 */
587
+ apiKey?: string;
588
+ /** Key 所在 Header;默认 Authorization。"" = 不发送 */
589
+ apiKeyHeader?: string;
590
+ /** Key 前缀;Authorization 默认 "Bearer " */
591
+ apiKeyPrefix?: string;
592
+ /** 请求 path;openai 默认 /embeddings,ollama 默认 /api/embeddings */
593
+ path?: string;
594
+ /** 额外请求头 */
595
+ headers?: Record<string, string>;
596
+ /** 通用 HTTP 字段映射 */
597
+ request?: EmbeddingHttpMappingConfig;
598
+ /** 是否支持批量(仅单条接口时设 false) */
599
+ supportsBatch?: boolean;
600
+ /** 单次批量上限(百炼 qwen3.7-text-embedding=20;超出自动切片) */
601
+ maxBatchSize?: number;
602
+ /** 请求超时 ms */
603
+ timeoutMs?: number;
604
+ /** 向量维度(会作为请求体 dimensions 下发) */
605
+ dimensions?: number;
606
+ /** 向量检索引擎;auto=优先 sqlite-vec,失败退回 JS */
607
+ vectorEngine?: VectorEngineChoice;
608
+ /** sqlite-vec 扩展路径(可选) */
609
+ sqliteVecExtensionPath?: string;
610
+ }
611
+ /** 新格式的 models 配置 */
612
+ export interface ModelsConfig {
613
+ /** 合并模式:merge=与 builtin 合并,replace=完全替代 */
614
+ mode?: 'merge' | 'replace';
615
+ /** Provider 映射(key = provider 名称) */
616
+ providers: Record<string, ModelProviderConfig>;
617
+ /** 模型级别映射(子系统通过级别名引用具体模型) */
618
+ level?: LevelMap;
619
+ /** Embedding 模型配置(可选;多处可复用) */
620
+ embedding?: EmbeddingModelConfig;
621
+ }
622
+ /** 自主子系统配置(框架级:搜索路径与审计;子系统自身参数写在各自 config.yaml) */
623
+ export interface SubsystemsConfig {
624
+ /** 审计日志目录(默认 ~/.octopi/audit) */
625
+ auditDir?: string;
626
+ /** 允许注册:id / packageId / `memory.steward.*` 前缀 */
627
+ allowlist?: string[];
628
+ /** 禁止注册(deny 优先) */
629
+ denylist?: string[];
630
+ }
631
+ /**
632
+ * 完整配置文件结构(v0.3.0)
633
+ */
634
+ export interface HarnessConfig {
635
+ /** 自主子系统配置 */
636
+ subsystems?: SubsystemsConfig;
637
+ /** Agent 列表 */
638
+ agents: AgentConfig[];
639
+ /** 模型配置(集中定义 provider + model) */
640
+ models: ModelsConfig;
641
+ /** 全局默认值 */
642
+ defaults?: Defaults;
643
+ /** Plugin 配置 */
644
+ plugins?: PluginConfig;
645
+ /** Run 安全阀 / 策略(budgetPolicy;无默认 token hard) */
646
+ budgetPolicy?: BudgetPolicyJsonConfig;
647
+ /** 过程监督配置(行为监督;与 budget 组合) */
648
+ runGuard?: RunGuardJsonConfig;
649
+ /** 激活宿主(long-lived;Schedule/Escalate 等) */
650
+ agentRuntime?: AgentRuntimeJsonConfig;
651
+ /** 上下文引擎配置 */
652
+ contextEngine?: ContextEngineConfig;
653
+ /** 公用能力 summary(harness/context/capabilities) */
654
+ summary?: SummaryCapabilityConfig;
655
+ /** 公用能力 compact 缺省 */
656
+ compact?: CompactCapabilityConfig;
657
+ /** system prompt 七层装配器配置 */
658
+ contextAssembler?: ContextAssemblerConfig;
659
+ /** context 域扩展:全局宪法等 */
660
+ context?: {
661
+ constitution?: ConstitutionConfig;
662
+ contextAssembler?: ContextAssemblerConfig;
663
+ };
664
+ /** 全局宪法(顶层简写,等价 context.constitution) */
665
+ constitution?: ConstitutionConfig;
666
+ /** Memory 写入/置信度策略 */
667
+ memory?: {
668
+ profile?: 'personal_assistant' | 'embedded_interactive' | 'embedded_headless';
669
+ /** 自动补录开关(默认 true);false 时不启动 BackfillTrigger */
670
+ backfill?: {
671
+ enabled?: boolean;
672
+ /** 空闲漂移阈值 ms(默认 20min) */
673
+ idleDelayMs?: number;
674
+ /** 覆盖差扫描间隔 ms(默认 6h) */
675
+ gapScanMs?: number;
676
+ /** 密度预筛最少 user 轮次(默认 2) */
677
+ minUserTurns?: number;
678
+ /** 密度预筛最少实质字符量(默认 200) */
679
+ minTotalChars?: number;
680
+ };
681
+ /** 按类型衰减曲线(govern 每轮 decay()) */
682
+ decay?: {
683
+ typeParams?: Partial<Record<'fact' | 'method' | 'norm', {
684
+ idleDays?: number;
685
+ factor?: number;
686
+ min?: number;
687
+ }>>;
688
+ };
689
+ /** health 双脉搏阈值(MemoryHealthProbe) */
690
+ health?: {
691
+ intervalMs?: number;
692
+ shadowBacklogLimit?: number;
693
+ limits?: Partial<Record<'fact' | 'method' | 'norm', number>>;
694
+ };
695
+ confidence?: {
696
+ injectMinScore?: number;
697
+ channelPriors?: Partial<Record<'user_directive' | 'decision' | 'fail_fix' | 'model_inference' | 'admin', number>>;
698
+ };
699
+ gates?: {
700
+ maxLength?: Partial<Record<'fact' | 'method' | 'norm', number>>;
701
+ };
702
+ };
703
+ /** Knowledge 检索/召回(全局缺省;agents[].knowledge.recall 可覆盖) */
704
+ knowledge?: KnowledgeRuntimeConfig;
705
+ /**
706
+ * 安全策略(安全不可绕过:无总开关)
707
+ *
708
+ * 硬边界与 ToolCallRiskPolicy 始终执行;此处只调处置/范围/灵敏度。
709
+ */
710
+ security?: {
711
+ /**
712
+ * 风险命中后的处置(硬边界不受影响)
713
+ * - `block`(默认):按 severity 拦截
714
+ * - `audit`:只记事件,不拦
715
+ */
716
+ enforce?: 'block' | 'audit';
717
+ /** 注入检测灵敏度 */
718
+ injectionSensitivity?: 'low' | 'medium' | 'high';
719
+ /** 绝对路径额外允许范围 */
720
+ allowedPaths?: string[];
721
+ };
722
+ /** Channel 列表 */
723
+ channels?: ChannelConfig[];
724
+ /** Session 配置 */
725
+ session?: SessionConfig;
726
+ /**
727
+ * 工具效应隔离策略(宪法 I5)
728
+ *
729
+ * - `none`(默认):多 Session 共享 agent.workspace
730
+ * - `session-subdir`:cwd → `<workspace>/<sessionId>/`
731
+ * - `session-lock`:共享路径;同 sessionId 由 Runner 锁串行(不路径隔离)
732
+ */
733
+ toolIsolation?: 'none' | 'session-subdir' | 'session-lock';
734
+ /**
735
+ * Session ACL 角色目录(E6)
736
+ *
737
+ * 缺省使用内置五角色;可覆盖/新增。handoff 默认仅宿主。
738
+ */
739
+ sessionAcl?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionAclConfig;
740
+ /** 并发控制配置 */
741
+ concurrency?: {
742
+ /** 多 Key Provider 负载均衡池 */
743
+ providerPool?: {
744
+ /** 池中的 slot 列表 */
745
+ slots: Array<{
746
+ /** 引用 providers[].name */
747
+ provider: string;
748
+ /** 权重(默认 1) */
749
+ weight?: number;
750
+ /** slot 级限流配置(覆盖全局默认) */
751
+ rateLimit?: {
752
+ requestsPerMinute: number;
753
+ burstCapacity?: number;
754
+ maxWaitMs?: number;
755
+ };
756
+ }>;
757
+ /** 路由配置 */
758
+ routing?: {
759
+ /** 路由策略(默认 sticky) */
760
+ strategy?: 'sticky' | 'round-robin' | 'least-loaded';
761
+ /** 粘滞超时(毫秒,默认 1800000) */
762
+ stickyTtlMs?: number;
763
+ /** 故障转移模式(默认 auto) */
764
+ failover?: 'auto' | 'manual';
765
+ };
766
+ /** 全局默认限流配置 */
767
+ rateLimit?: {
768
+ requestsPerMinute: number;
769
+ burstCapacity?: number;
770
+ maxWaitMs?: number;
771
+ };
772
+ };
773
+ /** Session 并发控制 */
774
+ sessionGate?: {
775
+ /** 最大并发 session 数(默认 50) */
776
+ maxConcurrent?: number;
777
+ /** 排队超时(毫秒,默认 30000) */
778
+ waitTimeoutMs?: number;
779
+ };
780
+ };
781
+ /** 网络搜索配置(web_search 工具) */
782
+ webSearch?: WebSearchToolConfig;
783
+ /** Web UI 运行配置 */
784
+ web?: {
785
+ /** Web UI 源码目录(含 package.json);未设置时按 CLI 内置顺序探测 */
786
+ dir?: string;
787
+ /**
788
+ * Web UI / Gateway 监听 host
789
+ *
790
+ * `local`(默认,仅本机)| `lan`(局域网)| 具体 IP/主机名。
791
+ * 与 `channels[].host` 各自生效;局域网访问两者都需放开。
792
+ */
793
+ host?: NetworkHostConfig;
794
+ };
795
+ /** 产品 Observer 通道(开发/测试 Run 现场;生产可 summary/off) */
796
+ observer?: import('@octopi-agent/engine/harness/observability/observer/types.js').ObserverConfig;
797
+ /** 可观测性配置 */
798
+ observability?: {
799
+ /** 日志级别: 0=FATAL, 1=ERROR, 2=WARN, 3=INFO, 4=DEBUG, 5=TRACE */
800
+ level?: number;
801
+ /** 控制台输出级别(null = 不输出到控制台) */
802
+ consoleLevel?: number | null;
803
+ /** Trace 文件输出目录(null = 不输出到文件) */
804
+ traceDir?: string | null;
805
+ /** 是否记录流式 delta(数据量大,默认关闭) */
806
+ captureStreamDeltas?: boolean;
807
+ /** 是否记录完整模型请求 */
808
+ captureModelRequest?: boolean;
809
+ };
810
+ }
811
+ /**
812
+ * 判断 models 字段是否为新格式(ModelsConfig 对象)
813
+ */
814
+ /**
815
+ * 从 ModelsConfig 提取所有模型的扁平列表(供 resolveModelConfig 查找)
816
+ */
817
+ export declare function flattenModels(config: ModelsConfig): NormalizedModelInfo[];
818
+ export declare function resolveModelConfig(modelRef: string | _ModelConfig, models: NormalizedModelInfo[], defaults?: Defaults): _ModelConfig;
819
+ /** 内部使用的规范化配置(loadConfig 输出) */
820
+ export interface NormalizedHarnessConfig extends HarnessConfig {
821
+ /** 从 models.providers 提取的扁平模型列表 */
822
+ flatModels: NormalizedModelInfo[];
823
+ /** 从 models.level 解析的级别映射(已规范化) */
824
+ levelMap?: LevelMap;
825
+ }
826
+ /** 扁平化的模型信息(供 resolveModelConfig 查找) */
827
+ export interface NormalizedModelInfo {
828
+ id: string;
829
+ provider: string;
830
+ model: string;
831
+ contextWindow?: number;
832
+ maxTokens?: number;
833
+ }
834
+ /**
835
+ * 从 ModelProviderConfig 创建 ModelProvider 实例
836
+ *
837
+ * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
838
+ * 使用动态 import 以支持 ESM。
839
+ */
840
+ export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig): Promise<ModelProvider>;