@octopi-agent/engine 0.98.4 → 0.121.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -1,17 +1,24 @@
1
1
  /**
2
2
  * HeuristicTokenEstimator — 启发式 Token 估算器
3
3
  *
4
- * 实现本域 `TokenEstimator` 契约(`./types.ts`);估算原语在 `token-estimate-fns.ts`。
5
- * Token 估算属 Context 域策略,不是 Core Kernel 能力。
4
+ * 实现本域 `TokenEstimator` 契约(`./types.ts`)。**计数逻辑唯一**在
5
+ * `token-segments.ts`(P1-c「单实现 + 两 adapter」);本文件是两个形状 adapter:
6
+ * - {@link fromDomainMessages}:领域 `Message[]`(toolCalls / toolResults 字段)
7
+ * - {@link fromLlmMessages}:provider `LLMMessage[]`(tool_calls / tool_use /
8
+ * tool_result 块 / role:'tool' 消息)
9
+ *
10
+ * 同内容两入口读数一致是测试红线(差 < 1%)。两处旧口径缺陷已随统一修正:
11
+ * 1. LLM 口径把 tool_use / tool_result 块落「常数 10」兜底(R4 违约)→ 分类计数;
12
+ * 2. 领域口径的 CJK 膨胀 hack 挪到 2 比率上高倍(全 CJK 工具结果 2 token/字)→ 分类查表。
6
13
  *
7
14
  * 三层策略:
8
15
  * 1. 优先使用 LLM 返回的实际 token 数(usage reported prompt)- 外部回写
9
16
  * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
17
  * 3. 兜底:启发式估算,按内容类型使用不同比率
11
18
  */
12
- import { estimateTextTokens, estimateAdjustedChars, estimateContentBlock, estimateToolCallTokens, } from './token-estimate-fns.js';
19
+ import { estimateTextTokens, contentBlockSegment, toolCallSegment } from './token-estimate-fns.js';
20
+ import { estimateSegments, sumSegments, textSegment, classifyChars } from './token-segments.js';
13
21
  import { toolResultBody } from './tool-result-body.js';
14
- import { TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, } from './token-constants.js';
15
22
  // Re-export for callers that only need text estimation
16
23
  export { estimateTextTokens } from './token-estimate-fns.js';
17
24
  /**
@@ -21,9 +28,98 @@ export { estimateTextTokens } from './token-estimate-fns.js';
21
28
  * 估算对同一消息是纯函数,跨实例结果必须一致。
22
29
  */
23
30
  const messageTokensCache = new WeakMap();
31
+ /** 领域消息 → Segment[](adapter:只做形状归一;空串 content 不产生段,保两入口形状对称) */
32
+ function fromDomainMessage(message) {
33
+ // wire 对齐(评审 #4):convertMessage 把带 N 条 toolResults 的消息发成 N 条
34
+ // role:'tool' 消息(各带一条开销);其余消息 1 条开销。
35
+ const overhead = message.toolResults?.length ? message.toolResults.length : 1;
36
+ const segments = [{ kind: 'message_overhead', count: overhead }];
37
+ if (typeof message.content === 'string') {
38
+ if (message.content.length > 0)
39
+ segments.push(textSegment(message.content));
40
+ }
41
+ else if (Array.isArray(message.content)) {
42
+ for (const block of message.content) {
43
+ segments.push(contentBlockSegment(block));
44
+ }
45
+ }
46
+ if (message.toolCalls) {
47
+ for (const tc of message.toolCalls) {
48
+ segments.push(toolCallSegment(tc.name, tc.arguments));
49
+ }
50
+ }
51
+ if (message.toolResults) {
52
+ for (const tr of message.toolResults) {
53
+ const body = toolResultBody(tr);
54
+ const { chars, cjk } = classifyChars(body);
55
+ segments.push({ kind: 'tool_result', chars, cjk, isError: tr.error !== undefined });
56
+ }
57
+ }
58
+ return segments;
59
+ }
60
+ /** 领域消息列表 → Segment[](adapter 公开入口) */
61
+ export function fromDomainMessages(messages) {
62
+ const segments = [];
63
+ for (const message of messages)
64
+ segments.push(...fromDomainMessage(message));
65
+ return segments;
66
+ }
67
+ /** provider 内容块 → Segment(tool_use / tool_result 块专用归一) */
68
+ function llmContentBlockSegment(block) {
69
+ const type = typeof block.type === 'string' ? block.type : undefined;
70
+ if (type === 'tool_use') {
71
+ return toolCallSegment(typeof block.name === 'string' ? block.name : undefined, block.input ?? block.arguments ?? {});
72
+ }
73
+ if (type === 'tool_result') {
74
+ const raw = block.content ?? block.text ?? '';
75
+ const body = typeof raw === 'string' ? raw : JSON.stringify(raw);
76
+ const { chars, cjk } = classifyChars(body);
77
+ return { kind: 'tool_result', chars, cjk, isError: block.is_error === true };
78
+ }
79
+ return contentBlockSegment(block);
80
+ }
81
+ /** provider LLM 消息 → Segment[](adapter 公开入口) */
82
+ export function fromLlmMessages(messages) {
83
+ const segments = [];
84
+ for (const msg of messages) {
85
+ segments.push({ kind: 'message_overhead', count: 1 });
86
+ // OpenAI 风格 role:'tool' 消息即工具结果(旧口径按文本比率低计,P1-c 修正)
87
+ if (msg.role === 'tool') {
88
+ const body = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content ?? '');
89
+ const { chars, cjk } = classifyChars(body);
90
+ segments.push({ kind: 'tool_result', chars, cjk, isError: false });
91
+ continue;
92
+ }
93
+ if (typeof msg.content === 'string') {
94
+ if (msg.content.length > 0)
95
+ segments.push(textSegment(msg.content));
96
+ }
97
+ else if (Array.isArray(msg.content)) {
98
+ for (const block of msg.content) {
99
+ segments.push(llmContentBlockSegment(block));
100
+ }
101
+ }
102
+ if (msg.tool_calls) {
103
+ for (const tc of msg.tool_calls) {
104
+ segments.push(toolCallSegment(tc.function?.name, tc.function?.arguments ?? ''));
105
+ }
106
+ }
107
+ }
108
+ return segments;
109
+ }
24
110
  /**
25
- * 启发式 Token 估算器实现
111
+ * 估算 LLM 消息列表的 token 数
112
+ *
113
+ * 适配 provider 侧 `LLMMessage`(OpenAI 风格 `tool_calls` / Anthropic 风格
114
+ * `tool_use` / `tool_result` 内容块 / `role:'tool'` 消息)。
115
+ *
116
+ * @param messages LLM 消息列表
117
+ * @returns 估算 token 数
26
118
  */
119
+ export function estimateLLMMessages(messages) {
120
+ return estimateSegments(fromLlmMessages(messages));
121
+ }
122
+ /** 启发式 Token 估算器实现 */
27
123
  export class HeuristicTokenEstimator {
28
124
  /**
29
125
  * 估算单条消息的 token 数
@@ -35,43 +131,31 @@ export class HeuristicTokenEstimator {
35
131
  * @returns 估算 token 数
36
132
  */
37
133
  estimateMessage(message) {
38
- const cached = messageTokensCache.get(message);
39
- if (cached !== undefined)
40
- return cached;
41
- let tokens = MESSAGE_OVERHEAD_TOKENS;
42
- if (typeof message.content === 'string') {
43
- tokens += estimateTextTokens(message.content);
44
- }
45
- else if (Array.isArray(message.content)) {
46
- for (const block of message.content) {
47
- tokens += estimateContentBlock(block);
48
- }
49
- }
50
- if (message.toolCalls) {
51
- tokens += estimateToolCallTokens(message.toolCalls);
52
- }
53
- // 工具结果用更密集的比率(chars/2)
54
- if (message.toolResults) {
55
- for (const tr of message.toolResults) {
56
- const body = toolResultBody(tr);
57
- tokens += Math.ceil(estimateAdjustedChars(body) / TOOL_RESULT_CHARS_PER_TOKEN);
58
- }
59
- }
60
- messageTokensCache.set(message, tokens);
61
- return tokens;
134
+ return Math.ceil(this.rawEstimateMessage(message));
62
135
  }
63
136
  /**
64
137
  * 估算多条消息的总 token 数
65
138
  *
139
+ * 总量一次取整(评审 #3):逐消息取整会让读数随消息切分形态漂移。
140
+ *
66
141
  * @param messages 领域消息列表
67
142
  * @returns 估算 token 数
68
143
  */
69
144
  estimateMessages(messages) {
70
145
  let total = 0;
71
146
  for (const msg of messages) {
72
- total += this.estimateMessage(msg);
147
+ total += this.rawEstimateMessage(msg);
73
148
  }
74
- return total;
149
+ return Math.ceil(total);
150
+ }
151
+ /** 单条消息的浮点估算(WeakMap 缓存存未取整值,取整只发生在对外读数上) */
152
+ rawEstimateMessage(message) {
153
+ const cached = messageTokensCache.get(message);
154
+ if (cached !== undefined)
155
+ return cached;
156
+ const tokens = sumSegments(fromDomainMessage(message));
157
+ messageTokensCache.set(message, tokens);
158
+ return tokens;
75
159
  }
76
160
  /**
77
161
  * 估算文本的 token 数
@@ -92,43 +176,13 @@ export class HeuristicTokenEstimator {
92
176
  * @returns 估算 token 数
93
177
  */
94
178
  estimateTools(tools) {
95
- let total = 0;
179
+ const segments = [];
96
180
  for (const tool of tools) {
97
181
  const fn = tool.function;
98
- total += estimateTextTokens(fn.name);
99
- total += estimateTextTokens(fn.description);
100
- const paramsStr = JSON.stringify(fn.parameters ?? {});
101
- total += Math.ceil(paramsStr.length / JSON_CHARS_PER_TOKEN);
102
- }
103
- return total;
104
- }
105
- }
106
- /**
107
- * 估算 LLM 消息列表的 token 数
108
- *
109
- * 适配 provider 侧 `LLMMessage`(OpenAI 风格 `tool_calls` / `input_audio`)。
110
- *
111
- * @param messages LLM 消息列表
112
- * @returns 估算 token 数
113
- */
114
- export function estimateLLMMessages(messages) {
115
- let total = 0;
116
- for (const msg of messages) {
117
- total += MESSAGE_OVERHEAD_TOKENS;
118
- if (typeof msg.content === 'string') {
119
- total += estimateTextTokens(msg.content);
120
- }
121
- else if (Array.isArray(msg.content)) {
122
- for (const block of msg.content) {
123
- total += estimateContentBlock(block);
124
- }
125
- }
126
- if (msg.tool_calls) {
127
- total += estimateToolCallTokens(msg.tool_calls.map((tc) => ({
128
- name: tc.function?.name,
129
- arguments: tc.function?.arguments ?? '',
130
- })));
182
+ segments.push(textSegment(fn.name));
183
+ segments.push(textSegment(fn.description));
184
+ segments.push({ kind: 'json', chars: JSON.stringify(fn.parameters ?? {}).length });
131
185
  }
186
+ return estimateSegments(segments);
132
187
  }
133
- return total;
134
188
  }
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Token 估算统一计数核心(P1-c:单实现 + 两 adapter)
3
+ *
4
+ * 「计数与入口形状无关」(arch/context-size-accounting.md §4.2):
5
+ * 入口形状(领域 `Message` / provider `LLMMessage`)只在 adapter 层归一为
6
+ * `Segment`,本模块是**唯一计数逻辑**。同内容两入口读数一致是测试红线(差 < 1%)。
7
+ *
8
+ * 比率策略:**先分类、再查表**({@link CHARS_PER_TOKEN_BY_KIND})。
9
+ * 取代旧 `estimateAdjustedChars` 的「nonLatin×3 膨胀」hack——那个 hack 是为
10
+ * text(4) 比率设计的,挪到 tool_result(2) 上会让全 CJK 结果变成 2 token/字(错一倍)。
11
+ *
12
+ * R4 红线:估算器不得返回常数兜底;未知内容块按长度计(告警半项归 P2-a)。
13
+ */
14
+ /** 分类查表:chars/token(单源在 token-constants,此处只做语义命名) */
15
+ export declare const CHARS_PER_TOKEN_BY_KIND: {
16
+ /** 英文散文 */
17
+ readonly text_ascii: 4;
18
+ /** 中文等 CJK(1 token/字) */
19
+ readonly text_cjk: 1;
20
+ /** 工具结果:结构化输出更密集 */
21
+ readonly tool_result: 1.7;
22
+ /** JSON 负载(schema / arguments) */
23
+ readonly json: 2;
24
+ /** 代码 / 标识符 */
25
+ readonly code: 3;
26
+ };
27
+ /**
28
+ * 归一化内容片段。
29
+ *
30
+ * `message_overhead` 为实现扩展(sketch 未列):消息结构开销(role/分隔符/边界标记)
31
+ * 不属于内容,但必须有唯一归属处——两个 adapter 在形状归一时按消息数生成。
32
+ */
33
+ export type Segment = {
34
+ kind: 'text';
35
+ chars: number;
36
+ cjk: number;
37
+ } | {
38
+ kind: 'tool_use';
39
+ nameChars: number;
40
+ argChars: number;
41
+ } | {
42
+ kind: 'tool_result';
43
+ chars: number;
44
+ cjk: number;
45
+ isError: boolean;
46
+ } | {
47
+ kind: 'json';
48
+ chars: number;
49
+ } | {
50
+ kind: 'image' | 'audio' | 'video';
51
+ fixed: number;
52
+ } | {
53
+ kind: 'message_overhead';
54
+ count: number;
55
+ };
56
+ /** 消息结构开销(role + 分隔符 + 边界标记),单位 token(常量单源在 token-constants) */
57
+ export { MESSAGE_OVERHEAD_TOKENS } from './token-constants.js';
58
+ /**
59
+ * 字符分类:统计文本的码点数与其中的 CJK 数。
60
+ *
61
+ * 旧 `estimateAdjustedChars` 把 CJK 扩展 B 计成 ASCII(正则不匹配 surrogate),
62
+ * 此处并入 CJK(1 token/字)。其余非 BMP 码点(emoji 等)维持旧口径按 2 单元计,
63
+ * 不在本批静默调参。
64
+ *
65
+ * @param text 原始文本
66
+ * @returns chars=码点数;cjk=CJK 码点数(含扩展 B)
67
+ */
68
+ export declare function classifyChars(text: string): {
69
+ chars: number;
70
+ cjk: number;
71
+ };
72
+ /** 文本 → text 段(adapter 便捷入口) */
73
+ export declare function textSegment(text: string): Segment;
74
+ /**
75
+ * 分段求和(不取整):两入口共用的浮点累加,供调用方在**总量**上统一取整——
76
+ * 逐消息取整会让读数随消息切分形态漂移(评审 #3)。
77
+ *
78
+ * @param segments 归一化内容片段
79
+ * @returns 估算 token 数(浮点)
80
+ */
81
+ export declare function sumSegments(segments: Segment[]): number;
82
+ /**
83
+ * 唯一计数逻辑:Segment 列表 → token 估算(总量一次取整)。
84
+ *
85
+ * @param segments 归一化内容片段
86
+ * @returns 估算 token 数
87
+ */
88
+ export declare function estimateSegments(segments: Segment[]): number;
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Token 估算统一计数核心(P1-c:单实现 + 两 adapter)
3
+ *
4
+ * 「计数与入口形状无关」(arch/context-size-accounting.md §4.2):
5
+ * 入口形状(领域 `Message` / provider `LLMMessage`)只在 adapter 层归一为
6
+ * `Segment`,本模块是**唯一计数逻辑**。同内容两入口读数一致是测试红线(差 < 1%)。
7
+ *
8
+ * 比率策略:**先分类、再查表**({@link CHARS_PER_TOKEN_BY_KIND})。
9
+ * 取代旧 `estimateAdjustedChars` 的「nonLatin×3 膨胀」hack——那个 hack 是为
10
+ * text(4) 比率设计的,挪到 tool_result(2) 上会让全 CJK 结果变成 2 token/字(错一倍)。
11
+ *
12
+ * R4 红线:估算器不得返回常数兜底;未知内容块按长度计(告警半项归 P2-a)。
13
+ */
14
+ /** 分类查表:chars/token(单源在 token-constants,此处只做语义命名) */
15
+ export const CHARS_PER_TOKEN_BY_KIND = {
16
+ /** 英文散文 */
17
+ text_ascii: CHARS_PER_TOKEN,
18
+ /** 中文等 CJK(1 token/字) */
19
+ text_cjk: TEXT_CJK_CHARS_PER_TOKEN,
20
+ /** 工具结果:结构化输出更密集 */
21
+ tool_result: TOOL_RESULT_CHARS_PER_TOKEN,
22
+ /** JSON 负载(schema / arguments) */
23
+ json: JSON_CHARS_PER_TOKEN,
24
+ /** 代码 / 标识符 */
25
+ code: CODE_CHARS_PER_TOKEN,
26
+ };
27
+ /** 消息结构开销(role + 分隔符 + 边界标记),单位 token(常量单源在 token-constants) */
28
+ export { MESSAGE_OVERHEAD_TOKENS } from './token-constants.js';
29
+ import { MESSAGE_OVERHEAD_TOKENS, CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, TEXT_CJK_CHARS_PER_TOKEN, CODE_CHARS_PER_TOKEN, } from './token-constants.js';
30
+ // ── CJK 分类 ──
31
+ // 非拉丁字符检测,覆盖完整东亚字符范围(BMP)
32
+ const NON_LATIN_RE = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7AF\uF900-\uFAFF\uFF01-\uFF60\uFFE0-\uFFE6]/gu;
33
+ // CJK 扩展 B–H 的 surrogate pairs(U+20000–U+323AF):2 个 UTF-16 单元 = 1 个字符
34
+ const CJK_SURROGATE_HIGH_RE = /[\uD840-\uD888][\uDC00-\uDFFF]/g;
35
+ /**
36
+ * 字符分类:统计文本的码点数与其中的 CJK 数。
37
+ *
38
+ * 旧 `estimateAdjustedChars` 把 CJK 扩展 B 计成 ASCII(正则不匹配 surrogate),
39
+ * 此处并入 CJK(1 token/字)。其余非 BMP 码点(emoji 等)维持旧口径按 2 单元计,
40
+ * 不在本批静默调参。
41
+ *
42
+ * @param text 原始文本
43
+ * @returns chars=码点数;cjk=CJK 码点数(含扩展 B)
44
+ */
45
+ export function classifyChars(text) {
46
+ if (text.length === 0)
47
+ return { chars: 0, cjk: 0 };
48
+ const surrogatePairs = (text.match(CJK_SURROGATE_HIGH_RE) ?? []).length;
49
+ const chars = text.length - surrogatePairs;
50
+ const cjk = (text.match(NON_LATIN_RE) ?? []).length + surrogatePairs;
51
+ return { chars, cjk };
52
+ }
53
+ /** 文本 → text 段(adapter 便捷入口) */
54
+ export function textSegment(text) {
55
+ const { chars, cjk } = classifyChars(text);
56
+ return { kind: 'text', chars, cjk };
57
+ }
58
+ /**
59
+ * 分段求和(不取整):两入口共用的浮点累加,供调用方在**总量**上统一取整——
60
+ * 逐消息取整会让读数随消息切分形态漂移(评审 #3)。
61
+ *
62
+ * @param segments 归一化内容片段
63
+ * @returns 估算 token 数(浮点)
64
+ */
65
+ export function sumSegments(segments) {
66
+ let total = 0;
67
+ for (const seg of segments) {
68
+ switch (seg.kind) {
69
+ case 'text':
70
+ total += seg.cjk / CHARS_PER_TOKEN_BY_KIND.text_cjk + (seg.chars - seg.cjk) / CHARS_PER_TOKEN_BY_KIND.text_ascii;
71
+ break;
72
+ case 'tool_use':
73
+ total += seg.nameChars / CHARS_PER_TOKEN_BY_KIND.code + seg.argChars / CHARS_PER_TOKEN_BY_KIND.json;
74
+ break;
75
+ case 'tool_result':
76
+ // 分类计数:CJK 段按 1 token/字,结构化 ASCII 段按 TOOL_RESULT_CHARS_PER_TOKEN(1.7,2026-11-08 L1 调表)。
77
+ // isError 当前与正常结果同权(属性保留,调参留待有实测支撑时)。
78
+ total += seg.cjk / CHARS_PER_TOKEN_BY_KIND.text_cjk + (seg.chars - seg.cjk) / CHARS_PER_TOKEN_BY_KIND.tool_result;
79
+ break;
80
+ case 'json':
81
+ total += seg.chars / CHARS_PER_TOKEN_BY_KIND.json;
82
+ break;
83
+ case 'image':
84
+ case 'audio':
85
+ case 'video':
86
+ total += seg.fixed;
87
+ break;
88
+ case 'message_overhead':
89
+ total += seg.count * MESSAGE_OVERHEAD_TOKENS;
90
+ break;
91
+ }
92
+ }
93
+ return total;
94
+ }
95
+ /**
96
+ * 唯一计数逻辑:Segment 列表 → token 估算(总量一次取整)。
97
+ *
98
+ * @param segments 归一化内容片段
99
+ * @returns 估算 token 数
100
+ */
101
+ export function estimateSegments(segments) {
102
+ return Math.ceil(sumSegments(segments));
103
+ }
@@ -2,8 +2,9 @@
2
2
  * 历史工具结果批量冻结老化(F1-B2)— 视图级、零 LLM、write-once
3
3
  *
4
4
  * 语义(arch/long-session-latency.md §5 B2 + arch/b0-cache-stable-context.md §4):
5
- * - **当前 run 永不老化**:最近一条真实 user 消息(排除引擎载体插槽)以来的工具结果全原文;
6
- * - **近 `rawWindow` 条跨轮工具结果**保留原文;
5
+ * - **当前 run 永不老化**:当前 run 起点(`currentRunStartAnchorIndex`——同 run 的
6
+ * 插话 / 接续 turn 不推进边界)以来的工具结果全原文;
7
+ * - **近 `rawWindow` 条跨 run 工具结果**保留原文;
7
8
  * - 更旧的候选按 **`freezeBatch` 批量**降级为结构化指针(工具名 + 参数要点 + 结果轮廓 + re-run 提示);
8
9
  * - **批量冻结(禁渐进老化)**:老化边界只以 `freezeBatch` 为步长成批推进,段间轮次视图
9
10
  * 逐字节稳定——每轮在 recency 边界改写 1 条 = 把边界→尾部整段烧前缀缓存(B0 稿 §4);
@@ -15,26 +16,30 @@
15
16
  * 红线(§4 能力红线):user / assistant **正文**永不降级;**error 结果永不降级**(错误可追溯性优先,
16
17
  * 字段保真);不膨胀守卫——只有指针严格小于原文时才降级。
17
18
  *
18
- * tool_call 参数(`ageToolArgs`,默认开):**只对「结果已被老化」的那条调用**同步降级为键值摘要
19
+ * tool_call 参数(`ageToolArgs`,总开关,默认开;**逐工具 opt-in** `RegisteredTool.ageArgs`):
19
20
  * (长值换成长度标记,键名全保)。原因:参数是上下文中唯一无界增长的成分——结果老化成指针后
20
21
  * 参数仍留原文,实测其总量可达指针本体的 1.1 倍,且随 session 线性增长。
21
22
  * 降级不改变 tool_call ↔ tool_result 配对结构(`id`/`name` 不动,`arguments` 仍是合法 JSON)。
22
23
  *
23
24
  * @module harness/context/tool-result-aging
24
25
  */
25
- import type { Message } from '@octopi-agent/core/types.js';
26
+ import type { Message, ToolResultAger } from '@octopi-agent/core/types.js';
26
27
  /** 老化配置(配置面输入;缺省见 {@link resolveToolResultAgingOptions}) */
27
28
  export interface ToolResultAgingConfig {
28
29
  /** 总开关(默认 true) */
29
30
  enabled?: boolean;
30
- /** 跨轮原文保留条数(默认 40) */
31
+ /** 跨 run 原文保留条数(默认 20) */
31
32
  rawWindow?: number;
32
33
  /**
33
- * 批量冻结步长:老化边界只成批推进(默认 40;最小 1)。
34
+ * 批量冻结步长:老化边界只成批推进(默认 60;最小 1)。
34
35
  * ⚠️ 1 = 逐候选即降级(等同渐进老化、每轮烧前缀缓存,仅调试用);
35
36
  * 生产取值应 ≥ 每轮工具结果数,使冻结事件隔数轮一次。
36
- * 默认 40 的实测依据:单轮工具结果数峰值 34、均值 15,批 20 会近乎每轮触发一次,
37
- * 而每次燃烧量是常数级(rawWindow + 半批 + 当轮),小批次摊不动 → 回本点被拉到 100 次调用。
37
+ * 默认值 40 → 60(2026-11-13):老化定位从「成本优化」改为「污染控制」后
38
+ * (见 arch/history-aging-economics.md),优化目标是**减少冻结事件次数**
39
+ * 而非尽早缩小视图——每次冻结都是常数级全价重算。
40
+ * 实测单轮工具结果数峰值 34、均值 15:批 40 仍会近乎每轮触发,
41
+ * 批 60 把冻结事件间隔拉到约 4 轮一次;配合 rawWindow 20 降低近窗的
42
+ * 常驻体积,同时让更多结果在变旧后一次成批让位。
38
43
  */
39
44
  freezeBatch?: number;
40
45
  /** 指针目标字符数(默认 400;是目标非硬顶——error/固定骨架可超出) */
@@ -48,7 +53,7 @@ export interface ToolResultAgingConfig {
48
53
  /**
49
54
  * 参数摘要的目标字符数(默认 320;**只约束内容值**,键名与定位字段不计入)
50
55
  *
51
- * 定位字段(path/file/glob/pattern/cwd)与 command 头部是「这条调用碰了哪里」的唯一锚点,
56
+ * 定位字段(path/file/glob/pattern/cwd)与 command 是「这条调用碰了哪里」的唯一锚点,
52
57
  * 恒定保留;预算过小只会让内容值更快退化,不会丢锚点。
53
58
  */
54
59
  maxAgedArgChars?: number;
@@ -62,12 +67,53 @@ export interface ToolResultAgingOptions {
62
67
  ageToolArgs: boolean;
63
68
  maxAgedArgChars: number;
64
69
  }
70
+ /**
71
+ * 从工具面收集「工具名 → 老化函数」表
72
+ *
73
+ * 供装配层把 `AgentTool.ageResult` 传给老化计划。只收有声明的工具——
74
+ * 未声明者不进表 = 走默认规则(长度判据 + 机械指针)。
75
+ *
76
+ * @param tools - 本 run 实际发送的工具面(`RunScope.tools` / `AgentContext.tools`)
77
+ * @returns 名字→函数表;无任何声明时返回 undefined(省去空表分配)
78
+ */
79
+ export declare function collectToolAgers(tools: ReadonlyArray<{
80
+ name: string;
81
+ ageResult?: ToolResultAger;
82
+ }> | undefined): ReadonlyMap<string, ToolResultAger> | undefined;
83
+ /**
84
+ * 收集「参数可老化」的工具名(`AgentTool.ageArgs` → 集合)
85
+ *
86
+ * 与 {@link collectToolAgers} 分开:两者语义独立(有结果策略不代表参数可老化,
87
+ * 反之亦然),混成一张表会让「只声明了 ageArgs」的工具误走结果默认规则。
88
+ *
89
+ * @param tools - 本次 run 的工具面
90
+ * @returns 工具名集合;空表返回 undefined(装配侧据此跳过)
91
+ */
92
+ export declare function collectToolArgAgers(tools: ReadonlyArray<{
93
+ name: string;
94
+ ageArgs?: boolean;
95
+ }> | undefined): ReadonlySet<string> | undefined;
65
96
  /** 老化计划:一次装配内的降级判定(基于完整历史的纯函数结果,跨轮稳定) */
66
97
  export interface ToolResultAgingPlan {
67
98
  /** 要降级为指针的 toolCallId 集合 */
68
99
  agedIds: ReadonlySet<string>;
69
100
  /** toolCallId → 工具调用参数(指针的「参数要点」来源;取自完整历史,裁剪视图中的孤儿也有参数) */
70
101
  argsById: ReadonlyMap<string, unknown>;
102
+ /**
103
+ * toolCallId → 工具自带老化函数(`AgentTool.ageResult`;未声明者不在表内 → 走默认规则)。
104
+ *
105
+ * 随计划传给 `applyAgingToMessages`,使该函数签名保持不变(5 个调用点零改动)。
106
+ */
107
+ agersByCallId: ReadonlyMap<string, ToolResultAger>;
108
+ /**
109
+ * 启用了**参数**老化的 toolCallId 子集(`AgentTool.ageArgs === true`)。
110
+ *
111
+ * 参数老化不再全局默认开启(2026-11-13 拍板):会话视图里历史 `tool_calls`
112
+ * 上的降级标记会被模型模仿回抄(OP-TOOL-1 定案「主因=模型从老化视图模仿降级
113
+ * 标记形态」),因此只对「参数本身会变成污染源」的工具开启——当前仅
114
+ * `file_write`(整份文件正文,占空间且随文件后续改动变成过期副本)。
115
+ */
116
+ argAgedIds: ReadonlySet<string>;
71
117
  }
72
118
  /**
73
119
  * 解析老化配置(缺省 = 拍板参数起点:40 条原文 / 批 20 / 指针 400 字符)
@@ -79,17 +125,59 @@ export declare function resolveToolResultAgingOptions(input?: ToolResultAgingCon
79
125
  /**
80
126
  * 计算老化计划:批量冻结边界 + 工具调用参数索引
81
127
  *
82
- * 边界语义:跨轮工具结果(位于最近一条真实 user 消息之前)中,最旧的
83
- * `crossTurn - rawWindow` 条为候选;候选前 `freezeBatch` 整批部分「过冻结线」。
128
+ * 边界语义:跨 run 工具结果(位于当前 run 起点之前)中,最旧的
129
+ * `crossRun - rawWindow` 条为候选;候选前 `freezeBatch` 整批部分「过冻结线」。
84
130
  * 过线条目再过三道守卫才降级:error 永不降级;正文 ≤ 指针目标不降级;
85
131
  * 实际指针不比原文短不降级(不膨胀)。历史只增不减时边界单调推进、
86
132
  * 已降级条目永不回原文——满足 write-once(须以完整历史为输入,见模块头注)。
87
133
  *
88
134
  * @param messages - **完整**历史消息(按时间序;勿传裁剪后的装配视图)
89
135
  * @param opts - 老化配置(已解析)
136
+ * @param override - overflow 收敛阶梯第 0 轮(2026-11-08):ignoreTurnBoundary=true 时
137
+ * 豁免 run 起点限定(不限 crossRun、rawWindow 归 0)——守门兜底语境下「发得出去」
138
+ * 优先于「保护 turn 内工作数据/缓存前缀」;阈值(maxPointerChars/freezeBatch)不动
90
139
  * @returns 老化计划(enabled=false 或无候选时 agedIds 为空)
91
140
  */
92
- export declare function computeToolResultAgingPlan(messages: Message[], opts: ToolResultAgingOptions): ToolResultAgingPlan;
141
+ export declare function computeToolResultAgingPlan(messages: Message[], opts: ToolResultAgingOptions, override?: {
142
+ ignoreTurnBoundary?: boolean;
143
+ /** 工具名字 → 自带老化函数(`AgentTool.ageResult`);未声明的工具走默认规则 */
144
+ toolAgers?: ReadonlyMap<string, ToolResultAger>;
145
+ /** 参数可老化的工具名(`AgentTool.ageArgs`);缺省 = 参数一律原样保留 */
146
+ toolArgAgers?: ReadonlySet<string>;
147
+ }): ToolResultAgingPlan;
148
+ /**
149
+ * 单条工具结果 → 老化后的文本(**唯一裁决点**)
150
+ *
151
+ * 顺序:工具自带 ager → 默认机械指针。两处视图构建(`applyAgingToMessages`
152
+ * 与 `buildLlmMessages`)都必须走这里:历史上它们各写一份内联逻辑,
153
+ * 结果 per-tool ager 只在其中一份生效(2026-11-13 实测发现——wire dump 里
154
+ * file_edit 仍是默认指针,而单测覆盖的却是另一份实现)。
155
+ *
156
+ * @param tr - 工具结果条目
157
+ * @param args - 对应调用参数
158
+ * @param plan - 老化计划(提供 per-tool ager 与参数表)
159
+ * @param opts - 老化配置
160
+ * @returns 供模型读取的文本
161
+ */
162
+ export declare function ageOneToolResult(tr: {
163
+ toolCallId: string;
164
+ name?: string;
165
+ error?: string;
166
+ result?: unknown;
167
+ }, args: unknown, plan: Pick<ToolResultAgingPlan, 'agersByCallId'>, opts: ToolResultAgingOptions): string;
168
+ /**
169
+ * 单条工具调用 → 是否应降级其参数(**唯一裁决点**)
170
+ *
171
+ * 只看 `plan.argAgedIds`(冻结区 ∩ 工具 opt-in)。不要再回退到 `agedIds`:
172
+ * 那会让「结果恰好够大」的工具绕过 opt-in 白名单,正是 file_edit 参数在
173
+ * 2026-11-13 仍被全局降级的原因。
174
+ *
175
+ * @param toolCallId - 调用 id
176
+ * @param plan - 老化计划
177
+ * @param opts - 老化配置(含总开关 `ageToolArgs`)
178
+ * @returns 是否降级
179
+ */
180
+ export declare function shouldAgeArgs(toolCallId: string, plan: Pick<ToolResultAgingPlan, 'argAgedIds'>, opts: ToolResultAgingOptions): boolean;
93
181
  /**
94
182
  * 把老化计划物化为消息视图副本(新建对象,不改原消息)
95
183
  *
@@ -106,12 +194,17 @@ export declare function applyAgingToMessages(messages: Message[], plan: ToolResu
106
194
  /**
107
195
  * 生成结构化摘要指针(机械、零 LLM、确定性)
108
196
  *
109
- * 布局:工具名 + args 轮廓(截断)+ result 轮廓(截断)+ re-run 提示;
110
- * 轮廓预算按 `maxPointerChars` 比例派生(旋钮真实生效)。
197
+ * 布局:工具名 + 结果长度 + 结果轮廓 + 短提示。
198
+ *
199
+ * 不含参数轮廓(2026-11-13 实测):指针里的 args 是**机械截断**产物(130 条指针
200
+ * 全部恰好 98 字符 = 预算 80 + 截断标记),从不承载有效信息;对应的 tool_use 就在
201
+ * 前一条 assistant 消息里,`ageToolArgs` 还额外全保 path/command/id。留着是纯重复。
202
+ * 连同旧尾句(81 字符/条)一并去掉——它把「不要重跑」重复 130 遍,反而在提示重跑。
203
+ *
111
204
  * error 分支为防御性保真(计划永不选中 error 结果)。
112
205
  *
113
206
  * @param tr - 工具结果(error / result 至少其一)
114
- * @param args - 对应工具调用参数(可空)
207
+ * @param args - 对应工具调用参数(保留入参供策略复用;默认指针不再消费)
115
208
  * @param opts - 老化配置(已解析)
116
209
  * @returns 指针文本(write-once:同输入恒同字节)
117
210
  */
@@ -126,7 +219,7 @@ export declare function agedToolResultPointer(tr: {
126
219
  *
127
220
  * 规则(机械、确定性、无 LLM):
128
221
  * 1. **键名全保**——LLM 需要知道调用了哪个路径/命令才能在必要时重跑;
129
- * 2. 序列化长度超过 {@link ARG_VALUE_KEEP_CHARS} 的值替换为长度标记 `…[N chars]`;
222
+ * 2. 序列化长度超过 {@link ARG_VALUE_KEEP_CHARS} 的值替换为对象形标记 `{"$octopi_elided": {"chars": N}}`(锚点类——定位字段与命令——全保不降级);
130
223
  * 3. 若仍是超预算,按「值从大到小、同大小按键名」顺序继续替换,保证确定性;
131
224
  * 4. 兜底:键名太多装不下时退化为整体轮廓截断。
132
225
  *