@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,122 @@
1
+ /**
2
+ * SystemPromptAssembler — Runner 每轮 system prompt 装配端口
3
+ *
4
+ * 全局宪法 preamble 固定在最前;层契约见 harness/context。
5
+ */
6
+ import { DefaultContextAssembler } from './assembler.js';
7
+ import { CognitionLayer, KnowledgeLayer, MemoryLayer, PersonaLayer, RuntimeLayer, SkillLayer, WisdomLayer, } from './layers.js';
8
+ import { loadConstitution } from './constitution/load-constitution.js';
9
+ const DEFAULT_SYSTEM_BUDGET_RATIO = 0.22;
10
+ export function createDefaultSystemPromptAssembler(options) {
11
+ let preamble = options?.constitutionText ?? '';
12
+ if (!preamble && options?.constitution !== undefined && options?.constitution !== null) {
13
+ if (typeof options.constitution === 'string') {
14
+ preamble = options.constitution;
15
+ }
16
+ else {
17
+ preamble = loadConstitution(options.constitution).text;
18
+ }
19
+ }
20
+ else if (!preamble && options?.constitution === undefined && options?.constitutionText === undefined) {
21
+ // Builder 未显式配置时仍装配产品默认宪法(product)
22
+ try {
23
+ preamble = loadConstitution({ mode: 'product' }).text;
24
+ }
25
+ catch {
26
+ preamble = '';
27
+ }
28
+ }
29
+ const assembler = options?.assembler ??
30
+ new DefaultContextAssembler({
31
+ ...options?.assemblerConfig,
32
+ constitutionPreamble: options?.assemblerConfig?.constitutionPreamble ?? preamble,
33
+ });
34
+ // 若外部传入 assembler 且无 preamble,每轮 params 注入
35
+ const passPreamblePerAssemble = Boolean(options?.assembler && !(options.assemblerConfig?.constitutionPreamble ?? preamble));
36
+ const ratio = options?.systemBudgetRatio ?? DEFAULT_SYSTEM_BUDGET_RATIO;
37
+ const getSkillPromptText = options?.getSkillPromptText;
38
+ const wisdomStore = options?.wisdomStore;
39
+ const cognitionStore = options?.cognitionStore;
40
+ const resolvedPreamble = options?.assemblerConfig?.constitutionPreamble ?? preamble;
41
+ return {
42
+ clearSession(sessionId) {
43
+ const maybe = assembler;
44
+ if (typeof maybe.clearSession === 'function') {
45
+ maybe.clearSession(sessionId);
46
+ }
47
+ },
48
+ async assemble(input) {
49
+ const hasPersona = Boolean((input.persona ?? '').trim());
50
+ const hasInjected = Boolean((input.injectedContext ?? '').trim());
51
+ let hasSkill = false;
52
+ if (getSkillPromptText) {
53
+ hasSkill = Boolean((await getSkillPromptText()).trim());
54
+ }
55
+ const hasRetrieval = Boolean(options?.memoryStore ||
56
+ options?.knowledgeCatalog ||
57
+ wisdomStore ||
58
+ cognitionStore);
59
+ const hasPreamble = Boolean(resolvedPreamble.trim());
60
+ if (!hasPersona && !hasInjected && !hasSkill && !hasRetrieval && !hasPreamble) {
61
+ return { systemPrompt: '' };
62
+ }
63
+ // contextWindow 未知且未配置 systemBudgetTokens:
64
+ // **跳过按窗口比例的预算**,但仍装配层(不按 token 硬裁,保留完整层内容)
65
+ const absoluteBudget = options?.systemBudgetTokens;
66
+ const window = input.contextWindow;
67
+ const windowKnown = window != null && window > 0;
68
+ const skippedBudget = !windowKnown && !(absoluteBudget != null && absoluteBudget > 0);
69
+ const systemBudget = absoluteBudget != null && absoluteBudget > 0
70
+ ? absoluteBudget
71
+ : windowKnown
72
+ ? Math.max(2000, Math.floor(window * ratio))
73
+ : // 无窗口:给足层内容空间,等价于“不做窗口比例压缩”
74
+ Number.MAX_SAFE_INTEGER;
75
+ const layers = [
76
+ new PersonaLayer({
77
+ getText: () => input.persona ?? '',
78
+ sources: ['persona'],
79
+ }),
80
+ ];
81
+ if (getSkillPromptText) {
82
+ layers.push(new SkillLayer({ getPromptText: getSkillPromptText }));
83
+ }
84
+ if (wisdomStore) {
85
+ layers.push(new WisdomLayer({ getEntries: () => wisdomStore.getAll() }));
86
+ }
87
+ if (options?.knowledgeCatalog) {
88
+ layers.push(new KnowledgeLayer({
89
+ getCatalog: options.knowledgeCatalog,
90
+ maxEntries: options.knowledgeMaxEntries,
91
+ groupByScope: options.knowledgeGroupByScope,
92
+ showProgress: options.knowledgeShowProgress,
93
+ }));
94
+ }
95
+ if (cognitionStore) {
96
+ layers.push(new CognitionLayer({
97
+ store: cognitionStore,
98
+ depth: options?.cognitionDepth,
99
+ }));
100
+ }
101
+ if (options?.memoryStore) {
102
+ layers.push(new MemoryLayer({
103
+ store: options.memoryStore,
104
+ limit: options.memoryLimit,
105
+ }));
106
+ }
107
+ layers.push(new RuntimeLayer({
108
+ getText: () => input.injectedContext ?? '',
109
+ }));
110
+ const result = await assembler.assemble({
111
+ sessionId: input.sessionId,
112
+ agentId: input.agentId,
113
+ messages: input.messages,
114
+ systemBudget,
115
+ layers,
116
+ signal: input.signal,
117
+ constitutionPreamble: passPreamblePerAssemble || resolvedPreamble ? resolvedPreamble : undefined,
118
+ });
119
+ return { systemPrompt: result.systemPrompt, manifest: result.manifest, skippedBudget };
120
+ },
121
+ };
122
+ }
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Token 估算常量
3
+ *
4
+ * 参考 OpenClaw 的分层比率策略,按内容类型使用不同估算比率。
5
+ * 基于 tiktoken cl100k_base 经验值。
6
+ */
7
+ /** 通用文本:英文约 4 chars/token,中文约 1 char/token */
8
+ export declare const CHARS_PER_TOKEN = 4;
9
+ /** 工具结果:结构化输出更密集,约 2 chars/token */
10
+ export declare const TOOL_RESULT_CHARS_PER_TOKEN = 2;
11
+ /** JSON 负载:结构符号多,约 3 chars/token */
12
+ export declare const JSON_CHARS_PER_TOKEN = 3;
13
+ /** 消息结构开销(role + 分隔符 + 边界标记) */
14
+ export declare const MESSAGE_OVERHEAD_TOKENS = 12;
15
+ /** 安全余量系数:补偿估算不准,参考 OpenClaw 的 SAFETY_MARGIN */
16
+ export declare const SAFETY_MARGIN = 1.2;
17
+ /** 图片 token 估算(参考 OpenAI vision: 85-170 token/tile,假设 ~1200 token) */
18
+ export declare const IMAGE_TOKEN_ESTIMATE = 1200;
19
+ /** 音频 token 估算(~1 token/秒,假设 30 秒) */
20
+ export declare const AUDIO_TOKEN_ESTIMATE = 30;
21
+ /** 视频 token 估算(抽帧处理,假设 10 帧 × 85 token) */
22
+ export declare const VIDEO_TOKEN_ESTIMATE = 850;
23
+ /** 超长文本采样阈值(字符数) */
24
+ export declare const SAMPLE_THRESHOLD = 2000;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Token 估算常量
3
+ *
4
+ * 参考 OpenClaw 的分层比率策略,按内容类型使用不同估算比率。
5
+ * 基于 tiktoken cl100k_base 经验值。
6
+ */
7
+ // ── 字符/token 比率 ──
8
+ /** 通用文本:英文约 4 chars/token,中文约 1 char/token */
9
+ export const CHARS_PER_TOKEN = 4;
10
+ /** 工具结果:结构化输出更密集,约 2 chars/token */
11
+ export const TOOL_RESULT_CHARS_PER_TOKEN = 2;
12
+ /** JSON 负载:结构符号多,约 3 chars/token */
13
+ export const JSON_CHARS_PER_TOKEN = 3;
14
+ /** 消息结构开销(role + 分隔符 + 边界标记) */
15
+ export const MESSAGE_OVERHEAD_TOKENS = 12;
16
+ /** 安全余量系数:补偿估算不准,参考 OpenClaw 的 SAFETY_MARGIN */
17
+ export const SAFETY_MARGIN = 1.2;
18
+ // ── 多媒体估算 ──
19
+ /** 图片 token 估算(参考 OpenAI vision: 85-170 token/tile,假设 ~1200 token) */
20
+ export const IMAGE_TOKEN_ESTIMATE = 1200;
21
+ /** 音频 token 估算(~1 token/秒,假设 30 秒) */
22
+ export const AUDIO_TOKEN_ESTIMATE = 30;
23
+ /** 视频 token 估算(抽帧处理,假设 10 帧 × 85 token) */
24
+ export const VIDEO_TOKEN_ESTIMATE = 850;
25
+ // ── 采样策略 ──
26
+ /** 超长文本采样阈值(字符数) */
27
+ export const SAMPLE_THRESHOLD = 2000;
@@ -0,0 +1,70 @@
1
+ /**
2
+ * Token 估算纯函数(Harness 内部原语)
3
+ *
4
+ * 不依赖 Message / LLMMessage 等领域类型,只做「内容 → token 数」。
5
+ * 由 `token-estimator.ts` 组装为 `TokenEstimator` 实现,也可被同层模块直接复用。
6
+ *
7
+ * 三层策略(参考 OpenClaw):
8
+ * 1. 优先使用 LLM 返回的实际 token 数(外部回写)
9
+ * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
+ * 3. 兜底:启发式估算,按内容类型使用不同比率
11
+ */
12
+ /**
13
+ * CJK 感知的等效字符数计算
14
+ *
15
+ * 每个 CJK 字符计为 CHARS_PER_TOKEN 个等效字符,
16
+ * 这样 `adjustedChars / CHARS_PER_TOKEN` 能得到准确的 token 估算。
17
+ *
18
+ * 参考 OpenClaw 的 estimateStringChars()。
19
+ *
20
+ * @param text 原始文本
21
+ * @returns CJK 加权后的等效字符数
22
+ */
23
+ export declare function estimateAdjustedChars(text: string): number;
24
+ /**
25
+ * 估算单段文本的 token 数
26
+ *
27
+ * 使用 CJK 感知的等效字符数 + 采样策略。
28
+ *
29
+ * @param text 原始文本
30
+ * @returns 估算 token 数
31
+ */
32
+ export declare function estimateTextTokens(text: string): number;
33
+ /**
34
+ * 估算单个 content block 的 token 数
35
+ *
36
+ * 统一处理 text / image / audio(含 OpenAI 的 input_audio)/ video。
37
+ *
38
+ * @param block ContentBlock(至少含 type,text 块需含 text)
39
+ * @returns 估算 token 数
40
+ */
41
+ export declare function estimateContentBlock(block: {
42
+ type?: string;
43
+ text?: string;
44
+ }): number;
45
+ /**
46
+ * 估算工具调用 JSON 的 token 数
47
+ *
48
+ * 工具调用的 JSON 结构符号多,token 密度更高。
49
+ * `arguments` 已是字符串时直接用长度,避免二次 JSON.stringify。
50
+ *
51
+ * @param toolCalls `{ name?, arguments? }` 形态的工具调用列表
52
+ * @returns 估算 token 数
53
+ */
54
+ export declare function estimateToolCallTokens(toolCalls: Array<{
55
+ name?: string;
56
+ arguments?: unknown;
57
+ }>): number;
58
+ /**
59
+ * 估算松散结构消息列表的 token 数
60
+ *
61
+ * 支持 string 和 ContentBlock[] 两种 content 格式,含消息结构开销。
62
+ * 适用于无强类型 Message / LLMMessage 的调用方。
63
+ *
64
+ * @param messages `{ content?, role? }` 形态的消息列表
65
+ * @returns 估算 token 数
66
+ */
67
+ export declare function estimateTokens(messages: Array<{
68
+ content?: string | unknown[] | null;
69
+ role?: string;
70
+ }>): number;
@@ -0,0 +1,117 @@
1
+ /**
2
+ * Token 估算纯函数(Harness 内部原语)
3
+ *
4
+ * 不依赖 Message / LLMMessage 等领域类型,只做「内容 → token 数」。
5
+ * 由 `token-estimator.ts` 组装为 `TokenEstimator` 实现,也可被同层模块直接复用。
6
+ *
7
+ * 三层策略(参考 OpenClaw):
8
+ * 1. 优先使用 LLM 返回的实际 token 数(外部回写)
9
+ * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
+ * 3. 兜底:启发式估算,按内容类型使用不同比率
11
+ */
12
+ import { CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
13
+ // ── CJK 检测正则 ──
14
+ // 参考 OpenClaw 的 NON_LATIN_RE,覆盖完整东亚字符范围
15
+ const NON_LATIN_RE = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7AF\uF900-\uFAFF\uFF01-\uFF60\uFFE0-\uFFE6]/gu;
16
+ // CJK 扩展 B+ 的 surrogate pairs(U+20000-U+2FA1F)
17
+ const CJK_SURROGATE_HIGH_RE = /[\uD840-\uD87E][\uDC00-\uDFFF]/g;
18
+ /**
19
+ * CJK 感知的等效字符数计算
20
+ *
21
+ * 每个 CJK 字符计为 CHARS_PER_TOKEN 个等效字符,
22
+ * 这样 `adjustedChars / CHARS_PER_TOKEN` 能得到准确的 token 估算。
23
+ *
24
+ * 参考 OpenClaw 的 estimateStringChars()。
25
+ *
26
+ * @param text 原始文本
27
+ * @returns CJK 加权后的等效字符数
28
+ */
29
+ export function estimateAdjustedChars(text) {
30
+ if (text.length === 0)
31
+ return 0;
32
+ const nonLatinCount = (text.match(NON_LATIN_RE) ?? []).length;
33
+ // 修正 surrogate pairs(CJK 扩展 B+ 占 2 个 UTF-16 单元但算 1 个字符)
34
+ const cjkSurrogates = (text.match(CJK_SURROGATE_HIGH_RE) ?? []).length;
35
+ const codePointLength = text.length - cjkSurrogates;
36
+ // CJK 字符本身已计入 codePointLength,额外加 (CHARS_PER_TOKEN - 1) 的权重
37
+ return codePointLength + nonLatinCount * (CHARS_PER_TOKEN - 1);
38
+ }
39
+ /**
40
+ * 估算单段文本的 token 数
41
+ *
42
+ * 使用 CJK 感知的等效字符数 + 采样策略。
43
+ *
44
+ * @param text 原始文本
45
+ * @returns 估算 token 数
46
+ */
47
+ export function estimateTextTokens(text) {
48
+ if (text.length === 0)
49
+ return 0;
50
+ // 超长文本采样
51
+ const sample = text.length > SAMPLE_THRESHOLD ? text.slice(0, SAMPLE_THRESHOLD) : text;
52
+ const sampleRatio = text.length / sample.length;
53
+ const adjustedChars = estimateAdjustedChars(sample);
54
+ return Math.ceil((adjustedChars / CHARS_PER_TOKEN) * sampleRatio);
55
+ }
56
+ /**
57
+ * 估算单个 content block 的 token 数
58
+ *
59
+ * 统一处理 text / image / audio(含 OpenAI 的 input_audio)/ video。
60
+ *
61
+ * @param block ContentBlock(至少含 type,text 块需含 text)
62
+ * @returns 估算 token 数
63
+ */
64
+ export function estimateContentBlock(block) {
65
+ if (block.type === 'text' && typeof block.text === 'string') {
66
+ return estimateTextTokens(block.text);
67
+ }
68
+ if (block.type === 'image')
69
+ return IMAGE_TOKEN_ESTIMATE;
70
+ if (block.type === 'audio' || block.type === 'input_audio')
71
+ return AUDIO_TOKEN_ESTIMATE;
72
+ if (block.type === 'video')
73
+ return VIDEO_TOKEN_ESTIMATE;
74
+ return 10; // 其他块类型
75
+ }
76
+ /**
77
+ * 估算工具调用 JSON 的 token 数
78
+ *
79
+ * 工具调用的 JSON 结构符号多,token 密度更高。
80
+ * `arguments` 已是字符串时直接用长度,避免二次 JSON.stringify。
81
+ *
82
+ * @param toolCalls `{ name?, arguments? }` 形态的工具调用列表
83
+ * @returns 估算 token 数
84
+ */
85
+ export function estimateToolCallTokens(toolCalls) {
86
+ let total = 0;
87
+ for (const tc of toolCalls) {
88
+ total += estimateTextTokens(tc.name ?? '');
89
+ const argsStr = typeof tc.arguments === 'string' ? tc.arguments : JSON.stringify(tc.arguments ?? {});
90
+ total += Math.ceil(argsStr.length / JSON_CHARS_PER_TOKEN);
91
+ }
92
+ return total;
93
+ }
94
+ /**
95
+ * 估算松散结构消息列表的 token 数
96
+ *
97
+ * 支持 string 和 ContentBlock[] 两种 content 格式,含消息结构开销。
98
+ * 适用于无强类型 Message / LLMMessage 的调用方。
99
+ *
100
+ * @param messages `{ content?, role? }` 形态的消息列表
101
+ * @returns 估算 token 数
102
+ */
103
+ export function estimateTokens(messages) {
104
+ let total = 0;
105
+ for (const msg of messages) {
106
+ total += MESSAGE_OVERHEAD_TOKENS;
107
+ if (typeof msg.content === 'string' && msg.content.length > 0) {
108
+ total += estimateTextTokens(msg.content);
109
+ }
110
+ else if (Array.isArray(msg.content)) {
111
+ for (const block of msg.content) {
112
+ total += estimateContentBlock(block);
113
+ }
114
+ }
115
+ }
116
+ return total;
117
+ }
@@ -0,0 +1,63 @@
1
+ /**
2
+ * HeuristicTokenEstimator — 启发式 Token 估算器
3
+ *
4
+ * 实现本域 `TokenEstimator` 契约(`./types.ts`);估算原语在 `token-estimate-fns.ts`。
5
+ * Token 估算属 Context 域策略,不是 Core Kernel 能力。
6
+ *
7
+ * 三层策略(参考 OpenClaw):
8
+ * 1. 优先使用 LLM 返回的实际 token 数(usage reported prompt)- 外部回写
9
+ * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
+ * 3. 兜底:启发式估算,按内容类型使用不同比率
11
+ */
12
+ import type { Message } from '@octopi-agent/core/types.js';
13
+ import type { TokenEstimator } from './types.js';
14
+ import type { LLMMessage, LLMToolDefinition } from '@octopi-agent/core/interfaces/model-provider.js';
15
+ export { estimateTextTokens } from './token-estimate-fns.js';
16
+ /**
17
+ * 启发式 Token 估算器实现
18
+ */
19
+ export declare class HeuristicTokenEstimator implements TokenEstimator {
20
+ /**
21
+ * 估算单条消息的 token 数
22
+ *
23
+ * 支持 string 和 ContentBlock[] 两种 content 格式。
24
+ * 包含消息结构开销(role、分隔符等)。
25
+ *
26
+ * @param message 领域消息
27
+ * @returns 估算 token 数
28
+ */
29
+ estimateMessage(message: Message): number;
30
+ /**
31
+ * 估算多条消息的总 token 数
32
+ *
33
+ * @param messages 领域消息列表
34
+ * @returns 估算 token 数
35
+ */
36
+ estimateMessages(messages: Message[]): number;
37
+ /**
38
+ * 估算文本的 token 数
39
+ *
40
+ * @param text 原始文本
41
+ * @returns 估算 token 数
42
+ */
43
+ estimateText(text: string): number;
44
+ /**
45
+ * 估算工具定义的 token 数
46
+ *
47
+ * 工具定义包含:名称、描述、参数 schema。
48
+ * JSON schema 结构符号多,token 密度高。
49
+ *
50
+ * @param tools 工具定义列表
51
+ * @returns 估算 token 数
52
+ */
53
+ estimateTools(tools: LLMToolDefinition[]): number;
54
+ }
55
+ /**
56
+ * 估算 LLM 消息列表的 token 数
57
+ *
58
+ * 适配 provider 侧 `LLMMessage`(OpenAI 风格 `tool_calls` / `input_audio`)。
59
+ *
60
+ * @param messages LLM 消息列表
61
+ * @returns 估算 token 数
62
+ */
63
+ export declare function estimateLLMMessages(messages: LLMMessage[]): number;
@@ -0,0 +1,126 @@
1
+ /**
2
+ * HeuristicTokenEstimator — 启发式 Token 估算器
3
+ *
4
+ * 实现本域 `TokenEstimator` 契约(`./types.ts`);估算原语在 `token-estimate-fns.ts`。
5
+ * Token 估算属 Context 域策略,不是 Core Kernel 能力。
6
+ *
7
+ * 三层策略(参考 OpenClaw):
8
+ * 1. 优先使用 LLM 返回的实际 token 数(usage reported prompt)- 外部回写
9
+ * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
+ * 3. 兜底:启发式估算,按内容类型使用不同比率
11
+ */
12
+ import { estimateTextTokens, estimateAdjustedChars, estimateContentBlock, estimateToolCallTokens, } from './token-estimate-fns.js';
13
+ import { TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, } from './token-constants.js';
14
+ // Re-export for callers that only need text estimation
15
+ export { estimateTextTokens } from './token-estimate-fns.js';
16
+ /**
17
+ * 启发式 Token 估算器实现
18
+ */
19
+ export class HeuristicTokenEstimator {
20
+ /**
21
+ * 估算单条消息的 token 数
22
+ *
23
+ * 支持 string 和 ContentBlock[] 两种 content 格式。
24
+ * 包含消息结构开销(role、分隔符等)。
25
+ *
26
+ * @param message 领域消息
27
+ * @returns 估算 token 数
28
+ */
29
+ estimateMessage(message) {
30
+ let tokens = MESSAGE_OVERHEAD_TOKENS;
31
+ if (typeof message.content === 'string') {
32
+ tokens += estimateTextTokens(message.content);
33
+ }
34
+ else if (Array.isArray(message.content)) {
35
+ for (const block of message.content) {
36
+ tokens += estimateContentBlock(block);
37
+ }
38
+ }
39
+ if (message.toolCalls) {
40
+ tokens += estimateToolCallTokens(message.toolCalls);
41
+ }
42
+ // 工具结果用更密集的比率(chars/2)
43
+ if (message.toolResults) {
44
+ for (const tr of message.toolResults) {
45
+ const body = tr.error !== undefined
46
+ ? JSON.stringify({ error: tr.error })
47
+ : typeof tr.result === 'string'
48
+ ? tr.result
49
+ : JSON.stringify(tr.result ?? null);
50
+ tokens += Math.ceil(estimateAdjustedChars(body) / TOOL_RESULT_CHARS_PER_TOKEN);
51
+ }
52
+ }
53
+ return tokens;
54
+ }
55
+ /**
56
+ * 估算多条消息的总 token 数
57
+ *
58
+ * @param messages 领域消息列表
59
+ * @returns 估算 token 数
60
+ */
61
+ estimateMessages(messages) {
62
+ let total = 0;
63
+ for (const msg of messages) {
64
+ total += this.estimateMessage(msg);
65
+ }
66
+ return total;
67
+ }
68
+ /**
69
+ * 估算文本的 token 数
70
+ *
71
+ * @param text 原始文本
72
+ * @returns 估算 token 数
73
+ */
74
+ estimateText(text) {
75
+ return estimateTextTokens(text);
76
+ }
77
+ /**
78
+ * 估算工具定义的 token 数
79
+ *
80
+ * 工具定义包含:名称、描述、参数 schema。
81
+ * JSON schema 结构符号多,token 密度高。
82
+ *
83
+ * @param tools 工具定义列表
84
+ * @returns 估算 token 数
85
+ */
86
+ estimateTools(tools) {
87
+ let total = 0;
88
+ for (const tool of tools) {
89
+ const fn = tool.function;
90
+ total += estimateTextTokens(fn.name);
91
+ total += estimateTextTokens(fn.description);
92
+ const paramsStr = JSON.stringify(fn.parameters ?? {});
93
+ total += Math.ceil(paramsStr.length / JSON_CHARS_PER_TOKEN);
94
+ }
95
+ return total;
96
+ }
97
+ }
98
+ /**
99
+ * 估算 LLM 消息列表的 token 数
100
+ *
101
+ * 适配 provider 侧 `LLMMessage`(OpenAI 风格 `tool_calls` / `input_audio`)。
102
+ *
103
+ * @param messages LLM 消息列表
104
+ * @returns 估算 token 数
105
+ */
106
+ export function estimateLLMMessages(messages) {
107
+ let total = 0;
108
+ for (const msg of messages) {
109
+ total += MESSAGE_OVERHEAD_TOKENS;
110
+ if (typeof msg.content === 'string') {
111
+ total += estimateTextTokens(msg.content);
112
+ }
113
+ else if (Array.isArray(msg.content)) {
114
+ for (const block of msg.content) {
115
+ total += estimateContentBlock(block);
116
+ }
117
+ }
118
+ if (msg.tool_calls) {
119
+ total += estimateToolCallTokens(msg.tool_calls.map((tc) => ({
120
+ name: tc.function?.name,
121
+ arguments: tc.function?.arguments ?? '',
122
+ })));
123
+ }
124
+ }
125
+ return total;
126
+ }
@@ -0,0 +1,28 @@
1
+ /**
2
+ * TruncateCompressor — 截断压缩器
3
+ *
4
+ * 最简单的压缩策略:直接截断早期消息,保留最近消息。
5
+ * 不需要 LLM,零成本,但信息损失最大。
6
+ *
7
+ * 作为兜底方案,当 LLM 摘要不可用时使用。
8
+ */
9
+ import type { Compressor, CompressParams, CompressResult } from './types.js';
10
+ export declare class TruncateCompressor implements Compressor {
11
+ /**
12
+ * 压缩消息
13
+ *
14
+ * 策略:
15
+ * 1. 从头部开始移除消息,直到达到目标 token 数
16
+ * 2. 插入一条摘要消息说明被移除的内容
17
+ * 3. 保持边界对齐(不拆分 tool_call/tool_result 对)
18
+ */
19
+ compress(params: CompressParams): Promise<CompressResult>;
20
+ /**
21
+ * 检查消息是否包含工具调用
22
+ */
23
+ private hasToolCall;
24
+ /**
25
+ * 检查消息是否是工具结果
26
+ */
27
+ private isToolResult;
28
+ }
@@ -0,0 +1,100 @@
1
+ /**
2
+ * TruncateCompressor — 截断压缩器
3
+ *
4
+ * 最简单的压缩策略:直接截断早期消息,保留最近消息。
5
+ * 不需要 LLM,零成本,但信息损失最大。
6
+ *
7
+ * 作为兜底方案,当 LLM 摘要不可用时使用。
8
+ */
9
+ import { HeuristicTokenEstimator } from './token-estimator.js';
10
+ export class TruncateCompressor {
11
+ /**
12
+ * 压缩消息
13
+ *
14
+ * 策略:
15
+ * 1. 从头部开始移除消息,直到达到目标 token 数
16
+ * 2. 插入一条摘要消息说明被移除的内容
17
+ * 3. 保持边界对齐(不拆分 tool_call/tool_result 对)
18
+ */
19
+ async compress(params) {
20
+ const { messages, targetTokens, tokenEstimator } = params;
21
+ const estimator = tokenEstimator ?? new HeuristicTokenEstimator();
22
+ // 如果没有消息需要压缩
23
+ if (messages.length === 0) {
24
+ return {
25
+ result: [],
26
+ estimatedTokens: 0,
27
+ };
28
+ }
29
+ // 计算当前 token 数
30
+ const currentTokens = estimator.estimateMessages(messages);
31
+ // 如果已经在预算内,不需要压缩
32
+ if (currentTokens <= targetTokens) {
33
+ return {
34
+ result: [...messages],
35
+ estimatedTokens: currentTokens,
36
+ };
37
+ }
38
+ // 需要压缩的 token 数
39
+ const excessTokens = currentTokens - targetTokens;
40
+ // 从头部开始移除消息
41
+ const remaining = [...messages];
42
+ let removedCount = 0;
43
+ let removedTokens = 0;
44
+ while (remaining.length > 0 && removedTokens < excessTokens) {
45
+ const msg = remaining[0];
46
+ const msgTokens = estimator.estimateMessage(msg);
47
+ // 边界对齐:如果下一条是 tool_result,一起移除
48
+ if (this.hasToolCall(msg) && remaining.length > 1 && this.isToolResult(remaining[1])) {
49
+ const nextTokens = estimator.estimateMessage(remaining[1]);
50
+ remaining.splice(0, 2);
51
+ removedTokens += msgTokens + nextTokens;
52
+ removedCount += 2;
53
+ }
54
+ else {
55
+ remaining.shift();
56
+ removedTokens += msgTokens;
57
+ removedCount++;
58
+ }
59
+ // 至少保留最后 2 条消息
60
+ if (remaining.length <= 2) {
61
+ break;
62
+ }
63
+ }
64
+ // 如果没有移除任何消息,强制移除最早的一条
65
+ if (removedCount === 0 && remaining.length > 2) {
66
+ const removed = remaining.shift();
67
+ removedCount = 1;
68
+ removedTokens = estimator.estimateMessage(removed);
69
+ }
70
+ // 生成摘要消息(user 角色,避免中段 system)
71
+ const summaryMessage = {
72
+ role: 'user',
73
+ content: `[Context compressed: ${removedCount} earlier messages removed to fit context window. ` +
74
+ `Approximately ${removedTokens} tokens saved. ` +
75
+ `The conversation continues from here.]`,
76
+ timestamp: Date.now(),
77
+ metadata: { source: 'contextSummary' },
78
+ };
79
+ // 组装结果
80
+ const result = [summaryMessage, ...remaining];
81
+ const estimatedTokens = estimator.estimateMessages(result);
82
+ return {
83
+ result,
84
+ estimatedTokens,
85
+ droppedSummary: `${removedCount} messages removed (~${removedTokens} tokens)`,
86
+ };
87
+ }
88
+ /**
89
+ * 检查消息是否包含工具调用
90
+ */
91
+ hasToolCall(msg) {
92
+ return msg.role === 'assistant' && msg.toolCalls !== undefined && msg.toolCalls.length > 0;
93
+ }
94
+ /**
95
+ * 检查消息是否是工具结果
96
+ */
97
+ isToolResult(msg) {
98
+ return msg.role === 'tool' || (msg.toolResults !== undefined && msg.toolResults.length > 0);
99
+ }
100
+ }