@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -22,6 +22,8 @@ const DEFAULT_CONFIG = {
22
22
  filePrefix: 'trace',
23
23
  sync: false,
24
24
  };
25
+ /** 进程内 trace 文件序号(同毫秒多实例防撞) */
26
+ let fileSeq = 0;
25
27
  /**
26
28
  * TraceLogger
27
29
  */
@@ -35,26 +37,34 @@ export class TraceLogger {
35
37
  this.config = { ...DEFAULT_CONFIG, ...config };
36
38
  // 初始化导出器
37
39
  this.exporters = config?.exporters ?? [];
38
- // 初始化文件输出(兼容旧的 outputDir 模式)
40
+ // 初始化文件输出(兼容旧的 outputDir 模式)。失败 fail-open:观测绝不影响业务构建
39
41
  if (this.config.outputDir) {
40
42
  const dir = this.config.outputDir;
41
- if (!existsSync(dir)) {
42
- mkdirSync(dir, { recursive: true });
43
+ try {
44
+ if (!existsSync(dir)) {
45
+ mkdirSync(dir, { recursive: true });
46
+ }
47
+ // 文件名唯一化:毫秒时间戳 + pid + 进程内序号(同秒多 agent / 多实例不共写一个文件)
48
+ const ts = new Date().toISOString().replace(/[:.]/g, '-');
49
+ const prefix = this.config.filePrefix ?? 'trace';
50
+ this.filePath = join(dir, `${prefix}-${ts}-${process.pid}-${++fileSeq}.jsonl`);
51
+ // 写入 trace 头部
52
+ this.writeToFile({
53
+ ts: this.startTime,
54
+ level: TraceLevel.INFO,
55
+ type: 'trace.start',
56
+ data: {
57
+ level: TRACE_LEVEL_NAMES[this.config.level],
58
+ outputDir: this.config.outputDir,
59
+ filePath: this.filePath,
60
+ },
61
+ });
62
+ }
63
+ catch (err) {
64
+ // 目录不可用(非法路径/只读):禁用文件通道并告警一次;writeToFile 的空 catch 是写期瞬时失败兜底
65
+ this.filePath = undefined;
66
+ console.warn(`[observability] trace file output disabled (${dir}): ${err instanceof Error ? err.message : String(err)}`);
43
67
  }
44
- const ts = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
45
- const prefix = this.config.filePrefix ?? 'trace';
46
- this.filePath = join(dir, `${prefix}-${ts}.jsonl`);
47
- // 写入 trace 头部
48
- this.writeToFile({
49
- ts: this.startTime,
50
- level: TraceLevel.INFO,
51
- type: 'trace.start',
52
- data: {
53
- level: TRACE_LEVEL_NAMES[this.config.level],
54
- outputDir: this.config.outputDir,
55
- filePath: this.filePath,
56
- },
57
- });
58
68
  }
59
69
  }
60
70
  /**
@@ -72,6 +72,16 @@ export declare class AnthropicProvider implements ModelProvider {
72
72
  * 检查 provider 是否可用
73
73
  */
74
74
  isAvailable(): Promise<boolean>;
75
+ /**
76
+ * 构造实际发送的请求体(wire dump 观测用)
77
+ *
78
+ * 与 chat/stream 共用 {@link toAnthropicRequest},保证落盘内容与真实请求一致。
79
+ *
80
+ * @param request - 原始 LLM 请求
81
+ * @param mode - chat 或 stream
82
+ * @returns 实际发送的请求体
83
+ */
84
+ wireBodyFor(request: LLMRequest, mode: 'chat' | 'stream'): Record<string, unknown>;
75
85
  /**
76
86
  * OpenAI 格式 → Anthropic 格式
77
87
  */
@@ -196,6 +196,9 @@ export class AnthropicProvider {
196
196
  if (delta?.type === 'text_delta') {
197
197
  yield { type: 'content', content: delta.text ?? '' };
198
198
  }
199
+ else if (delta?.type === 'thinking_delta') {
200
+ yield { type: 'reasoning', content: delta.thinking ?? '' };
201
+ }
199
202
  else if (delta?.type === 'input_json_delta') {
200
203
  toolArgsBuffer += delta.partial_json ?? '';
201
204
  }
@@ -283,6 +286,19 @@ export class AnthropicProvider {
283
286
  }
284
287
  }
285
288
  // ===== 格式转换 =====
289
+ /**
290
+ * 构造实际发送的请求体(wire dump 观测用)
291
+ *
292
+ * 与 chat/stream 共用 {@link toAnthropicRequest},保证落盘内容与真实请求一致。
293
+ *
294
+ * @param request - 原始 LLM 请求
295
+ * @param mode - chat 或 stream
296
+ * @returns 实际发送的请求体
297
+ */
298
+ wireBodyFor(request, mode) {
299
+ const body = this.toAnthropicRequest(request);
300
+ return mode === 'stream' ? { ...body, stream: true } : body;
301
+ }
286
302
  /**
287
303
  * OpenAI 格式 → Anthropic 格式
288
304
  */
@@ -376,7 +392,7 @@ export class AnthropicProvider {
376
392
  return {
377
393
  name: fn?.name ?? tool.name,
378
394
  description: fn?.description ?? tool.description,
379
- input_schema: fn?.parameters ?? tool.parameters ?? { type: 'object', properties: {} },
395
+ input_schema: stripSchemaKeywords(fn?.parameters ?? tool.parameters ?? { type: 'object', properties: {} }),
380
396
  };
381
397
  }
382
398
  /**
@@ -430,3 +446,30 @@ export class AnthropicProvider {
430
446
  }
431
447
  }
432
448
  }
449
+ /** 去掉部分 API 会拒绝的 JSON Schema 扩展关键字 */
450
+ function stripSchemaKeywords(node) {
451
+ if (Array.isArray(node))
452
+ return node.map(stripSchemaKeywords);
453
+ if (!node || typeof node !== 'object')
454
+ return node;
455
+ const src = node;
456
+ const out = {};
457
+ if (typeof src.type === 'string')
458
+ out.type = src.type;
459
+ if (typeof src.description === 'string')
460
+ out.description = src.description;
461
+ if (Array.isArray(src.enum))
462
+ out.enum = src.enum;
463
+ if (src.properties && typeof src.properties === 'object') {
464
+ const props = {};
465
+ for (const [k, v] of Object.entries(src.properties)) {
466
+ props[k] = stripSchemaKeywords(v);
467
+ }
468
+ out.properties = props;
469
+ }
470
+ if (Array.isArray(src.required))
471
+ out.required = src.required.filter((x) => typeof x === 'string');
472
+ if (src.items !== undefined)
473
+ out.items = stripSchemaKeywords(src.items);
474
+ return out;
475
+ }
@@ -76,6 +76,16 @@ export declare class OpenAIProvider implements ModelProvider {
76
76
  * 检查 provider 是否可用
77
77
  */
78
78
  isAvailable(): Promise<boolean>;
79
+ /**
80
+ * 构造实际发送的请求体(wire dump 观测用)
81
+ *
82
+ * 与 chat/stream 共用 {@link buildRequestBody},保证落盘内容与真实请求一致。
83
+ *
84
+ * @param request - 原始 LLM 请求
85
+ * @param mode - chat 或 stream
86
+ * @returns 实际发送的请求体
87
+ */
88
+ wireBodyFor(request: LLMRequest, mode: 'chat' | 'stream'): Record<string, unknown>;
79
89
  /**
80
90
  * 构建 OpenAI API 请求体
81
91
  */
@@ -217,6 +217,21 @@ export class OpenAIProvider {
217
217
  // ================================================================
218
218
  // 内部方法
219
219
  // ================================================================
220
+ /**
221
+ * 构造实际发送的请求体(wire dump 观测用)
222
+ *
223
+ * 与 chat/stream 共用 {@link buildRequestBody},保证落盘内容与真实请求一致。
224
+ *
225
+ * @param request - 原始 LLM 请求
226
+ * @param mode - chat 或 stream
227
+ * @returns 实际发送的请求体
228
+ */
229
+ wireBodyFor(request, mode) {
230
+ const body = this.buildRequestBody(request);
231
+ return mode === 'stream'
232
+ ? { ...body, stream: true, stream_options: { include_usage: true } }
233
+ : body;
234
+ }
220
235
  /**
221
236
  * 构建 OpenAI API 请求体
222
237
  */
@@ -238,7 +253,19 @@ export class OpenAIProvider {
238
253
  body.max_tokens = cap;
239
254
  }
240
255
  if (request.tools && request.tools.length > 0) {
241
- body.tools = request.tools;
256
+ // 兼容接口可能拒绝 maxLength 等未知 schema 关键字
257
+ body.tools = request.tools.map((tool) => {
258
+ const params = tool?.function?.parameters;
259
+ if (!params)
260
+ return tool;
261
+ return {
262
+ ...tool,
263
+ function: {
264
+ ...tool.function,
265
+ parameters: sanitizeOpenAiJsonSchema(params),
266
+ },
267
+ };
268
+ });
242
269
  }
243
270
  return body;
244
271
  }
@@ -387,7 +414,9 @@ export class OpenAIProvider {
387
414
  if (delta.content)
388
415
  chunks.push({ type: 'content', content: delta.content });
389
416
  if (delta.reasoning)
390
- chunks.push({ type: 'content', content: delta.reasoning });
417
+ chunks.push({ type: 'reasoning', content: delta.reasoning });
418
+ if (delta.reasoning_content)
419
+ chunks.push({ type: 'reasoning', content: delta.reasoning_content });
391
420
  if (delta.tool_calls) {
392
421
  for (const tc of delta.tool_calls) {
393
422
  const idx = tc.index ?? 0;
@@ -427,3 +456,30 @@ export class OpenAIProvider {
427
456
  }
428
457
  }
429
458
  }
459
+ /** 仅保留 OpenAI function calling 可识别的 JSON Schema 关键字 */
460
+ function sanitizeOpenAiJsonSchema(node) {
461
+ if (Array.isArray(node))
462
+ return node.map(sanitizeOpenAiJsonSchema);
463
+ if (!node || typeof node !== 'object')
464
+ return node;
465
+ const src = node;
466
+ const out = {};
467
+ if (typeof src.type === 'string')
468
+ out.type = src.type;
469
+ if (typeof src.description === 'string')
470
+ out.description = src.description;
471
+ if (Array.isArray(src.enum))
472
+ out.enum = src.enum;
473
+ if (src.properties && typeof src.properties === 'object') {
474
+ const props = {};
475
+ for (const [k, v] of Object.entries(src.properties)) {
476
+ props[k] = sanitizeOpenAiJsonSchema(v);
477
+ }
478
+ out.properties = props;
479
+ }
480
+ if (Array.isArray(src.required))
481
+ out.required = src.required.filter((x) => typeof x === 'string');
482
+ if (src.items !== undefined)
483
+ out.items = sanitizeOpenAiJsonSchema(src.items);
484
+ return out;
485
+ }
@@ -0,0 +1,191 @@
1
+ /**
2
+ * LLM Wire Dump — 前缀比对分析
3
+ *
4
+ * 读 `<dir>/<session>/index.jsonl`,按时间顺序把相邻两次调用逐条比对,
5
+ * 回答「前缀在哪一条消息、哪个字符断开」。
6
+ *
7
+ * 判据:前缀缓存只认最长公共前缀,因此相邻调用的 `messages` 序列逐单元 hash 比对
8
+ * 即是 provider 的缓存判据(tools 变化单独标记)。
9
+ *
10
+ * @module integration/providers/wire-dump-diff
11
+ */
12
+ import { type WireDumpRequestRecord, type WireDumpResultRecord } from './wire-dump.js';
13
+ /** 一次调用的合并视图(request 行 + 可选 result 行) */
14
+ export interface WireCallSummary {
15
+ request: WireDumpRequestRecord;
16
+ result?: WireDumpResultRecord;
17
+ /** body 文件是否仍存在(环形裁剪/oversize 后可能缺失) */
18
+ hasBody: boolean;
19
+ }
20
+ /** 相邻两次调用的前缀比对结果 */
21
+ export interface WirePrefixDiff {
22
+ /** identical:完全一致;append-only:纯追加;truncated:尾部被删;diverged:中部改写 */
23
+ stability: 'identical' | 'append-only' | 'truncated' | 'diverged';
24
+ /** 逐单元 hash 相同的单元数 */
25
+ commonPrefix: number;
26
+ appended: number;
27
+ removed: number;
28
+ /** 公共前缀在 next 侧的字符数(≈ 可命中缓存的输入量) */
29
+ stableChars: number;
30
+ /**
31
+ * 实际可复用缓存的前缀字符数
32
+ *
33
+ * tools / model 变化会让整段前缀缓存失效,此时为 0:Anthropic 文档明确缓存层级为
34
+ * tools → system → messages,OpenAI 的完整渲染上下文同样把工具定义排在消息之前。
35
+ * 仅消息前缀稳定不足以命中缓存。`mode` 变化不影响缓存,不参与此判定。
36
+ */
37
+ cacheableChars: number;
38
+ divergence?: {
39
+ index: number;
40
+ prevRole?: string;
41
+ nextRole?: string;
42
+ prevLen?: number;
43
+ nextLen?: number;
44
+ };
45
+ /**
46
+ * 断点之后仍有内容变化的单元数
47
+ *
48
+ * 单点改写(如上一轮 assistant 文本被用户编辑)为 0;历史批量老化(多条原文被替换为
49
+ * 指针)会远大于 0——这类批量改写即使断点靠前,实际失效范围也覆盖到尾部。
50
+ */
51
+ changedAfter: number;
52
+ toolsChanged: boolean;
53
+ modelChanged: boolean;
54
+ modeChanged: boolean;
55
+ }
56
+ /** 单条消息内部的字符级差异 */
57
+ export interface WireUnitDiffDetail {
58
+ index: number;
59
+ /** 单元内首个不同字符的偏移(0 = 单元开头即不同) */
60
+ offset: number;
61
+ prevSnippet: string;
62
+ nextSnippet: string;
63
+ }
64
+ /**
65
+ * 读取 session 目录里第一条 request 记录(用于按真实 sessionId 匹配被 sanitize 过的目录名)
66
+ *
67
+ * @param dirPath - session 目录
68
+ * @returns 首条 request 行;不存在时 null
69
+ */
70
+ export declare function readFirstWireDumpRequest(dirPath: string): WireDumpRequestRecord | null;
71
+ /**
72
+ * 读取单个 session 目录的 index.jsonl(request 与 result 按 id 合并、按时间排序)
73
+ *
74
+ * @param dirPath - session 目录(含 index.jsonl)
75
+ * @returns 调用摘要列表;无索引时返回空数组
76
+ */
77
+ export declare function readWireDumpIndex(dirPath: string): WireCallSummary[];
78
+ /**
79
+ * 列出 dump 根目录下的 session 目录(按 index.jsonl 更新时间倒序)
80
+ *
81
+ * @param rootDir - dump 根目录
82
+ * @returns session 目录列表
83
+ */
84
+ export declare function listWireDumpSessions(rootDir: string): Array<{
85
+ dir: string;
86
+ sessionId: string;
87
+ mtimeMs: number;
88
+ }>;
89
+ /**
90
+ * 读取一次调用的完整请求体
91
+ *
92
+ * @param dirPath - session 目录
93
+ * @param request - 索引中的 request 行
94
+ * @returns 请求体;缺失/损坏时 null
95
+ */
96
+ export declare function loadWireDumpBody(dirPath: string, request: WireDumpRequestRecord): Record<string, unknown> | null;
97
+ /**
98
+ * 比对相邻两次调用的前缀
99
+ *
100
+ * @param prev - 上一次调用
101
+ * @param next - 本次调用
102
+ * @returns 前缀比对结果
103
+ */
104
+ export declare function compareWireCalls(prev: WireCallSummary, next: WireCallSummary): WirePrefixDiff;
105
+ /** 老化扫描结果 */
106
+ export interface WireAgingReport {
107
+ /** prev 侧指针条数 */
108
+ prevPointers: number;
109
+ /** next 侧指针条数 */
110
+ nextPointers: number;
111
+ /**
112
+ * 本次新增的老化替换条数
113
+ *
114
+ * 统计「prev 侧该位置是原文、next 侧同一位置变成指针」的单元数——这正是前缀断裂
115
+ * 的真实来源,也是判断一次分歧是单点改写还是批量老化的依据。
116
+ */
117
+ agedInPlace: number;
118
+ /** 首个被老化的单元下标;无老化时 -1 */
119
+ firstAgedIndex: number;
120
+ /**
121
+ * 本次老化净减掉的字符数(原文长度 − 指针长度 + 参数收缩量)
122
+ *
123
+ * 这是老化带来的**持续收益**:此后每次调用都不必再发送这些字符。
124
+ */
125
+ agedCharsSaved: number;
126
+ /**
127
+ * 其中来自「工具调用参数摘要」的部分
128
+ *
129
+ * 参数老化发生在 assistant 单元内,不在「原文→指针」判定里,必须单独计息。
130
+ */
131
+ agedArgCharsSaved: number;
132
+ }
133
+ /** 老化回本判定输入 */
134
+ export interface WireAgingPaybackInput {
135
+ /** 老化净减掉的字符数 */
136
+ agedCharsSaved: number;
137
+ /** 本次因断点失效而必须重算的字符数(请求尾部) */
138
+ burnedChars: number;
139
+ /** 该调用的 tokens/char(由真实 usage 推算;缺省 1/3 粗估) */
140
+ tokensPerChar: number;
141
+ /** 缓存命中价格相对全价的比例(0.1 = 一折);0 表示无缓存 */
142
+ cacheDiscount: number;
143
+ /** 该次老化之后实际发生的调用次数(收益的真实摊薄面) */
144
+ callsAfter: number;
145
+ }
146
+ /** 老化回本判定结果 */
147
+ export interface WireAgingPayback {
148
+ savedTokens: number;
149
+ burnedTokens: number;
150
+ /** 回本所需调用次数(Infinity = 收益为零或无缓存,永远回不来) */
151
+ paybackCalls: number;
152
+ /**
153
+ * 是否已由后续调用回本
154
+ *
155
+ * 老化收益是**持续性**的(此后每次调用都少读),因此以「之后实际发生了多少次调用」
156
+ * 对比回本点。未回本不代表亏——只要 session 还会继续,差额最终会被摊掉。
157
+ */
158
+ repaid: boolean;
159
+ }
160
+ /**
161
+ * 统计两次调用之间的历史老化(原文 → 指针)情况
162
+ *
163
+ * @param prevBody - 上次调用的请求体
164
+ * @param nextBody - 本次调用的请求体
165
+ * @returns 老化统计;任一侧 body 缺失时 null
166
+ */
167
+ export declare function reportWireAging(prevBody: Record<string, unknown> | null, nextBody: Record<string, unknown> | null): WireAgingReport | null;
168
+ /**
169
+ * 估算一次老化的回本点
170
+ *
171
+ * 成本模型(把「老化」与「不老化」两条路径对比):
172
+ * - 老化路径:本次调用要把失效尾部按**全价**重算一次 → 额外成本 `burned × (1 − discount)`
173
+ * - 不老化路径:被老化的原文此后每次调用都要重新发送,且作为热前缀按 `discount` 计价
174
+ * → 每次调用节省 `saved × discount`
175
+ *
176
+ * 因此 `paybackCalls = burned × (1 − discount) / (saved × discount)`。
177
+ * discount=0.1(一折)时即 `9 × burned / saved`。
178
+ *
179
+ * @param input - 老化量 / 燃烧量 / 价格折扣 / 本轮调用次数
180
+ * @returns 回本判定;`paybackCalls` 为 Infinity 表示收益为零或无缓存
181
+ */
182
+ export declare function estimateAgingPayback(input: WireAgingPaybackInput): WireAgingPayback;
183
+ /**
184
+ * 定位单个前缀单元内部的字符级差异
185
+ *
186
+ * @param prevBody - 上次调用的请求体
187
+ * @param nextBody - 本次调用的请求体
188
+ * @param index - 分歧单元下标(来自 {@link compareWireCalls} 的 divergence.index)
189
+ * @returns 字符偏移与上下文片段;单元缺失时 null
190
+ */
191
+ export declare function explainWireDivergence(prevBody: Record<string, unknown>, nextBody: Record<string, unknown>, index: number): WireUnitDiffDetail | null;