@octopi-agent/engine 0.97.15 → 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 (369) hide show
  1. package/dist/config-schema/agent.d.ts +37 -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 +61 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +10 -1
  8. package/dist/config-schema/governance.js +38 -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 +34 -2
  25. package/dist/harness/agent/builder.js +189 -58
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.d.ts +66 -0
  28. package/dist/harness/agent/config-integrity.js +108 -2
  29. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  30. package/dist/harness/agent/wire-agent-builder.js +31 -7
  31. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  32. package/dist/harness/capabilities/document/factory.js +1 -0
  33. package/dist/harness/capabilities/document/port.js +6 -3
  34. package/dist/harness/capabilities/document/types.d.ts +5 -0
  35. package/dist/harness/collaboration/autonomous-subsystem/index.d.ts +2 -2
  36. package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
  37. package/dist/harness/collaboration/autonomous-subsystem/loader.js +4 -1
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +21 -4
  40. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  41. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  43. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  45. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.d.ts +40 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
  50. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +12 -3
  52. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  53. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  54. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  55. package/dist/harness/collaboration/delegation/index.js +1 -1
  56. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  57. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  58. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  59. package/dist/harness/collaboration/delegation/service.js +2 -1
  60. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  61. package/dist/harness/collaboration/delegation/store.js +2 -1
  62. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  63. package/dist/harness/collaboration/delegation/types.js +22 -0
  64. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  65. package/dist/harness/context/budget-allocator.d.ts +26 -18
  66. package/dist/harness/context/budget-allocator.js +67 -32
  67. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  68. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  69. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  70. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  71. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  72. package/dist/harness/context/capabilities/compact/index.js +4 -0
  73. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  74. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  75. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  76. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  77. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  78. package/dist/harness/context/capabilities/compact/types.js +11 -1
  79. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  80. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  81. package/dist/harness/context/capabilities/summary/port.js +0 -1
  82. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  83. package/dist/harness/context/capabilities/summary/resolver.js +4 -9
  84. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  85. package/dist/harness/context/capabilities/summary/types.d.ts +4 -7
  86. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  87. package/dist/harness/context/context-size-ledger.js +236 -0
  88. package/dist/harness/context/default-context-engine.d.ts +195 -119
  89. package/dist/harness/context/default-context-engine.js +1241 -743
  90. package/dist/harness/context/index.d.ts +2 -2
  91. package/dist/harness/context/index.js +1 -1
  92. package/dist/harness/context/layer-types.d.ts +15 -0
  93. package/dist/harness/context/layer-types.js +14 -1
  94. package/dist/harness/context/layers.d.ts +16 -19
  95. package/dist/harness/context/layers.js +42 -14
  96. package/dist/harness/context/message-selector.d.ts +10 -8
  97. package/dist/harness/context/message-selector.js +49 -27
  98. package/dist/harness/context/summarize.d.ts +3 -3
  99. package/dist/harness/context/summarize.js +11 -4
  100. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  101. package/dist/harness/context/system-prompt-assembler.js +3 -1
  102. package/dist/harness/context/token-constants.d.ts +8 -6
  103. package/dist/harness/context/token-constants.js +8 -7
  104. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  105. package/dist/harness/context/token-estimate-fns.js +85 -66
  106. package/dist/harness/context/token-estimator.d.ts +27 -12
  107. package/dist/harness/context/token-estimator.js +120 -66
  108. package/dist/harness/context/token-segments.d.ts +88 -0
  109. package/dist/harness/context/token-segments.js +103 -0
  110. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  111. package/dist/harness/context/tool-result-aging.js +16 -5
  112. package/dist/harness/context/tool-result-body.js +2 -0
  113. package/dist/harness/context/transform/anchors.d.ts +66 -0
  114. package/dist/harness/context/transform/anchors.js +125 -0
  115. package/dist/harness/context/transform/fold.d.ts +56 -0
  116. package/dist/harness/context/transform/fold.js +135 -0
  117. package/dist/harness/context/transform/migrate.d.ts +41 -0
  118. package/dist/harness/context/transform/migrate.js +69 -0
  119. package/dist/harness/context/transform/types.d.ts +129 -0
  120. package/dist/harness/context/transform/types.js +19 -0
  121. package/dist/harness/context/turn-envelope.d.ts +6 -3
  122. package/dist/harness/context/types.d.ts +127 -117
  123. package/dist/harness/extension/execution-environment/effect-policy.d.ts +24 -2
  124. package/dist/harness/extension/execution-environment/effect-policy.js +30 -0
  125. package/dist/harness/extension/execution-environment/ops-audit.d.ts +7 -3
  126. package/dist/harness/extension/execution-environment/ops-audit.js +11 -12
  127. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  128. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  129. package/dist/harness/extension/execution-environment/undo-log.d.ts +6 -2
  130. package/dist/harness/extension/execution-environment/undo-log.js +31 -10
  131. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  132. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  133. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  134. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  135. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  136. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  137. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  138. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  139. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  140. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  146. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  147. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  148. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  149. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  150. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  151. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  152. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  153. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  154. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  155. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  156. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  157. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  159. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  160. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  161. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  163. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  164. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  165. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  166. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  167. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  168. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  169. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  171. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  172. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  173. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  174. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  175. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  176. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  177. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  178. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  180. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +17 -24
  181. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  182. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
  183. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
  186. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
  187. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
  188. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
  189. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
  190. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  193. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  194. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  195. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  196. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  198. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  199. package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
  200. package/dist/harness/governance/security/default-risk-policy.js +1 -0
  201. package/dist/harness/governance/security/default-security-guard.js +9 -0
  202. package/dist/harness/governance/security/index.d.ts +1 -0
  203. package/dist/harness/governance/security/index.js +2 -0
  204. package/dist/harness/governance/security/risk-evaluator.js +13 -0
  205. package/dist/harness/governance/security/risk-types.d.ts +12 -0
  206. package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
  207. package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
  208. package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
  209. package/dist/harness/governance/security/shell-parser-shared.js +188 -0
  210. package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
  211. package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
  212. package/dist/harness/governance/security/shell-parser.d.ts +23 -10
  213. package/dist/harness/governance/security/shell-parser.js +37 -496
  214. package/dist/harness/governance/security/vendor/README.md +24 -0
  215. package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
  216. package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
  217. package/dist/harness/index.d.ts +12 -12
  218. package/dist/harness/index.js +7 -7
  219. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  220. package/dist/harness/knowledge/boot-config.js +50 -0
  221. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  222. package/dist/harness/knowledge/client.d.ts +24 -2
  223. package/dist/harness/knowledge/client.js +19 -5
  224. package/dist/harness/knowledge/db.js +5 -0
  225. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  226. package/dist/harness/knowledge/describe-sample.js +58 -0
  227. package/dist/harness/knowledge/describe.d.ts +8 -0
  228. package/dist/harness/knowledge/describe.js +18 -2
  229. package/dist/harness/knowledge/engine-thread.js +6 -0
  230. package/dist/harness/knowledge/grounding.js +3 -1
  231. package/dist/harness/knowledge/http-app.js +35 -4
  232. package/dist/harness/knowledge/http-params.d.ts +18 -0
  233. package/dist/harness/knowledge/http-params.js +24 -0
  234. package/dist/harness/knowledge/index.d.ts +2 -0
  235. package/dist/harness/knowledge/index.js +1 -0
  236. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  237. package/dist/harness/knowledge/purge.js +5 -2
  238. package/dist/harness/knowledge/query-service.d.ts +13 -2
  239. package/dist/harness/knowledge/query-service.js +4 -2
  240. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  241. package/dist/harness/knowledge/query-worker-client.js +4 -2
  242. package/dist/harness/knowledge/query-worker.js +4 -2
  243. package/dist/harness/knowledge/read-http.js +5 -1
  244. package/dist/harness/knowledge/serve.d.ts +8 -7
  245. package/dist/harness/knowledge/serve.js +9 -0
  246. package/dist/harness/knowledge/source-store.js +26 -3
  247. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  248. package/dist/harness/knowledge/start-service-process.js +21 -9
  249. package/dist/harness/knowledge/types.d.ts +7 -0
  250. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  251. package/dist/harness/knowledge/writer-service.js +120 -14
  252. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  253. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  254. package/dist/harness/knowledge/writer-worker.js +9 -1
  255. package/dist/harness/memory/index.d.ts +6 -2
  256. package/dist/harness/memory/index.js +4 -1
  257. package/dist/harness/memory/memory-events.d.ts +25 -0
  258. package/dist/harness/memory/memory-events.js +38 -0
  259. package/dist/harness/memory/sqlite/agent-db.js +15 -0
  260. package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
  261. package/dist/harness/memory/sqlite/wisdom-store.js +86 -12
  262. package/dist/harness/memory/steward-policy.d.ts +3 -0
  263. package/dist/harness/memory/steward-policy.js +1 -1
  264. package/dist/harness/memory/types.d.ts +47 -7
  265. package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
  266. package/dist/harness/memory/wisdom-attribution.js +287 -0
  267. package/dist/harness/memory/wisdom-events.d.ts +37 -0
  268. package/dist/harness/memory/wisdom-events.js +61 -0
  269. package/dist/harness/memory/wisdom-formation.d.ts +31 -1
  270. package/dist/harness/memory/wisdom-formation.js +130 -33
  271. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  272. package/dist/harness/memory/wisdom-gates.js +59 -19
  273. package/dist/harness/memory/wisdom.d.ts +7 -2
  274. package/dist/harness/memory/wisdom.js +49 -2
  275. package/dist/harness/observability/observer/hub.js +25 -15
  276. package/dist/harness/observability/observer/types.d.ts +10 -6
  277. package/dist/harness/run/agent/agent.d.ts +40 -21
  278. package/dist/harness/run/agent/agent.js +66 -13
  279. package/dist/harness/run/agent/index.d.ts +1 -1
  280. package/dist/harness/run/budget/budget.d.ts +28 -10
  281. package/dist/harness/run/budget/budget.js +38 -15
  282. package/dist/harness/run/model/index.d.ts +3 -1
  283. package/dist/harness/run/model/index.js +2 -1
  284. package/dist/harness/run/model/resolver.d.ts +4 -1
  285. package/dist/harness/run/model/resolver.js +36 -2
  286. package/dist/harness/run/model/run-scope.d.ts +2 -0
  287. package/dist/harness/run/model/run-scope.js +7 -0
  288. package/dist/harness/run/model/types.d.ts +22 -5
  289. package/dist/harness/run/model/types.js +3 -2
  290. package/dist/harness/run/model/window-truth.d.ts +37 -0
  291. package/dist/harness/run/model/window-truth.js +39 -0
  292. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  293. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  294. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  295. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  296. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  297. package/dist/harness/run/reliability/run-agent.js +137 -53
  298. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  299. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  300. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  301. package/dist/harness/run/run-scope.d.ts +41 -4
  302. package/dist/harness/run/runner.d.ts +71 -31
  303. package/dist/harness/run/runner.js +368 -106
  304. package/dist/harness/session/attachments/index.d.ts +1 -0
  305. package/dist/harness/session/attachments/index.js +1 -0
  306. package/dist/harness/session/attachments/inject.d.ts +21 -10
  307. package/dist/harness/session/attachments/inject.js +76 -24
  308. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  309. package/dist/harness/session/attachments/recall-index.js +219 -0
  310. package/dist/harness/session/attachments/service.d.ts +21 -0
  311. package/dist/harness/session/attachments/service.js +258 -139
  312. package/dist/harness/session/attachments/types.d.ts +6 -0
  313. package/dist/harness/session/transform-store.d.ts +136 -0
  314. package/dist/harness/session/transform-store.js +302 -0
  315. package/dist/harness/session/types.d.ts +2 -2
  316. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  317. package/dist/harness/shared/events/agent-event-map.js +3 -2
  318. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  319. package/dist/harness/shared/paths/glob.d.ts +52 -0
  320. package/dist/harness/shared/paths/glob.js +218 -0
  321. package/dist/harness/shared/paths/index.d.ts +84 -0
  322. package/dist/harness/shared/paths/index.js +179 -0
  323. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  324. package/dist/index.d.ts +14 -17
  325. package/dist/index.js +7 -9
  326. package/dist/integration/observability/metrics.d.ts +6 -6
  327. package/dist/integration/observability/metrics.js +13 -13
  328. package/dist/integration/observability/observer-bridge.js +2 -2
  329. package/dist/integration/observability/trace-collector.d.ts +5 -5
  330. package/dist/integration/observability/trace-collector.js +34 -35
  331. package/dist/integration/observability/trace-events.d.ts +3 -3
  332. package/dist/integration/observability/trace-events.js +3 -3
  333. package/dist/integration/providers/anthropic.js +14 -1
  334. package/dist/integration/providers/openai.js +7 -1
  335. package/dist/integration/providers/usage.d.ts +1 -1
  336. package/dist/integration/providers/wire-dump.d.ts +1 -1
  337. package/dist/integration/storage/archive-manager.d.ts +6 -0
  338. package/dist/integration/storage/archive-manager.js +10 -0
  339. package/dist/integration/storage/jsonl.d.ts +1 -1
  340. package/dist/integration/storage/jsonl.js +18 -16
  341. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
  342. package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
  343. package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
  344. package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
  345. package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
  346. package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
  347. package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
  348. package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
  349. package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
  350. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  351. package/dist/subsystems/wisdom-steward/formation/config.yaml +13 -5
  352. package/dist/subsystems/wisdom-steward/formation/handler.js +39 -23
  353. package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
  354. package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
  355. package/package.json +16 -14
  356. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  357. package/dist/harness/context/hybrid-compressor.js +0 -159
  358. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  359. package/dist/harness/context/llm-summarizer.js +0 -249
  360. package/dist/harness/context/smart-router.d.ts +0 -75
  361. package/dist/harness/context/smart-router.js +0 -118
  362. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  363. package/dist/harness/context/truncate-compressor.js +0 -107
  364. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  365. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  366. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  367. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  368. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  369. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -0,0 +1,236 @@
1
+ /**
2
+ * ContextSizeLedger — 校准后上下文体量台账(P1-a,arch/context-size-accounting.md §4.3)
3
+ *
4
+ * 职责:把 `promptTokensActual`(provider 实测)学到的比率作用到**所有决策读数**(R1:
5
+ * 决策只许用被实测校准过的 viewTokens)。取代旧「只乘展示值 + 逐 session ratio +
6
+ * 静默 [0.5,2.0] 夹取」的三处缺陷:
7
+ * 1. 决策点(smart-router / message-selector / compact / budget-allocator)未受益;
8
+ * 2. clamp [0.5,2.0] 掩盖严重低估(实测偏差 2.9× 被夹到 2.0);
9
+ * 3. 分母口径漂移(口径对齐后 lastEstimatedTokens 恒为「system+tools+视图」)。
10
+ *
11
+ * 设计要点(拍板):
12
+ * - ratio **按 model 分 key**(跨 session 共享统计,收敛快);
13
+ * - EMA 平滑 0.7 新 / 0.3 旧;
14
+ * - 夹取带 [0.25, 4.0] = 入账值域:超出即夹取(方向一致的越界样本可学习),越界**告警而非静默**;
15
+ * 注意偏离门相对「已学 ratio」判,r<1 时带内样本也可能出门——出门不等于越界;
16
+ * - 偏离门(arch §10.14):新样本偏离已学 ratio 超 RATIO_SAMPLE_MAX_DEVIATION 倍即**拒绝入账**
17
+ * (错配样本如「陈旧 usage × 当步估算」双向拉扯 ratio 震荡,见 2026-11-06 事故);
18
+ * - 逃逸重锚(评审 F1):连续 RATIO_ESCAPE_STREAK 个同向且内部一致的被拒样本 = regime shift
19
+ * 证据,以簇中心重锚——拒绝零状态变化会把真值永久锁在门外(毒化 bootstrap 后 50 个真样本
20
+ * 全拒的实测锁死);交替垃圾内部永不一致、永远进不来;
21
+ * - 告警按 (session, model, 事件类) 限频 1 条/小时(拒绝告警不被夹取告警吞掉);
22
+ * - 决策出口 decisionTokens(方案 B,arch §10.16):≥2 已入账样本且未降级才走 calibrate(R1);
23
+ * 否则实测锚定(actual × raw/anchor.raw)或裸 raw。
24
+ *
25
+ * 状态为进程内存(ratio 冷启动 1.0,2–3 个样本内收敛);不落盘。
26
+ */
27
+ /** ratio 夹取边界(拍板:[0.25, 4.0]) */
28
+ export const RATIO_CLAMP_MIN = 0.25;
29
+ export const RATIO_CLAMP_MAX = 4.0;
30
+ /** 样本偏离门:新样本偏离已学 ratio 超该倍数(任一方向)即拒绝入账(arch §10.14) */
31
+ export const RATIO_SAMPLE_MAX_DEVIATION = 4.0;
32
+ /** 逃逸重锚:连续同向且内部一致的被拒簇达该长度即视为 regime shift(评审 F1) */
33
+ export const RATIO_ESCAPE_STREAK = 3;
34
+ /** 逃逸簇内部一致性:max/min ≤ 该值才算「同向一致」(交替垃圾永不一致) */
35
+ export const RATIO_ESCAPE_CONSISTENCY = 2.0;
36
+ /** 预测带:入账样本偏离已学 ratio 超该倍数 = 校准预测失准 → 降级(方案 B 门,arch §10.16) */
37
+ export const RATIO_PREDICTION_BAND = 1.5;
38
+ /** 越界告警限频:每 (session, model) 每小时 1 条 */
39
+ export const RATIO_WARN_INTERVAL_MS = 3_600_000;
40
+ const EMA_NEW_WEIGHT = 0.7;
41
+ /** 校准台账:observe(actual, view) 学 ratio;calibrate(viewTokens) 出校准读数 */
42
+ export class ContextSizeLedger {
43
+ warn;
44
+ ratioByModel = new Map();
45
+ samplesByModel = new Map();
46
+ rejectedByModel = new Map();
47
+ rejectStreaks = new Map();
48
+ degradedByModel = new Map();
49
+ lastWarnAt = new Map();
50
+ constructor(warn = (m) => console.warn(m)) {
51
+ this.warn = warn;
52
+ }
53
+ /**
54
+ * 记录一对实测/估算样本(分母 view 必须是「system+tools+视图」口径的**未校准**估算)。
55
+ *
56
+ * @param modelKey provider/model 标识(ratio 的分键)
57
+ * @param actual provider 实测 prompt tokens
58
+ * @param view 同一请求的未校准视图估算
59
+ * @param opts sessionId(告警限频键)/ now(测试注入时钟)
60
+ * @returns 裁决(调用方据其决定是否冻结实测锚——夹取/拒收/重锚样本一律不得作锚)
61
+ */
62
+ observe(modelKey, actual, view, opts) {
63
+ if (!(actual > 0) || !(view > 0))
64
+ return 'ignored';
65
+ const raw = actual / view;
66
+ const prev = this.ratioByModel.get(modelKey) ?? 1.0;
67
+ const hasSamples = (this.samplesByModel.get(modelKey) ?? 0) > 0;
68
+ const outsideGate = hasSamples &&
69
+ (raw > prev * RATIO_SAMPLE_MAX_DEVIATION || raw < prev / RATIO_SAMPLE_MAX_DEVIATION);
70
+ if (outsideGate) {
71
+ this.rejectedByModel.set(modelKey, (this.rejectedByModel.get(modelKey) ?? 0) + 1);
72
+ // 滑窗(评审 F2):只保留最近 RATIO_ESCAPE_STREAK 个被拒样本——全史 min/max 一旦被
73
+ // 一对不一致垃圾拉开就永不收敛,逃逸随之永久失效(实测:0.05+11.0 后 20 个真样本全拒)。
74
+ const recent = this.rejectStreaks.get(modelKey) ?? [];
75
+ recent.push(raw);
76
+ if (recent.length > RATIO_ESCAPE_STREAK)
77
+ recent.shift();
78
+ this.rejectStreaks.set(modelKey, recent);
79
+ // 逃逸重锚(评审 F1):窗口内同向且内部一致的被拒样本 = regime shift 证据(真实换挡或
80
+ // 新错配源),以窗心重锚。拒绝零状态变化会把真值永久锁在门外;交替垃圾(0.088↔11.014)
81
+ // 任意 RATIO_ESCAPE_STREAK 连窗 max/min 巨大、永不满足一致性,进不来。
82
+ if (recent.length >= RATIO_ESCAPE_STREAK) {
83
+ const min = Math.min(...recent);
84
+ const max = Math.max(...recent);
85
+ if (max / min <= RATIO_ESCAPE_CONSISTENCY) {
86
+ const rebase = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, (min + max) / 2));
87
+ this.ratioByModel.set(modelKey, rebase);
88
+ this.samplesByModel.set(modelKey, (this.samplesByModel.get(modelKey) ?? 0) + 1);
89
+ this.rejectStreaks.set(modelKey, []);
90
+ this.setDegraded(modelKey, false, opts, raw); // 重锚基于新鲜证据窗,预测恢复可信
91
+ this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'rebase', `regime shift: rebase learned=${rebase.toFixed(3)}`);
92
+ return 'rebased';
93
+ }
94
+ }
95
+ this.setDegraded(modelKey, true, opts, raw); // 证据流敌对 → 校准降级(方案 B)
96
+ this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'reject', `rejected(已拒绝入账) learned=${prev.toFixed(3)} gate=[${(prev / RATIO_SAMPLE_MAX_DEVIATION).toFixed(3)}, ${(prev * RATIO_SAMPLE_MAX_DEVIATION).toFixed(3)}]`);
97
+ return 'rejected';
98
+ }
99
+ this.rejectStreaks.set(modelKey, []);
100
+ const outOfClamp = raw < RATIO_CLAMP_MIN || raw > RATIO_CLAMP_MAX;
101
+ if (outOfClamp) {
102
+ this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'clamp', `out of clamp(已夹取入账) clamp=[${RATIO_CLAMP_MIN}, ${RATIO_CLAMP_MAX}]`);
103
+ }
104
+ // 预测带(方案 B 门):入账样本偏离已学 ratio 超 RATIO_PREDICTION_BAND 倍 = 乘数
105
+ // 预测失准(如毒化 ratio 尚未被门拦住的窗口期)→ 降级,直到样本回到带内
106
+ this.setDegraded(modelKey, hasSamples && (raw > prev * RATIO_PREDICTION_BAND || raw < prev / RATIO_PREDICTION_BAND), opts, raw);
107
+ const clamped = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, raw));
108
+ this.ratioByModel.set(modelKey, EMA_NEW_WEIGHT * clamped + (1 - EMA_NEW_WEIGHT) * prev);
109
+ this.samplesByModel.set(modelKey, (this.samplesByModel.get(modelKey) ?? 0) + 1);
110
+ return outOfClamp ? 'clamped' : 'accepted';
111
+ }
112
+ /** 降级状态写入 + 进入/退出可见(评审 F5):生产须能从日志判定决策读数是校准还是实测锚定 */
113
+ setDegraded(modelKey, value, opts, raw) {
114
+ const was = this.degradedByModel.get(modelKey) ?? false;
115
+ this.degradedByModel.set(modelKey, value);
116
+ if (was !== value) {
117
+ this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, value ? 'degrade' : 'recover', value ? 'calibration degraded(决策改实测锚定)' : 'calibration recovered(决策回校准)');
118
+ }
119
+ }
120
+ /**
121
+ * 校准一个视图估算(决策与展示读数的唯一出口)。
122
+ *
123
+ * @param modelKey provider/model 标识
124
+ * @param viewTokens 未校准视图估算
125
+ * @returns 校准后的 token 数(向上取整)
126
+ */
127
+ calibrate(modelKey, viewTokens) {
128
+ return Math.ceil(viewTokens * this.ratio(modelKey));
129
+ }
130
+ /** 当前平滑 ratio(无样本 = 1.0) */
131
+ ratio(modelKey) {
132
+ return this.ratioByModel.get(modelKey) ?? 1.0;
133
+ }
134
+ /** 已学习样本数(收敛观测用;只计已入账样本) */
135
+ sampleCount(modelKey) {
136
+ return this.samplesByModel.get(modelKey) ?? 0;
137
+ }
138
+ /** 被样本门拒绝的样本数(校准停学/锁死观测与 fail-safe 判定用) */
139
+ rejectedCount(modelKey) {
140
+ return this.rejectedByModel.get(modelKey) ?? 0;
141
+ }
142
+ /** 校准是否降级(证据流敌对/预测带外;方案 B 触发位) */
143
+ isDegraded(modelKey) {
144
+ return this.degradedByModel.get(modelKey) ?? false;
145
+ }
146
+ /**
147
+ * 决策读数出口(R1 + 降级 B,arch §10.16)。
148
+ *
149
+ * - 校准可信(≥2 个已入账样本且未降级):ceil(raw × ratio)(R1 原语义);
150
+ * - 不可信(冷启动单样本 / 降级,评审 F1)且有实测锚:ceil(actual × raw / anchor.raw)
151
+ * ——实测是滞后一个请求的硬真值,乘 raw 增长比外推本步增量(拍板方案 B);
152
+ * 锚为 {actual, raw, modelKey} 冻结对(同请求同源,评审 F3),跨 model 无效;
153
+ * - 不可信无锚:raw(诚实估算,不乘可疑 ratio)。
154
+ *
155
+ * @param modelKey provider/model 标识
156
+ * @param rawTokens 本次请求口径的未校准估算
157
+ * @param anchor 实测锚(冻结对:actual=该请求实测 prompt,raw=同请求未校准估算)
158
+ * @returns 决策用 token 读数
159
+ */
160
+ decisionTokens(modelKey, rawTokens, anchor) {
161
+ return this.decisionTokensWithSource(modelKey, rawTokens, anchor).tokens;
162
+ }
163
+ /**
164
+ * decisionTokens 的带来源变体(可观测:pressure 快照 readingSource,评审 F5)。
165
+ *
166
+ * @param modelKey provider/model 标识
167
+ * @param rawTokens 本次请求口径的未校准估算
168
+ * @param anchor 实测锚(冻结对)
169
+ * @returns 决策读数 + 读数来源(calibrated=校准 / anchored=实测锚定 / raw=裸估算)
170
+ */
171
+ /**
172
+ * 校准状态导出(持久化用,取舍③配套):重启后第一轮即 anchored/calibrated,
173
+ * 消除「跑几轮才校准」的冷启动过渡。导出 per-key 样本计数 + 最新锚。
174
+ */
175
+ exportState() {
176
+ const out = {};
177
+ for (const [k, v] of this.samplesByModel)
178
+ out[k] = { samples: v };
179
+ return out;
180
+ }
181
+ /** 校准状态导入(restore 用):样本计数回填 EMA 可信度判定(ratio 本身按新样本重建)。 */
182
+ importState(state) {
183
+ for (const [k, v] of Object.entries(state ?? {})) {
184
+ if (typeof v?.samples === 'number' && v.samples > 0)
185
+ this.samplesByModel.set(k, v.samples);
186
+ }
187
+ }
188
+ decisionTokensWithSource(modelKey, rawTokens, anchor) {
189
+ const trusted = (this.samplesByModel.get(modelKey) ?? 0) >= 2 && !this.isDegraded(modelKey);
190
+ if (trusted)
191
+ return { tokens: this.calibrate(modelKey, rawTokens), source: 'calibrated' };
192
+ if (anchor && anchor.modelKey === modelKey && anchor.actual > 0 && anchor.raw > 0) {
193
+ // 锚卫生(2026-11-07):锚是同请求实测对的外推(配对槽保证同源)。不做比率带拒用——
194
+ // ratio 远离 1 可能是合法极端内容(图片/大 schema,F1 冷锚定语义),带检查会把这种
195
+ // 内容的决策砸回裸估算(低估 → 压缩触发漏报)。
196
+ // 夹取(2026-11-08,生产现场 0.185 毒读数):clamped 样本 EMA 吃夹取值而锚冻结的是
197
+ // 原始值——极端比率(大 tools schema 本地估算偏高 5×)以原始值外推会毒化读数。
198
+ // 与 EMA 同 guard 夹取 [RATIO_CLAMP_MIN, RATIO_CLAMP_MAX]:不拒极端锚(极端内容仍
199
+ // 锚定),但比率不越过与 EMA 相同的界——两把尺同界。
200
+ const anchorRatio = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, anchor.actual / anchor.raw));
201
+ return { tokens: Math.ceil(anchorRatio * rawTokens), source: 'anchored' };
202
+ }
203
+ return { tokens: rawTokens, source: 'raw' };
204
+ }
205
+ /**
206
+ * 包装一个原始估算器为「校准读数」估算器(R1:决策路径读校准值)。
207
+ * 读数 = calibrate(raw);形状归一与计数仍在原始估算器(P1-c 单实现)。
208
+ */
209
+ calibratedEstimator(modelKey, raw) {
210
+ const ledger = this;
211
+ return {
212
+ estimateMessage(message) {
213
+ return ledger.calibrate(modelKey, raw.estimateMessage(message));
214
+ },
215
+ estimateMessages(messages) {
216
+ return ledger.calibrate(modelKey, raw.estimateMessages(messages));
217
+ },
218
+ estimateText(text) {
219
+ return ledger.calibrate(modelKey, raw.estimateText(text));
220
+ },
221
+ estimateTools(tools) {
222
+ return ledger.calibrate(modelKey, raw.estimateTools(tools));
223
+ },
224
+ };
225
+ }
226
+ /** 样本告警:每 (session, model, 事件类) 每小时至多 1 条(reject/clamp/rebase 分键,拒绝不被夹取吞掉) */
227
+ warnOnce(sessionId, modelKey, raw, now, cls, detail) {
228
+ const key = `${sessionId ?? '—'}|${modelKey}|${cls}`;
229
+ const ts = now ?? Date.now();
230
+ const last = this.lastWarnAt.get(key);
231
+ if (last !== undefined && ts - last < RATIO_WARN_INTERVAL_MS)
232
+ return;
233
+ this.lastWarnAt.set(key, ts);
234
+ this.warn(`[ctx-cal] ratio sample ${cls}: session=${sessionId ?? '—'} model=${modelKey} raw=${raw.toFixed(3)} ${detail}(系统性偏差请校正估算器比率;错配请查 usage/估算配对,arch §10.14)`);
235
+ }
236
+ }