@octopi-agent/engine 0.98.4 → 0.102.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (301) hide show
  1. package/dist/config-schema/agent.d.ts +35 -5
  2. package/dist/config-schema/agent.js +24 -4
  3. package/dist/config-schema/context.d.ts +6 -36
  4. package/dist/config-schema/context.js +4 -28
  5. package/dist/config-schema/engine.d.ts +57 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +8 -1
  8. package/dist/config-schema/governance.js +8 -1
  9. package/dist/config-schema/models.d.ts +2 -8
  10. package/dist/config-schema/models.js +0 -2
  11. package/dist/config-schema/run.d.ts +2 -2
  12. package/dist/config-schema/run.js +2 -2
  13. package/dist/config-schema/shared.d.ts +0 -3
  14. package/dist/config-schema/shared.js +0 -2
  15. package/dist/config-schema/substrate.d.ts +14 -88
  16. package/dist/config-schema/substrate.js +22 -107
  17. package/dist/config.d.ts +45 -113
  18. package/dist/config.js +8 -2
  19. package/dist/harness/activation/dispatcher.js +7 -0
  20. package/dist/harness/activation/inbox.d.ts +3 -3
  21. package/dist/harness/activation/inbox.js +3 -3
  22. package/dist/harness/activation/runtime.js +13 -5
  23. package/dist/harness/activation/types.d.ts +2 -2
  24. package/dist/harness/agent/builder.d.ts +24 -3
  25. package/dist/harness/agent/builder.js +131 -27
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.js +19 -2
  28. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  29. package/dist/harness/agent/wire-agent-builder.js +26 -7
  30. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  31. package/dist/harness/capabilities/document/factory.js +1 -0
  32. package/dist/harness/capabilities/document/port.js +6 -3
  33. package/dist/harness/capabilities/document/types.d.ts +5 -0
  34. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -1
  35. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  36. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +2 -2
  37. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  40. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  42. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  43. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +3 -3
  44. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  45. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  46. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  47. package/dist/harness/collaboration/delegation/index.js +1 -1
  48. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  49. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  50. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  51. package/dist/harness/collaboration/delegation/service.js +2 -1
  52. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  53. package/dist/harness/collaboration/delegation/store.js +2 -1
  54. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  55. package/dist/harness/collaboration/delegation/types.js +22 -0
  56. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  57. package/dist/harness/context/budget-allocator.d.ts +26 -18
  58. package/dist/harness/context/budget-allocator.js +67 -32
  59. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  60. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  61. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  62. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  63. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  64. package/dist/harness/context/capabilities/compact/index.js +4 -0
  65. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  66. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  67. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  68. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  69. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  70. package/dist/harness/context/capabilities/compact/types.js +11 -1
  71. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  72. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  73. package/dist/harness/context/capabilities/summary/port.js +0 -1
  74. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  75. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  76. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  77. package/dist/harness/context/capabilities/summary/types.d.ts +3 -6
  78. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  79. package/dist/harness/context/context-size-ledger.js +236 -0
  80. package/dist/harness/context/default-context-engine.d.ts +195 -119
  81. package/dist/harness/context/default-context-engine.js +1241 -743
  82. package/dist/harness/context/index.d.ts +2 -2
  83. package/dist/harness/context/index.js +1 -1
  84. package/dist/harness/context/layer-types.d.ts +15 -0
  85. package/dist/harness/context/layer-types.js +14 -1
  86. package/dist/harness/context/layers.d.ts +14 -15
  87. package/dist/harness/context/layers.js +41 -11
  88. package/dist/harness/context/message-selector.d.ts +10 -8
  89. package/dist/harness/context/message-selector.js +49 -27
  90. package/dist/harness/context/summarize.d.ts +2 -2
  91. package/dist/harness/context/summarize.js +9 -2
  92. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  93. package/dist/harness/context/system-prompt-assembler.js +2 -1
  94. package/dist/harness/context/token-constants.d.ts +8 -6
  95. package/dist/harness/context/token-constants.js +8 -7
  96. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  97. package/dist/harness/context/token-estimate-fns.js +85 -66
  98. package/dist/harness/context/token-estimator.d.ts +27 -12
  99. package/dist/harness/context/token-estimator.js +120 -66
  100. package/dist/harness/context/token-segments.d.ts +88 -0
  101. package/dist/harness/context/token-segments.js +103 -0
  102. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  103. package/dist/harness/context/tool-result-aging.js +16 -5
  104. package/dist/harness/context/tool-result-body.js +2 -0
  105. package/dist/harness/context/transform/anchors.d.ts +66 -0
  106. package/dist/harness/context/transform/anchors.js +125 -0
  107. package/dist/harness/context/transform/fold.d.ts +56 -0
  108. package/dist/harness/context/transform/fold.js +135 -0
  109. package/dist/harness/context/transform/migrate.d.ts +41 -0
  110. package/dist/harness/context/transform/migrate.js +69 -0
  111. package/dist/harness/context/transform/types.d.ts +129 -0
  112. package/dist/harness/context/transform/types.js +19 -0
  113. package/dist/harness/context/turn-envelope.d.ts +6 -3
  114. package/dist/harness/context/types.d.ts +127 -117
  115. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  116. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  117. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  118. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  119. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  120. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  121. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  122. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  123. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  124. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  125. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  126. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  127. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  128. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  129. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  130. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  131. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  132. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  133. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  134. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  135. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  136. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  137. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  138. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  139. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  140. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  145. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  146. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  147. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  149. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  150. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  151. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  153. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  155. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  157. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  161. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  164. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  165. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  167. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  168. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  171. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  172. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  173. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  174. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  175. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  176. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  177. package/dist/harness/index.d.ts +12 -12
  178. package/dist/harness/index.js +7 -7
  179. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  180. package/dist/harness/knowledge/boot-config.js +50 -0
  181. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  182. package/dist/harness/knowledge/client.d.ts +24 -2
  183. package/dist/harness/knowledge/client.js +19 -5
  184. package/dist/harness/knowledge/db.js +5 -0
  185. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  186. package/dist/harness/knowledge/describe-sample.js +58 -0
  187. package/dist/harness/knowledge/describe.d.ts +8 -0
  188. package/dist/harness/knowledge/describe.js +18 -2
  189. package/dist/harness/knowledge/engine-thread.js +6 -0
  190. package/dist/harness/knowledge/grounding.js +3 -1
  191. package/dist/harness/knowledge/http-app.js +35 -4
  192. package/dist/harness/knowledge/http-params.d.ts +18 -0
  193. package/dist/harness/knowledge/http-params.js +24 -0
  194. package/dist/harness/knowledge/index.d.ts +2 -0
  195. package/dist/harness/knowledge/index.js +1 -0
  196. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  197. package/dist/harness/knowledge/purge.js +5 -2
  198. package/dist/harness/knowledge/query-service.d.ts +13 -2
  199. package/dist/harness/knowledge/query-service.js +4 -2
  200. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  201. package/dist/harness/knowledge/query-worker-client.js +4 -2
  202. package/dist/harness/knowledge/query-worker.js +4 -2
  203. package/dist/harness/knowledge/read-http.js +5 -1
  204. package/dist/harness/knowledge/serve.d.ts +8 -7
  205. package/dist/harness/knowledge/serve.js +9 -0
  206. package/dist/harness/knowledge/source-store.js +26 -3
  207. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  208. package/dist/harness/knowledge/start-service-process.js +21 -9
  209. package/dist/harness/knowledge/types.d.ts +7 -0
  210. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  211. package/dist/harness/knowledge/writer-service.js +120 -14
  212. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  213. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  214. package/dist/harness/knowledge/writer-worker.js +9 -1
  215. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  216. package/dist/harness/memory/types.d.ts +6 -4
  217. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  218. package/dist/harness/memory/wisdom-formation.js +85 -22
  219. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  220. package/dist/harness/memory/wisdom-gates.js +59 -19
  221. package/dist/harness/memory/wisdom.js +9 -0
  222. package/dist/harness/observability/observer/hub.js +25 -15
  223. package/dist/harness/observability/observer/types.d.ts +10 -6
  224. package/dist/harness/run/agent/agent.d.ts +40 -21
  225. package/dist/harness/run/agent/agent.js +66 -13
  226. package/dist/harness/run/agent/index.d.ts +1 -1
  227. package/dist/harness/run/budget/budget.d.ts +28 -10
  228. package/dist/harness/run/budget/budget.js +38 -15
  229. package/dist/harness/run/model/index.d.ts +3 -1
  230. package/dist/harness/run/model/index.js +2 -1
  231. package/dist/harness/run/model/resolver.d.ts +4 -1
  232. package/dist/harness/run/model/resolver.js +36 -2
  233. package/dist/harness/run/model/run-scope.d.ts +2 -0
  234. package/dist/harness/run/model/run-scope.js +7 -0
  235. package/dist/harness/run/model/types.d.ts +22 -5
  236. package/dist/harness/run/model/types.js +3 -2
  237. package/dist/harness/run/model/window-truth.d.ts +37 -0
  238. package/dist/harness/run/model/window-truth.js +39 -0
  239. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  240. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  241. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  242. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  243. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  244. package/dist/harness/run/reliability/run-agent.js +137 -53
  245. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  246. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  247. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  248. package/dist/harness/run/run-scope.d.ts +37 -4
  249. package/dist/harness/run/runner.d.ts +44 -29
  250. package/dist/harness/run/runner.js +320 -102
  251. package/dist/harness/session/attachments/index.d.ts +1 -0
  252. package/dist/harness/session/attachments/index.js +1 -0
  253. package/dist/harness/session/attachments/inject.d.ts +21 -10
  254. package/dist/harness/session/attachments/inject.js +76 -24
  255. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  256. package/dist/harness/session/attachments/recall-index.js +219 -0
  257. package/dist/harness/session/attachments/service.d.ts +21 -0
  258. package/dist/harness/session/attachments/service.js +258 -139
  259. package/dist/harness/session/attachments/types.d.ts +6 -0
  260. package/dist/harness/session/transform-store.d.ts +136 -0
  261. package/dist/harness/session/transform-store.js +302 -0
  262. package/dist/harness/session/types.d.ts +2 -2
  263. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  264. package/dist/harness/shared/events/agent-event-map.js +3 -2
  265. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  266. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  267. package/dist/index.d.ts +14 -17
  268. package/dist/index.js +7 -9
  269. package/dist/integration/observability/metrics.d.ts +6 -6
  270. package/dist/integration/observability/metrics.js +13 -13
  271. package/dist/integration/observability/observer-bridge.js +2 -2
  272. package/dist/integration/observability/trace-collector.d.ts +5 -5
  273. package/dist/integration/observability/trace-collector.js +34 -35
  274. package/dist/integration/observability/trace-events.d.ts +3 -3
  275. package/dist/integration/observability/trace-events.js +3 -3
  276. package/dist/integration/providers/anthropic.js +14 -1
  277. package/dist/integration/providers/openai.js +7 -1
  278. package/dist/integration/providers/usage.d.ts +1 -1
  279. package/dist/integration/providers/wire-dump.d.ts +1 -1
  280. package/dist/integration/storage/archive-manager.d.ts +6 -0
  281. package/dist/integration/storage/archive-manager.js +10 -0
  282. package/dist/integration/storage/jsonl.d.ts +1 -1
  283. package/dist/integration/storage/jsonl.js +18 -16
  284. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  285. package/dist/subsystems/wisdom-steward/formation/config.yaml +1 -0
  286. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  287. package/package.json +11 -14
  288. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  289. package/dist/harness/context/hybrid-compressor.js +0 -159
  290. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  291. package/dist/harness/context/llm-summarizer.js +0 -249
  292. package/dist/harness/context/smart-router.d.ts +0 -75
  293. package/dist/harness/context/smart-router.js +0 -118
  294. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  295. package/dist/harness/context/truncate-compressor.js +0 -107
  296. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  297. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  298. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  299. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  300. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  301. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * Harness Context 模块导出
3
3
  */
4
- export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, CompactResult, AfterTurnParams, TokenEstimator, SummarizeFunction, MessageSelector, SelectResult, SelectOptions, Compressor, CompressParams, CompressResult, BudgetAllocator, BudgetAllocateParams, BudgetAllocateResult, ContextCompactReason, ContextCompactEvent, ContextEmitFn, ContextCompactSnapshot, } from './types.js';
4
+ export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, AfterStepParams, TokenEstimator, SummarizeFunction, MessageSelector, SelectResult, SelectOptions, BudgetAllocator, BudgetAllocateParams, BudgetAllocateResult, ContextCompactReason, ContextCompactEvent, ContextEmitFn, OverflowAlertEvent, ContextCompactSnapshot, } from './types.js';
5
5
  export { DefaultContextEngine } from './default-context-engine.js';
6
6
  export type { DefaultContextEngineConfig } from './default-context-engine.js';
7
7
  export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
8
8
  export type { TurnEnvelopeSlot, TurnEnvelopeParts } from './turn-envelope.js';
9
9
  export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
10
- export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
10
+ export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, } from './token-constants.js';
11
11
  export { LAYER_ORDER, LAYER_PRIORITY, LAYER_DEFAULT_SHARE, extractLayerQuery, isThinLayerQuery, hasLayerText, } from './layer-types.js';
12
12
  export type { ContextLayerId, LayerAssembleContext, LayerContent, ContextLayer, LayerManifestEntry, AssembleManifest, SystemAssembleResult, ContextAssembler, ContextAssembleParams, ExtractLayerQueryOptions, } from './layer-types.js';
13
13
  export { DefaultContextAssembler, truncateTextToTokens } from './assembler.js';
@@ -5,7 +5,7 @@ export { DefaultContextEngine } from './default-context-engine.js';
5
5
  export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
6
6
  // ── Token 估算(跨域门面;浏览器侧可直连 token-estimator / token-constants) ──
7
7
  export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
8
- export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
8
+ export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, } from './token-constants.js';
9
9
  // ── 七层内容契约与装配 ──
10
10
  export { LAYER_ORDER, LAYER_PRIORITY, LAYER_DEFAULT_SHARE, extractLayerQuery, isThinLayerQuery, hasLayerText, } from './layer-types.js';
11
11
  export { DefaultContextAssembler, truncateTextToTokens } from './assembler.js';
@@ -204,6 +204,21 @@ export interface ContextAssembleParams {
204
204
  * @returns true 表示机器插槽(快照/grounding/附件/摘要)
205
205
  */
206
206
  export declare function isEngineCarrierSource(source: unknown): boolean;
207
+ /**
208
+ * schedule notify 便签判定(turn 锚点与 LLM 视图打标共用单源)。
209
+ *
210
+ * producer 见 gateway `setNotify`:借 user 通道落库的机器留言,不开轮、
211
+ * 不跑模型;LLM 视图必须以 `<schedule_notice>` 信封包裹(convertMessage),
212
+ * 不得冒充人话(宪法 Confusables「Machine content vs human speech」)。
213
+ *
214
+ * @param msg - 消息(结构化入参)
215
+ * @returns true = schedule notify 便签
216
+ */
217
+ export declare function isScheduleNotice(msg: {
218
+ metadata?: {
219
+ delivery?: unknown;
220
+ };
221
+ }): boolean;
207
222
  /**
208
223
  * 轮次锚点判定(turn 边界类消费方:isMidTurn / compact / tool-result-aging)。
209
224
  *
@@ -90,6 +90,19 @@ const ENGINE_CARRIER_SOURCES = new Set([
90
90
  export function isEngineCarrierSource(source) {
91
91
  return ENGINE_CARRIER_SOURCES.has(source);
92
92
  }
93
+ /**
94
+ * schedule notify 便签判定(turn 锚点与 LLM 视图打标共用单源)。
95
+ *
96
+ * producer 见 gateway `setNotify`:借 user 通道落库的机器留言,不开轮、
97
+ * 不跑模型;LLM 视图必须以 `<schedule_notice>` 信封包裹(convertMessage),
98
+ * 不得冒充人话(宪法 Confusables「Machine content vs human speech」)。
99
+ *
100
+ * @param msg - 消息(结构化入参)
101
+ * @returns true = schedule notify 便签
102
+ */
103
+ export function isScheduleNotice(msg) {
104
+ return msg.metadata?.delivery === 'notify';
105
+ }
93
106
  /**
94
107
  * 轮次锚点判定(turn 边界类消费方:isMidTurn / compact / tool-result-aging)。
95
108
  *
@@ -107,7 +120,7 @@ export function isTurnAnchor(msg) {
107
120
  if (isEngineCarrierSource(msg.metadata?.source))
108
121
  return false;
109
122
  // schedule notify 是机器便签(producer 见 gateway setNotify),不是用户输入
110
- if (msg.metadata?.delivery === 'notify')
123
+ if (isScheduleNotice(msg))
111
124
  return false;
112
125
  return true;
113
126
  }
@@ -70,6 +70,17 @@ export declare class RuntimeLayer extends BaseLayer {
70
70
  });
71
71
  assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
72
72
  }
73
+ /** Plugin Collect is a budgeted Runtime snapshot, never a systemPrompt override. */
74
+ export declare class PluginRuntimeSnapshotLayer extends BaseLayer {
75
+ private readonly contributions;
76
+ constructor(contributions: readonly {
77
+ pluginId: string;
78
+ value: {
79
+ text: string;
80
+ };
81
+ }[]);
82
+ assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
83
+ }
73
84
  export declare class KnowledgeLayer extends BaseLayer {
74
85
  private readonly getCatalog;
75
86
  private readonly maxEntries;
@@ -117,21 +128,7 @@ export declare class WisdomLayer extends BaseLayer {
117
128
  private readonly select;
118
129
  private readonly onInjected?;
119
130
  constructor(options: {
120
- select: (query: string) => Promise<Array<{
121
- entry: {
122
- id: string;
123
- statement: string;
124
- scenario: {
125
- problemTypes: string[];
126
- antiScenarios?: string[];
127
- };
128
- effect: {
129
- posture?: string;
130
- questions?: string[];
131
- };
132
- };
133
- bucket: 'core' | 'scenario';
134
- }>>;
131
+ select: (query: string) => Promise<import('../memory/types.js').WisdomInjectPick[]>;
135
132
  /** S1 applied 入账(注入命中) */
136
133
  onInjected?: (ids: string[]) => void | Promise<void>;
137
134
  order?: number;
@@ -151,6 +148,8 @@ export interface CreateDefaultLayersOptions {
151
148
  wisdomStore?: import('../memory/types.js').WisdomStore;
152
149
  wisdomCoreMaxItems?: number;
153
150
  wisdomScenarioMaxItems?: number;
151
+ /** trial 轮转试用名额(wisdom.injection.trialMaxItems;缺省 2——保底曝光打破晋升死锁;0 关闭) */
152
+ wisdomTrialMaxItems?: number;
154
153
  /** trial 可见性(wisdom.injection.trialVisible;缺省 true——trial 的意义就是被试用) */
155
154
  wisdomIncludeTrial?: boolean;
156
155
  }
@@ -114,6 +114,31 @@ export class RuntimeLayer extends BaseLayer {
114
114
  return this.content(body, { dropped, sources: ['runtime'] });
115
115
  }
116
116
  }
117
+ /** Plugin Collect is a budgeted Runtime snapshot, never a systemPrompt override. */
118
+ export class PluginRuntimeSnapshotLayer extends BaseLayer {
119
+ contributions;
120
+ constructor(contributions) {
121
+ super('runtime', { placement: 'snapshot', order: 75 });
122
+ this.contributions = contributions;
123
+ }
124
+ async assemble(ctx) {
125
+ const body = this.contributions
126
+ .map(({ pluginId, value }) => `<plugin-contribution plugin="${escapeXmlAttribute(pluginId)}">\n${escapeXmlText(value.text)}\n</plugin-contribution>`)
127
+ .join('\n\n');
128
+ const { text, dropped } = this.truncateToBudget(body, ctx.tokenBudget);
129
+ return this.content(text, {
130
+ dropped,
131
+ sources: this.contributions.map(({ pluginId }) => `plugin:${pluginId}`),
132
+ });
133
+ }
134
+ }
135
+ function escapeXmlAttribute(value) {
136
+ return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;');
137
+ }
138
+ /** Contribution text is data, not markup: escape it so a plugin cannot forge sibling tags or close the slot. */
139
+ function escapeXmlText(value) {
140
+ return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
141
+ }
117
142
  // ── Knowledge(Tier 0 catalog;内容命中不进 system) ──
118
143
  function resolveCatalogList(provider, ctx) {
119
144
  if (typeof provider !== 'function')
@@ -162,8 +187,11 @@ export class KnowledgeLayer extends BaseLayer {
162
187
  const head = `- ${tags.join(' ')}`;
163
188
  const lines = [head];
164
189
  const desc = item.description?.trim();
165
- if (desc)
166
- lines.push(` purpose: ${desc}`);
190
+ // 强制标注(2026-11-02):LLM 生成的描述会注入 prompt,必须可溯源;
191
+ // heuristic 文本自带 "derived:" 前缀、human 为权威默认,均不加标
192
+ if (desc) {
193
+ lines.push(item.descriptionSource === 'llm' ? ` purpose: [llm] ${desc}` : ` purpose: ${desc}`);
194
+ }
167
195
  if (item.topics?.length)
168
196
  lines.push(` topics: ${item.topics.join(' · ')}`);
169
197
  return lines.join('\n');
@@ -342,14 +370,15 @@ export class WisdomLayer extends BaseLayer {
342
370
  return null;
343
371
  const text = `# 思维框架\n\n${body}`;
344
372
  const { text: truncated, dropped } = this.truncateToBudget(text, ctx.tokenBudget);
345
- // S1:只对实际留在文本里的条目记 applied / 报 sources——
346
- // truncate 粗滤会裁掉尾部条目,被裁掉的不入账(applied 是归因环地基,宁缺勿滥)
347
- const keptIds = picks
348
- .filter((p) => truncated.includes(p.entry.statement))
349
- .map((p) => p.entry.id);
350
- if (this.onInjected && keptIds.length) {
373
+ // S1:只对实际留在文本里的条目报 sources——truncate 粗滤会裁掉尾部条目,被裁掉的不入账。
374
+ // applied 只记 core/scenario 命中:trial 轮转是保底曝光(bucket='trial'),入账 applied 会
375
+ // 稀释 contestRate、废掉 zero-apply 淘汰、抬高 utility——曝光与「被使用」是两件事。
376
+ // sources 仍含 trial(归因窗口需要真实注入清单,判官才能裁 assisted)。
377
+ const kept = picks.filter((p) => truncated.includes(p.entry.statement));
378
+ const appliedIds = kept.filter((p) => p.bucket !== 'trial').map((p) => p.entry.id);
379
+ if (this.onInjected && appliedIds.length) {
351
380
  try {
352
- await this.onInjected(keptIds);
381
+ await this.onInjected(appliedIds);
353
382
  }
354
383
  catch {
355
384
  // 入账失败不拖垮装配;结局环可由 evaluate 兜
@@ -357,7 +386,7 @@ export class WisdomLayer extends BaseLayer {
357
386
  }
358
387
  return this.content(truncated, {
359
388
  dropped,
360
- sources: keptIds,
389
+ sources: kept.map((p) => p.entry.id),
361
390
  });
362
391
  }
363
392
  }
@@ -377,9 +406,10 @@ export function createDefaultLayers(options) {
377
406
  text: query,
378
407
  coreMaxItems: options.wisdomCoreMaxItems,
379
408
  scenarioMaxItems: options.wisdomScenarioMaxItems,
409
+ trialMaxItems: options.wisdomTrialMaxItems,
380
410
  includeTrial: options.wisdomIncludeTrial,
381
411
  });
382
- return picks.map((p) => ({ entry: p.entry, bucket: p.bucket }));
412
+ return picks;
383
413
  },
384
414
  onInjected: (ids) => store.touchApplied(ids),
385
415
  }));
@@ -25,20 +25,22 @@ export declare class DefaultMessageSelector implements MessageSelector {
25
25
  * 从头部开始选择消息,直到达到 token 预算
26
26
  *
27
27
  * 边界对齐:不拆分 tool_call/tool_result 对。
28
+ *
29
+ * @param messages - 候选消息(原文)
30
+ * @param budget - token 预算
31
+ * @param estimator - 估算器
32
+ * @param measure - 与 messages 等长同序的度量视图(省略时量原文)
28
33
  */
29
34
  private selectByTokenBudget;
30
35
  /**
31
36
  * 从尾部开始选择消息,直到达到 token 预算
32
37
  *
33
38
  * 边界对齐:不拆分 tool_call/tool_result 对。
39
+ *
40
+ * @param messages - 候选消息(原文)
41
+ * @param budget - token 预算
42
+ * @param estimator - 估算器
43
+ * @param measure - 与 messages 等长同序的度量视图(省略时量原文)
34
44
  */
35
45
  private selectByTokenBudgetFromEnd;
36
- /**
37
- * 检查消息是否是工具结果
38
- */
39
- private isToolResult;
40
- /**
41
- * 检查消息是否包含工具调用
42
- */
43
- private hasToolCall;
44
46
  }
@@ -10,6 +10,7 @@
10
10
  * 边界对齐:不拆分 tool_call/tool_result 对。
11
11
  */
12
12
  import { HeuristicTokenEstimator } from './token-estimator.js';
13
+ import { hasToolCall, isToolResultMessage } from './capabilities/compact/messages.js';
13
14
  export class DefaultMessageSelector {
14
15
  /**
15
16
  * 选择要保留的消息
@@ -22,6 +23,19 @@ export class DefaultMessageSelector {
22
23
  select(messages, options, tokenEstimator) {
23
24
  const estimator = tokenEstimator ?? new HeuristicTokenEstimator();
24
25
  const { maxTokens, protectFirstN, protectLastN } = options;
26
+ // 度量视图(可选):与 messages 等长同序,仅用于估算;切分仍按原文。
27
+ // 不传时退化为原行为(量原文)。
28
+ const measure = options.measureMessages ?? messages;
29
+ /**
30
+ * 估算字节区间 [start, end) 的 token 数(按度量视图的同下标取值)
31
+ */
32
+ const estimateRange = (start, end) => {
33
+ let tokens = 0;
34
+ for (let i = start; i < end; i++) {
35
+ tokens += estimator.estimateMessage(measure[i] ?? messages[i]);
36
+ }
37
+ return tokens;
38
+ };
25
39
  // 空消息列表
26
40
  if (messages.length === 0) {
27
41
  return {
@@ -43,10 +57,11 @@ export class DefaultMessageSelector {
43
57
  const tailMessages = tailCount > 0 ? remainingAfterHead.slice(-tailCount) : [];
44
58
  // 3. 中间区域(可压缩/丢弃)
45
59
  const middleMessages = tailCount > 0 ? remainingAfterHead.slice(0, -tailCount) : remainingAfterHead;
46
- // 4. 计算各区域 token 数
47
- const headTokens = estimator.estimateMessages(headMessages);
48
- const tailTokens = estimator.estimateMessages(tailMessages);
49
- const middleTokens = estimator.estimateMessages(middleMessages);
60
+ // 4. 计算各区域 token 数(按度量视图;区域下标以原文为准)
61
+ const headTokens = estimateRange(0, headCount);
62
+ const tailStartIdx = messages.length - tailMessages.length;
63
+ const tailTokens = estimateRange(tailStartIdx, messages.length);
64
+ const middleTokens = estimateRange(headCount, tailStartIdx);
50
65
  // 5. 计算可用预算
51
66
  const fixedTokens = headTokens + tailTokens;
52
67
  // 如果固定区域已超预算,需要截断尾部
@@ -65,7 +80,7 @@ export class DefaultMessageSelector {
65
80
  }
66
81
  // 保留头部 + 部分尾部
67
82
  const availableForTail = maxTokens - headTokens;
68
- const selectedTail = this.selectByTokenBudget(tailMessages, availableForTail, estimator);
83
+ const selectedTail = this.selectByTokenBudget(tailMessages, availableForTail, estimator, measure.slice(tailStartIdx));
69
84
  return {
70
85
  kept: [...headMessages, ...selectedTail],
71
86
  overflow: middleMessages,
@@ -90,8 +105,17 @@ export class DefaultMessageSelector {
90
105
  };
91
106
  }
92
107
  // 7. 中间区域需要压缩:从尾部开始保留(越新的越重要)
93
- const selectedMiddle = this.selectByTokenBudgetFromEnd(middleMessages, middleBudget, estimator);
94
- const selectedMiddleTokens = estimator.estimateMessages(selectedMiddle);
108
+ const selectedMiddle = this.selectByTokenBudgetFromEnd(middleMessages, middleBudget, estimator, measure.slice(headCount, tailStartIdx));
109
+ // 选中段可能因配对对齐而不连续(跳过孤立 tool_call/result),
110
+ // 所以按成员精确累加,不能用「长度差」推算起点。
111
+ const selectedMiddleSet = new Set(selectedMiddle);
112
+ let selectedMiddleTokens = 0;
113
+ for (let i = headCount; i < tailStartIdx; i++) {
114
+ const m = messages[i];
115
+ if (selectedMiddleSet.has(m)) {
116
+ selectedMiddleTokens += estimator.estimateMessage(measure[i] ?? m);
117
+ }
118
+ }
95
119
  const kept = [...headMessages, ...selectedMiddle, ...tailMessages];
96
120
  const overflow = middleMessages.slice(0, middleMessages.length - selectedMiddle.length);
97
121
  return {
@@ -107,19 +131,24 @@ export class DefaultMessageSelector {
107
131
  * 从头部开始选择消息,直到达到 token 预算
108
132
  *
109
133
  * 边界对齐:不拆分 tool_call/tool_result 对。
134
+ *
135
+ * @param messages - 候选消息(原文)
136
+ * @param budget - token 预算
137
+ * @param estimator - 估算器
138
+ * @param measure - 与 messages 等长同序的度量视图(省略时量原文)
110
139
  */
111
- selectByTokenBudget(messages, budget, estimator) {
140
+ selectByTokenBudget(messages, budget, estimator, measure) {
112
141
  const selected = [];
113
142
  const selectedSet = new Set();
114
143
  let usedTokens = 0;
115
144
  for (let i = 0; i < messages.length; i++) {
116
145
  const msg = messages[i];
117
- const msgTokens = estimator.estimateMessage(msg);
146
+ const msgTokens = estimator.estimateMessage(measure?.[i] ?? msg);
118
147
  // 检查是否需要边界对齐
119
- if (this.isToolResult(msg) && i > 0) {
148
+ if (isToolResultMessage(msg) && i > 0) {
120
149
  // tool_result 消息必须和前面的 tool_call 消息一起保留
121
150
  const prevMsg = messages[i - 1];
122
- if (this.hasToolCall(prevMsg)) {
151
+ if (hasToolCall(prevMsg)) {
123
152
  // 确保 tool_call 已被选中
124
153
  const prevInSelected = selectedSet.has(prevMsg);
125
154
  if (!prevInSelected) {
@@ -141,18 +170,23 @@ export class DefaultMessageSelector {
141
170
  * 从尾部开始选择消息,直到达到 token 预算
142
171
  *
143
172
  * 边界对齐:不拆分 tool_call/tool_result 对。
173
+ *
174
+ * @param messages - 候选消息(原文)
175
+ * @param budget - token 预算
176
+ * @param estimator - 估算器
177
+ * @param measure - 与 messages 等长同序的度量视图(省略时量原文)
144
178
  */
145
- selectByTokenBudgetFromEnd(messages, budget, estimator) {
179
+ selectByTokenBudgetFromEnd(messages, budget, estimator, measure) {
146
180
  const selected = [];
147
181
  const selectedSet = new Set();
148
182
  let usedTokens = 0;
149
183
  for (let i = messages.length - 1; i >= 0; i--) {
150
184
  const msg = messages[i];
151
- const msgTokens = estimator.estimateMessage(msg);
185
+ const msgTokens = estimator.estimateMessage(measure?.[i] ?? msg);
152
186
  // 边界对齐:如果这是 tool_call 消息,检查后面的 tool_result
153
- if (this.hasToolCall(msg) && i < messages.length - 1) {
187
+ if (hasToolCall(msg) && i < messages.length - 1) {
154
188
  const nextMsg = messages[i + 1];
155
- if (this.isToolResult(nextMsg)) {
189
+ if (isToolResultMessage(nextMsg)) {
156
190
  // 确保 tool_result 已被选中
157
191
  const nextInSelected = selectedSet.has(nextMsg);
158
192
  if (!nextInSelected) {
@@ -170,16 +204,4 @@ export class DefaultMessageSelector {
170
204
  }
171
205
  return selected;
172
206
  }
173
- /**
174
- * 检查消息是否是工具结果
175
- */
176
- isToolResult(msg) {
177
- return msg.role === 'tool' || (msg.toolResults !== undefined && msg.toolResults.length > 0);
178
- }
179
- /**
180
- * 检查消息是否包含工具调用
181
- */
182
- hasToolCall(msg) {
183
- return msg.role === 'assistant' && msg.toolCalls !== undefined && msg.toolCalls.length > 0;
184
- }
185
207
  }
@@ -17,9 +17,9 @@ export interface CreateProviderSummarizeOptions {
17
17
  /**
18
18
  * 创建基于 ModelProvider 的摘要函数
19
19
  *
20
- * @param provider - 用于调用的模型提供者(宜用 mini/便宜档)
20
+ * @param provider - 用于调用的模型提供者
21
21
  * @param options - 模型名与温度
22
- * @returns SummarizeFunction;调用失败向上抛出,由 HybridCompressor 回退截断
22
+ * @returns SummarizeFunction;调用失败向上抛出,由 compact 能力机械降级阶梯兜底
23
23
  */
24
24
  export declare function createProviderSummarize(provider: ModelProvider, options?: CreateProviderSummarizeOptions): SummarizeFunction;
25
25
  /**
@@ -7,9 +7,9 @@
7
7
  /**
8
8
  * 创建基于 ModelProvider 的摘要函数
9
9
  *
10
- * @param provider - 用于调用的模型提供者(宜用 mini/便宜档)
10
+ * @param provider - 用于调用的模型提供者
11
11
  * @param options - 模型名与温度
12
- * @returns SummarizeFunction;调用失败向上抛出,由 HybridCompressor 回退截断
12
+ * @returns SummarizeFunction;调用失败向上抛出,由 compact 能力机械降级阶梯兜底
13
13
  */
14
14
  export function createProviderSummarize(provider, options) {
15
15
  return async (messages, opts) => {
@@ -18,12 +18,19 @@ export function createProviderSummarize(provider, options) {
18
18
  model: options?.model,
19
19
  // 未显式配置即不发送:由模型配置(ModelInfo.temperature)或服务端默认决定
20
20
  temperature: options?.temperature,
21
+ // P3:run 中止 / 摘要超时都靠这个 signal 取消在飞请求(provider 侧 fetch 已接 signal)
22
+ ...(opts?.signal ? { signal: opts.signal } : {}),
21
23
  // 源头钳制(评审 F6):三条摘要路径(manual/proactive/overflow)共用本闭包,
22
24
  // 硬顶不得越过模型实际输出上限,否则窗口钳制在大窗口下仍会顶穿被 provider 400
23
25
  maxTokens: options?.maxOutputTokens && options.maxOutputTokens > 0
24
26
  ? Math.min(opts?.maxTokens ?? options.maxOutputTokens, options.maxOutputTokens)
25
27
  : opts?.maxTokens,
26
28
  });
29
+ // usage 回传(2026-11-08 outputTokens 真值):摘要产物体量的真值通道,
30
+ // 供压缩计量以真值替代估算(契约见 SummarizeFunction.onUsage)
31
+ if (response.usage && response.usage.outputTokens > 0) {
32
+ opts?.onUsage?.({ outputTokens: response.usage.outputTokens });
33
+ }
27
34
  return response.content;
28
35
  };
29
36
  }
@@ -78,6 +78,8 @@ export declare function createDefaultSystemPromptAssembler(options?: {
78
78
  /** Wisdom 注入条数硬顶 */
79
79
  wisdomCoreMaxItems?: number;
80
80
  wisdomScenarioMaxItems?: number;
81
+ /** trial 轮转试用名额(wisdom.injection.trialMaxItems;缺省 2——保底曝光打破晋升死锁;0 关闭) */
82
+ wisdomTrialMaxItems?: number;
81
83
  /** trial 可见性(wisdom.injection.trialVisible;缺省 true——trial 的意义就是被试用) */
82
84
  wisdomIncludeTrial?: boolean;
83
85
  cognitionStore?: ConceptGraphStore;
@@ -115,9 +115,10 @@ export function createDefaultSystemPromptAssembler(options) {
115
115
  text: query,
116
116
  coreMaxItems: options?.wisdomCoreMaxItems,
117
117
  scenarioMaxItems: options?.wisdomScenarioMaxItems,
118
+ trialMaxItems: options?.wisdomTrialMaxItems,
118
119
  includeTrial: options?.wisdomIncludeTrial,
119
120
  });
120
- return picks.map((p) => ({ entry: p.entry, bucket: p.bucket }));
121
+ return picks;
121
122
  },
122
123
  onInjected: (ids) => wisdomStore.touchApplied(ids),
123
124
  }));
@@ -6,10 +6,14 @@
6
6
  */
7
7
  /** 通用文本:英文约 4 chars/token,中文约 1 char/token */
8
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;
9
+ /** 工具结果:结构化输出更密集,约 1.7 chars/token(2026-11-08 生产样本拟合:原 2 系统低估 ~40%) */
10
+ export declare const TOOL_RESULT_CHARS_PER_TOKEN = 1.7;
11
+ /** JSON 负载(schema / arguments):结构符号多,约 2 chars/token(2026-11-08 样本拟合调低;与 tr 档共线,取业界密度区间居中,勿硬拟合) */
12
+ export declare const JSON_CHARS_PER_TOKEN = 2;
13
+ /** 中文等 CJK:1 token/字 */
14
+ export declare const TEXT_CJK_CHARS_PER_TOKEN = 1;
15
+ /** 代码 / 标识符:约 3 chars/token */
16
+ export declare const CODE_CHARS_PER_TOKEN = 3;
13
17
  /** 消息结构开销(role + 分隔符 + 边界标记) */
14
18
  export declare const MESSAGE_OVERHEAD_TOKENS = 12;
15
19
  /** 安全余量系数:补偿估算不准 */
@@ -20,5 +24,3 @@ export declare const IMAGE_TOKEN_ESTIMATE = 1200;
20
24
  export declare const AUDIO_TOKEN_ESTIMATE = 30;
21
25
  /** 视频 token 估算(抽帧处理,假设 10 帧 × 85 token) */
22
26
  export declare const VIDEO_TOKEN_ESTIMATE = 850;
23
- /** 超长文本采样阈值(字符数) */
24
- export declare const SAMPLE_THRESHOLD = 2000;
@@ -7,10 +7,14 @@
7
7
  // ── 字符/token 比率 ──
8
8
  /** 通用文本:英文约 4 chars/token,中文约 1 char/token */
9
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;
10
+ /** 工具结果:结构化输出更密集,约 1.7 chars/token(2026-11-08 生产样本拟合:原 2 系统低估 ~40%) */
11
+ export const TOOL_RESULT_CHARS_PER_TOKEN = 1.7;
12
+ /** JSON 负载(schema / arguments):结构符号多,约 2 chars/token(2026-11-08 样本拟合调低;与 tr 档共线,取业界密度区间居中,勿硬拟合) */
13
+ export const JSON_CHARS_PER_TOKEN = 2;
14
+ /** 中文等 CJK:1 token/字 */
15
+ export const TEXT_CJK_CHARS_PER_TOKEN = 1;
16
+ /** 代码 / 标识符:约 3 chars/token */
17
+ export const CODE_CHARS_PER_TOKEN = 3;
14
18
  /** 消息结构开销(role + 分隔符 + 边界标记) */
15
19
  export const MESSAGE_OVERHEAD_TOKENS = 12;
16
20
  /** 安全余量系数:补偿估算不准 */
@@ -22,6 +26,3 @@ export const IMAGE_TOKEN_ESTIMATE = 1200;
22
26
  export const AUDIO_TOKEN_ESTIMATE = 30;
23
27
  /** 视频 token 估算(抽帧处理,假设 10 帧 × 85 token) */
24
28
  export const VIDEO_TOKEN_ESTIMATE = 850;
25
- // ── 采样策略 ──
26
- /** 超长文本采样阈值(字符数) */
27
- export const SAMPLE_THRESHOLD = 2000;
@@ -1,50 +1,59 @@
1
1
  /**
2
- * Token 估算纯函数(Harness 内部原语)
2
+ * Token 估算 adapter(内容形状 → Segment → 唯一计数)
3
3
  *
4
- * 不依赖 Message / LLMMessage 等领域类型,只做「内容 → token 数」。
5
- * 由 `token-estimator.ts` 组装为 `TokenEstimator` 实现,也可被同层模块直接复用。
4
+ * 不依赖 Message / LLMMessage 等领域类型,只做「内容形状 → token 数」。
5
+ * 计数逻辑全部委托 {@link estimateSegments}(P1-c:单实现 + 两 adapter);
6
+ * 本模块是「松散形状」adapter,领域/LLM 两入口的形状归一在 `token-estimator.ts`。
6
7
  *
7
- * 三层策略:
8
- * 1. 优先使用 LLM 返回的实际 token 数(外部回写)
9
- * 2. 次选:专用 tokenizer(如 tiktoken)- 未来扩展
10
- * 3. 兜底:启发式估算,按内容类型使用不同比率
8
+ * R4 红线:不得返回常数兜底——未知内容块按载荷长度计,且**告警**(分类表缺失必须可见,
9
+ * 每 type 限频 1 条/小时,防高频估算路径刷屏)。
11
10
  */
12
- /**
13
- * CJK 感知的等效字符数计算
14
- *
15
- * 每个 CJK 字符计为 CHARS_PER_TOKEN 个等效字符,
16
- * 这样 `adjustedChars / CHARS_PER_TOKEN` 能得到准确的 token 估算。
17
- *
18
- * @param text 原始文本
19
- * @returns CJK 加权后的等效字符数
20
- */
21
- export declare function estimateAdjustedChars(text: string): number;
11
+ import { JSON_CHARS_PER_TOKEN } from './token-constants.js';
12
+ import { type Segment } from './token-segments.js';
22
13
  /**
23
14
  * 估算单段文本的 token 数
24
15
  *
25
- * 使用 CJK 感知的等效字符数 + 采样策略。
26
- *
27
16
  * @param text 原始文本
28
17
  * @returns 估算 token 数
29
18
  */
30
19
  export declare function estimateTextTokens(text: string): number;
31
20
  /**
32
- * 估算单个 content block 的 token 数
21
+ * 内容块 → Segment(分类归一;media 固定成本继承旧常量)
33
22
  *
34
- * 统一处理 text / image / audio(含 OpenAI 的 input_audio)/ video。
23
+ * 图像接受三种同价形态:原生 `image` 与转换后的 `image_url` / `input_image`
24
+ * (convertMessage 产出 image_url——旧版漏认导致图像按 0 计)。
25
+ * 未知块类型按实际载荷长度计(R4:无常数兜底):正文走 CJK 分类文本口径;
26
+ * 无正文按指针字段(name/url/src/path/filename)长度计——不序列化内嵌 base64
27
+ * 载荷(会虚高),无载荷即 0(不猜)。
35
28
  *
36
29
  * @param block ContentBlock(至少含 type,text 块需含 text)
37
- * @returns 估算 token 数
30
+ * @returns 归一化片段
38
31
  */
39
- export declare function estimateContentBlock(block: {
32
+ export declare function contentBlockSegment(block: {
40
33
  type?: string;
41
34
  text?: string;
42
- }): number;
35
+ name?: string;
36
+ url?: string;
37
+ src?: string;
38
+ path?: string;
39
+ filename?: string;
40
+ mimeType?: string;
41
+ }): Segment;
43
42
  /**
44
- * 估算工具调用 JSON 的 token 数
43
+ * 估算单个 content block 的 token 数
44
+ *
45
+ * @param block ContentBlock(至少含 type;text 块需含 text;未知块可带指针字段)
46
+ * @returns 估算 token 数
47
+ */
48
+ export declare function estimateContentBlock(block: Parameters<typeof contentBlockSegment>[0]): number;
49
+ /**
50
+ * 工具调用 → tool_use 段
45
51
  *
46
- * 工具调用的 JSON 结构符号多,token 密度更高。
47
52
  * `arguments` 已是字符串时直接用长度,避免二次 JSON.stringify。
53
+ */
54
+ export declare function toolCallSegment(name: string | undefined, args: unknown): Segment;
55
+ /**
56
+ * 估算工具调用 JSON 的 token 数
48
57
  *
49
58
  * @param toolCalls `{ name?, arguments? }` 形态的工具调用列表
50
59
  * @returns 估算 token 数
@@ -57,7 +66,7 @@ export declare function estimateToolCallTokens(toolCalls: Array<{
57
66
  * 估算松散结构消息列表的 token 数
58
67
  *
59
68
  * 支持 string 和 ContentBlock[] 两种 content 格式,含消息结构开销。
60
- * 适用于无强类型 Message / LLMMessage 的调用方。
69
+ * 适用于无强类型 Message / LLMMessage 的调用方(knowledge grounding 等)。
61
70
  *
62
71
  * @param messages `{ content?, role? }` 形态的消息列表
63
72
  * @returns 估算 token 数
@@ -66,3 +75,4 @@ export declare function estimateTokens(messages: Array<{
66
75
  content?: string | unknown[] | null;
67
76
  role?: string;
68
77
  }>): number;
78
+ export { JSON_CHARS_PER_TOKEN };