@octopi-agent/engine 0.98.4 → 0.121.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -8,7 +8,11 @@
8
8
  */
9
9
  import type { Message } from '@octopi-agent/core/types.js';
10
10
  import type { LLMMessage, LLMToolDefinition } from '@octopi-agent/core/interfaces/model-provider.js';
11
+ import type { RequestView } from '@octopi-agent/core/loop/types.js';
12
+ import type { SummarizeFunction } from './capabilities/compact/types.js';
11
13
  export type { LLMMessage, LLMToolDefinition };
14
+ /** 族 A 摘要执行契约:单源定义在 capabilities/compact/types.ts(此处再导出保持域内引用面稳定)。 */
15
+ export type { SummarizeFunction };
12
16
  export interface ContextEngineInfo {
13
17
  /** 引擎唯一标识 */
14
18
  id: string;
@@ -39,8 +43,8 @@ export interface TokenEstimator {
39
43
  /** 估算工具定义的 token 数 */
40
44
  estimateTools(tools: LLMToolDefinition[]): number;
41
45
  }
42
- /** 压缩原因:主动摘要 vs 硬溢出 */
43
- export type ContextCompactReason = 'proactive' | 'overflow';
46
+ /** 压缩原因:主动摘要 vs 硬溢出 vs 手动(m-2:manual 事件显式带 reason,防 store 沿用旧标签) */
47
+ export type ContextCompactReason = 'proactive' | 'overflow' | 'manual';
44
48
  /**
45
49
  * 上下文压缩可观测事件
46
50
  *
@@ -48,36 +52,135 @@ export type ContextCompactReason = 'proactive' | 'overflow';
48
52
  * 避免 LLM 摘要耗时被误判为会话卡死。失败不中断本轮(引擎回退截断)。
49
53
  */
50
54
  export interface ContextCompactEvent {
51
- type: 'context.compact.start' | 'context.compact.end' | 'context.compact.error' | 'context.compact.summarize_fallback';
55
+ type: 'context.compact.start' | 'context.compact.progress' | 'context.compact.end' | 'context.compact.error' | 'context.compact.summarize_fallback' | 'context.compact.contamination';
52
56
  sessionId: string;
53
57
  reason?: ContextCompactReason;
54
58
  /** 压缩前估算 token */
55
59
  tokensBefore?: number;
56
60
  /** 压缩后估算 token(end) */
57
61
  tokensAfter?: number;
62
+ /** 当前上下文大小快照(显示槽;tokens 与 tokensAfter 同值同源,报告尺)。
63
+ * 只在真压缩完成时携带——0/0(无新压缩)与 cancelled 不带 = 显示不动 */
64
+ contextSize?: ContextSizeSnapshot;
58
65
  /** 触发阈值(proactive) */
59
66
  threshold?: number;
60
67
  /** 耗时 ms(end/error) */
61
68
  durationMs?: number;
62
69
  /** 走缓存摘要重建,未调 LLM */
63
70
  cached?: boolean;
71
+ /** 中止收尾(本轮作废、零写入)——不是「压缩完成」,UI 不得显示 compacted */
72
+ cancelled?: boolean;
64
73
  /** summarize_fallback:cache-miss 旁路原因(no_prefix | window_guard | window_exhausted,F22) */
65
74
  fallback?: string;
66
75
  error?: string;
76
+ /** error 的性质:denied = before_compaction 策略拒绝(不是故障);failed = 压缩失败 */
77
+ kind?: 'denied' | 'failed';
78
+ /** progress:当前阶段(summarize = 摘要请求已发出、等 provider 返回) */
79
+ phase?: 'summarize';
80
+ /** progress:摘要请求体量(JSON 字符数,内部诊断用) */
81
+ requestChars?: number;
82
+ /** progress:摘要请求 token 估算(与会话请求同口径,UI 显示此值) */
83
+ requestTokens?: number;
84
+ /** progress:摘要请求消息条数 */
85
+ requestMessages?: number;
86
+ /** progress:本次摘要调用预算(ms);缺失 = 不设预算 */
87
+ timeoutMs?: number;
88
+ /** contamination:闸门判定结论(clean = 通过) */
89
+ verdict?: 'clean' | 'canned_refusal' | 'transcript_shape' | 'verbatim_echo';
90
+ /** contamination:第几次尝试(1=首次,2=strict 重试) */
91
+ attempt?: number;
92
+ /** contamination:是否因此丢弃本输出并重试 */
93
+ retryTriggered?: boolean;
94
+ /** contamination:回声命中行数 */
95
+ echoHits?: number;
96
+ /** contamination:回声命中字符数 */
97
+ echoHitChars?: number;
98
+ /** contamination:被判定的输出字符数 */
99
+ textChars?: number;
67
100
  }
101
+ /**
102
+ * 当前上下文大小(显示槽,持久化取数源——web 顶栏「xxx / xxx」前段只从这里取)。
103
+ *
104
+ * 语义(as-of,不猜增长):`tokens` = 最近一次**测量/压缩**时点的全请求口径大小;
105
+ * `source` 标注是哪把尺(R3 显示标注硬规则):'usage' = provider 实测(step.end 真实用量),
106
+ * 'compact-est' = 压缩后估算(报告尺 rawRequestViewTokens)。消息增长导致的偏差停在
107
+ * 上次测量点,由 `asOf` 标注时点,不引入第三把尺。
108
+ *
109
+ * 写点(写入即持久化 session.metadata.contextSize):
110
+ * ① 真实用量到达(runner step.end,writer=usage)——stale 回填不写(不冒名新实测);
111
+ * ② 压缩完成(manual=runner.compactSession 持久化 / auto=compact.end 事件携带、随
112
+ * 该步 usage 或 run 收尾落盘)。其余情况不写:0/0(无新压缩)与 cancelled(中止零
113
+ * 写入)事件不带本字段 = 不动显示。
114
+ */
115
+ export interface ContextSizeSnapshot {
116
+ tokens: number;
117
+ source: 'usage' | 'compact-est';
118
+ /** 写入时点(epoch ms) */
119
+ asOf: number;
120
+ }
121
+ /**
122
+ * 构造 contextSize 快照(唯一构造点:source/asOf 语义一致,禁止手抄字面量)。
123
+ *
124
+ * @param source - 读数来源(usage=provider 实测 / compact-est=压缩后估算)
125
+ * @param tokens - 全请求口径 token 数
126
+ * @returns 快照
127
+ */
128
+ export declare function contextSizeSnapshot(source: ContextSizeSnapshot['source'], tokens: number): ContextSizeSnapshot;
129
+ /**
130
+ * ContextSizeSnapshot 形状守卫(所有摄入点共用,禁止各处手抄校验强度不一——评审 F-4)。
131
+ * metadata 是自由 JSON、事件/REST 是跨进程边界,脏值不得当读数显示。
132
+ *
133
+ * @param v - 待校验值
134
+ * @returns 是否合法快照
135
+ */
136
+ export declare function isContextSizeSnapshot(v: unknown): v is ContextSizeSnapshot;
68
137
  /** 事件回调(Builder 注入 → EventBus) */
69
- export type ContextEmitFn = (event: ContextCompactEvent) => void;
138
+ export type ContextEmitFn = (event: ContextCompactEvent | OverflowAlertEvent) => void;
139
+ /**
140
+ * overflow 症状告警(P3,arch/overflow-redesign.md §2.3 + 红线 7)
141
+ *
142
+ * 守门人触发 = 罕见异常信号,每次触发打告警(不当日常):
143
+ * - `proactive_failed`(A 类症状):前馈溢出——proactive 本该在到达窗口前压缩
144
+ * - `config_drift` / `config_missing`(F 类,有实证):contextWindow 配置漂移/缺失
145
+ * - `structural_over_budget`(D 类):保护段超限——窗口连固定面都放不下
146
+ * - `window_mismatch`(F 类,归因未定):请求超真窗口但未提取到数字,配置或尺子偏差待查
147
+ */
148
+ export interface OverflowAlertEvent {
149
+ type: 'context.overflow.alert';
150
+ sessionId: string;
151
+ /** 症状语义(红线 7:前馈溢出必须含 proactive 失效语义) */
152
+ symptom: 'proactive_failed' | 'config_drift' | 'config_missing' | 'structural_over_budget' | 'window_mismatch';
153
+ /** 人类可读告警(含症状语义关键词,UI/日志直接展示) */
154
+ message: string;
155
+ /** 触发时的估算 token(可选) */
156
+ estimatedTokens?: number;
157
+ /** 窗口值(配置或真值,可选) */
158
+ contextWindow?: number;
159
+ /** 触发入口:T1 前馈溢出 / T2 反馈溢出(F 类回填)/ T3 保护段超限 */
160
+ trigger?: 'T1' | 'T2' | 'T3';
161
+ }
70
162
  export interface AssembleParams {
71
163
  /** Session ID */
72
164
  sessionId: string;
73
165
  /** Agent ID(E4 compact 键分量;缺省时引擎状态退化为纯 sessionId) */
74
166
  agentId?: string;
167
+ /** provider/model 标识(P1-a 校准 ratio 分键,如 `mock/m`;缺省时校准归入 'unknown') */
168
+ modelKey?: string;
75
169
  /** 当前消息历史 */
76
170
  messages: Message[];
77
171
  /** 系统提示词 */
78
172
  systemPrompt: string;
79
173
  /** 可用工具定义 */
80
174
  tools: LLMToolDefinition[];
175
+ /**
176
+ * 工具名 → 结果老化函数(来自 `AgentTool.ageResult`,经 `collectToolAgers` 收集)。
177
+ *
178
+ * 与 `tools` 分开传:`tools` 是发给 LLM 的 wire 投影(用于 toolsHash 与摘要前缀比对),
179
+ * 而老化函数只在装配视图里用,不能混进 wire 面。未提供 = 全部走默认规则。
180
+ */
181
+ toolAgers?: ReadonlyMap<string, import('@octopi-agent/core/types.js').ToolResultAger>;
182
+ /** 参数可老化的工具名(缺省 = 参数一律原样保留,见 RegisteredTool.ageArgs) */
183
+ toolArgAgers?: ReadonlySet<string>;
81
184
  /**
82
185
  * Token 预算(可用空间)。
83
186
  * 未配置 contextWindow 时应省略:跳过基于窗口的自动压缩与预算截断。
@@ -92,17 +195,25 @@ export interface AssembleParams {
92
195
  * 与 contextWindow 无关;未知窗口时仍可作手动/结构压缩的目标。
93
196
  */
94
197
  compactTargetTokens?: number;
95
- /** 中止信号 */
198
+ /** 中止信号(run 中止 → 取消在飞摘要;P3 起由 Loop 经 convertToLlm 透传) */
96
199
  signal?: AbortSignal;
97
- /** Token 估算器(可选,未提供时使用默认实现) */
200
+ /** Token 估算器(可选,未提供时使用默认实现)。**必须是未校准的原始估算器**——
201
+ * 校准由引擎 ContextSizeLedger 统一施加,传入已校准包装会造成双重校准 */
98
202
  tokenEstimator?: TokenEstimator;
99
203
  /** LLM 摘要调用函数(可选,用于压缩阶段) */
100
204
  summarize?: SummarizeFunction;
205
+ /**
206
+ * 交接式摘要素材:当前会话 task 快照(B0:易变块走 content 尾部指令)。
207
+ * 手动/自动(proactive/overflow)压缩路径统一透传给摘要请求(F8R-05),
208
+ * 使自动路径不再依赖注入历史里的旧快照副本。
209
+ */
210
+ taskSnapshot?: string;
101
211
  /** 压缩进度回调(可选;UI / 可观测) */
102
212
  emit?: ContextEmitFn;
103
213
  /**
104
- * 从持久层加载压缩状态快照(进程重启恢复)。
105
- * 引擎内存态为空时调用一次。
214
+ /**
215
+ * 旧压缩快照读口(ContextCompactSnapshot,迁移输入):转换记录账本为空且快照
216
+ * 存在时一次性迁移为初始记录(幂等)。迁移后快照不再更新。
106
217
  */
107
218
  loadCompactState?: (sessionId: string) => Promise<ContextCompactSnapshot | undefined> | ContextCompactSnapshot | undefined;
108
219
  }
@@ -125,30 +236,12 @@ export interface ContextCompactSnapshot {
125
236
  /** 上次主动压缩后的视图 token 估算 */
126
237
  lastProactiveTokens?: number;
127
238
  }
128
- /**
129
- * 摘要调用函数
130
- *
131
- * 由 Harness 层注入,ContextEngine 用它调用 LLM 生成摘要。
132
- * 这样 ContextEngine 不直接依赖 ModelProvider,保持解耦。
133
- *
134
- * 契约(迭代式更新):`options.previousSummary` 已按约定嵌入 `messages` 正文
135
- * ("Previous summary: …" 段),实现方无需再读 opts 拼 prompt;**返回值即完整
136
- * 更新后的摘要**,调用方不得再与旧摘要拼接。
137
- *
138
- * @param messages - 摘要请求消息(system 指令 + 用户正文;非原始对话序列)
139
- * @param options - 摘要选项
140
- * @returns 完整更新后的摘要文本
141
- */
142
- export type SummarizeFunction = (messages: LLMMessage[], options?: {
143
- /** 上次摘要(已嵌入 messages 正文;仅作元信息回传) */
144
- previousSummary?: string;
145
- /** 摘要 token 预算 */
146
- maxTokens?: number;
147
- /** 自定义指令 */
148
- instructions?: string;
149
- }) => Promise<string>;
150
- export interface AssembleResult {
151
- /** 组装好的 LLM 消息 */
239
+ export interface AssembleResult extends RequestView {
240
+ /**
241
+ * 组装好的 LLM 消息(来自 {@link RequestView})
242
+ *
243
+ * 与 `tools` 一起构成缓存前缀的原子单位;调用方不得只转发一半。
244
+ */
152
245
  messages: LLMMessage[];
153
246
  /** 实际 token 数(由 TokenEstimator 提供) */
154
247
  estimatedTokens: number;
@@ -157,12 +250,12 @@ export interface AssembleResult {
157
250
  /** 被丢弃/压缩的信息摘要(告诉模型"你失去了什么") */
158
251
  droppedSummary?: string;
159
252
  /**
160
- * 当前会话压缩摘要正文(previousSummary)。
161
- * 供调用方写回 Session 持久化;无摘要时为 undefined。
253
+ * 当前会话压缩摘要正文(最新 summary 型转换记录的文本)。
254
+ * 供调用方展示;无摘要时为 undefined。
162
255
  */
163
256
  summary?: string;
164
- /** 可持久化压缩状态快照(含 lastProactiveMessageCount 等) */
165
- compactState?: ContextCompactSnapshot;
257
+ /** estimatedTokens 的读数来源(pressure 快照可观测,评审 F5):calibrated/anchored/raw */
258
+ readingSource?: 'calibrated' | 'anchored' | 'raw';
166
259
  /** 不可信内容范围 */
167
260
  untrustedRanges?: Array<{
168
261
  start: number;
@@ -174,27 +267,14 @@ export interface IngestParams {
174
267
  sessionId: string;
175
268
  message: Message;
176
269
  }
177
- export interface CompactResult {
178
- ok: boolean;
179
- compacted: boolean;
180
- reason?: string;
181
- tokensBefore: number;
182
- tokensAfter?: number;
183
- summary?: string;
184
- /**
185
- * 摘要覆盖终点(下标,**不含**)= tailStart。
186
- * sticky 重建的增量起点;写 `messages.length` 会把 tail 误算进覆盖 → 滑出后丢消息。
187
- */
188
- coveredMessageCount?: number;
189
- }
190
- export interface AfterTurnParams {
270
+ export interface AfterStepParams {
191
271
  sessionId: string;
192
272
  /** E4: compact key component; engine state key falls back to sessionId when omitted */
193
273
  agentId?: string;
194
274
  /** 本轮消息 */
195
- turn: Message[];
275
+ step: Message[];
196
276
  /** 本轮 token 使用(cache-aware) */
197
- usage?: import('@octopi-agent/core/types/turn.js').TokenUsage;
277
+ usage?: import('@octopi-agent/core/types/step.js').TokenUsage;
198
278
  }
199
279
  /**
200
280
  * ContextEngine — 上下文管理引擎
@@ -206,11 +286,36 @@ export interface AfterTurnParams {
206
286
  *
207
287
  * 可选方法:
208
288
  * - ingest(): 存储消息
209
- * - afterTurn(): 更新状态(turn 为**本轮增量**消息)
289
+ * - afterStep(): 更新状态(step 为**本轮增量**消息)
210
290
  *
211
291
  * 本域契约(@layer harness/context);Harness 提供 DefaultContextEngine。
212
292
  */
213
293
  export interface ContextEngine {
294
+ /**
295
+ * 校准状态快照(可选,持久化配套):锚+样本计数导出——restore 后回填消除冷启动。
296
+ * @returns per-key 样本计数与锚
297
+ */
298
+ exportCalibration?(): {
299
+ samples: Record<string, {
300
+ samples: number;
301
+ }>;
302
+ anchors: Record<string, {
303
+ actual: number;
304
+ raw: number;
305
+ modelKey: string;
306
+ }>;
307
+ };
308
+ /** 校准状态恢复(可选):importCalibration 配对使用 */
309
+ importCalibration?(data: {
310
+ samples?: Record<string, {
311
+ samples: number;
312
+ }>;
313
+ anchors?: Record<string, {
314
+ actual: number;
315
+ raw: number;
316
+ modelKey: string;
317
+ }>;
318
+ }): void;
214
319
  readonly info: ContextEngineInfo;
215
320
  /**
216
321
  * 组装上下文
@@ -233,14 +338,15 @@ export interface ContextEngine {
233
338
  *
234
339
  * 用于更新内部统计、触发异步压缩等。
235
340
  */
236
- afterTurn?(params: AfterTurnParams): Promise<void>;
341
+ afterStep?(params: AfterStepParams): Promise<void>;
237
342
  }
238
343
  export interface SelectResult {
239
- /** 要保留的消息 */
344
+ /** 要保留的消息。**身份契约**:必须是入参数组的同引用对象(转换记录按对象身份
345
+ * 把产物翻译回原始区间;返回拷贝会让翻译失锚) */
240
346
  kept: Message[];
241
- /** 溢出的消息(需要压缩) */
347
+ /** 溢出的消息(需要压缩)。同上:同引用 */
242
348
  overflow: Message[];
243
- /** 尾部保护的消息 */
349
+ /** 尾部保护的消息。同上:同引用 */
244
350
  tail: Message[];
245
351
  /** 尾部 token 数 */
246
352
  tailTokens: number;
@@ -253,83 +359,54 @@ export interface SelectOptions {
253
359
  maxTokens: number;
254
360
  protectFirstN: number;
255
361
  protectLastN: number;
256
- }
257
- export interface MessageSelector {
258
- select(messages: Message[], options: SelectOptions, tokenEstimator?: TokenEstimator): SelectResult;
259
- }
260
- export interface CompressParams {
261
- messages: Message[];
262
- targetTokens: number;
263
- previousSummary?: string;
264
- summarize?: SummarizeFunction;
265
- tokenEstimator?: TokenEstimator;
266
362
  /**
267
- * 要求产出语义摘要:设置后,机械截断(旧工具输出截断/兜底截断)即使已达标
268
- * 也不得就此短路返回——必须尝试摘要级。主动摘要路径(applyProactiveCompact)使用:
269
- * 否则压缩成功但永不产摘要,状态机的复用分支永远无法启用。
363
+ * 度量视图(可选):与 `messages` **等长同序**,只用于 token 估算。
270
364
  *
271
- * 实现约定:仅约束「可摘要时不得走机械短路」;无摘要能力(如无 summarize)时
272
- * 的机械降级结果是允许的,调用方以「结果中无语义摘要」识别降级
273
- * (见 DefaultContextEngine.extractSummaryText)。
365
+ * 存在的理由(尺子与作用域同源):实际请求发的是**老化视图**,而压缩必须吃
366
+ * **原文**(F-b)。若用原文估算,老化越有效误判越大——原文 middle 797k /
367
+ * 视图 76k 时会每请求判溢出、每请求触发一次摘要,把前缀缓存整段烧掉。
368
+ * 切分仍按 `messages`(原文),仅估算看这里。
274
369
  */
275
- requireSummary?: boolean;
276
- /**
277
- * 缓存前缀:与会话 LLM 请求**同形**的 system+history(buildLlmMessages 产物)。
278
- * 摘要请求只许在其**尾部**追加指令;禁止改 system / 历史字节——否则打穿 provider 前缀缓存。
279
- */
280
- llmPrefix?: LLMMessage[];
281
- /** 摘要软目标预算(P1c clamp(2%, 2k, 8k) 的可配置 ratio/min/max) */
282
- summaryBudget?: {
283
- ratioPct?: number;
284
- minTokens?: number;
285
- maxTokens?: number;
286
- };
287
- /** 折叠区间(评审 F7):交接书替换范围与原样保留尾部——计数语义 */
288
- foldRange?: {
289
- replacedCount: number;
290
- total: number;
291
- preservedTail: number;
292
- };
293
- /** task 快照(B0:易变块走 content 尾部,不进 system) */
294
- taskSnapshot?: string;
295
- /** 会话模型窗口/输出上限(评审 F5):摘要硬顶按窗口钳制 */
296
- contextWindow?: number;
297
- maxOutputTokens?: number;
298
- /** 事件回调(F22:cache-miss 旁路可观测) */
299
- emit?: (e: {
300
- type: 'compact.summarize_fallback';
301
- reason?: string;
302
- cached?: boolean;
303
- }) => void;
370
+ measureMessages?: Message[];
304
371
  }
305
- export interface CompressResult {
306
- /** 压缩后的消息/摘要 */
307
- result: Message[];
308
- /** 估算 token 数 */
309
- estimatedTokens: number;
310
- /** 本次产出**新的**语义摘要(评审 F8-F1):仅 true 时调用方才可推进覆盖点/previousSummary。
311
- * 机械降级(截断/兜底/占位说明)必须显式 false——占位说明不得冒充语义摘要(fail-closed,F8R-01)。 */
312
- fresh: boolean;
313
- /** LLM 摘要调用是否真正发起过(成功/失败均算):只在 true 时推进冷却时间戳(F8R-01)。 */
314
- summarizeAttempted: boolean;
315
- /** 被丢弃的信息摘要 */
316
- droppedSummary?: string;
317
- }
318
- export interface Compressor {
319
- compress(params: CompressParams): Promise<CompressResult>;
372
+ export interface MessageSelector {
373
+ select(messages: Message[], options: SelectOptions, tokenEstimator?: TokenEstimator): SelectResult;
320
374
  }
321
375
  export interface BudgetAllocateParams {
322
376
  /** 可用 token 预算;未知窗口时可省略(见 budget-allocator) */
323
377
  tokenBudget?: number;
324
378
  contextWindow?: number;
379
+ /**
380
+ * 模型单次输出上限(= 请求实际携带的 max_tokens 上界)。
381
+ * 提供且物理窗口已知时,按硬预留计入 `outputReserve`——这是
382
+ * `input + max_tokens ≤ contextWindow` 不变量的唯一保证。
383
+ * 窗口未知(仅有 compactTargetTokens 等策略目标)时忽略:目标不是物理边界。
384
+ */
385
+ maxOutputTokens?: number;
325
386
  systemPromptTokens: number;
326
387
  toolTokens: number;
327
388
  }
328
389
  export interface BudgetAllocateResult {
329
- /** 消息可用的 token 预算 */
390
+ /**
391
+ * 输入侧硬上限(不变量):`system + tools + messages ≤ inputLimit`。
392
+ * 恒有 `inputLimit + outputReserve ≤ effectiveLimit`。
393
+ */
394
+ inputLimit: number;
395
+ /**
396
+ * 消息侧硬上限 = `inputLimit − system − tools − 请求信封`。
397
+ * `MessageSelector` / overflow 目标等**强制点**必须用这个值。
398
+ */
399
+ messagesLimit: number;
400
+ /**
401
+ * 消息侧软目标(压缩策略提示值,≤ messagesLimit)。
402
+ * 触发压缩的阈值挂这里;它允许小于 messagesLimit(提前压缩),
403
+ * 但任何强制点不得用它当作边界。
404
+ */
330
405
  messagesBudget: number;
331
- /** 预留给模型输出的 token */
406
+ /** 预留给模型输出的 token(有 maxOutputTokens 时即其值) */
332
407
  outputReserve: number;
408
+ /** 预算不可行:固定开销 + 输出预留已吃掉窗口(messagesLimit ≤ 0) */
409
+ infeasible?: boolean;
333
410
  }
334
411
  export interface BudgetAllocator {
335
412
  allocate(params: BudgetAllocateParams): BudgetAllocateResult;
@@ -6,4 +6,28 @@
6
6
  *
7
7
  * 接入:Builder 经 convertToLlm 调用 assemble;Loop 不依赖本类型。
8
8
  */
9
- export {};
9
+ /**
10
+ * 构造 contextSize 快照(唯一构造点:source/asOf 语义一致,禁止手抄字面量)。
11
+ *
12
+ * @param source - 读数来源(usage=provider 实测 / compact-est=压缩后估算)
13
+ * @param tokens - 全请求口径 token 数
14
+ * @returns 快照
15
+ */
16
+ export function contextSizeSnapshot(source, tokens) {
17
+ return { tokens, source, asOf: Date.now() };
18
+ }
19
+ /**
20
+ * ContextSizeSnapshot 形状守卫(所有摄入点共用,禁止各处手抄校验强度不一——评审 F-4)。
21
+ * metadata 是自由 JSON、事件/REST 是跨进程边界,脏值不得当读数显示。
22
+ *
23
+ * @param v - 待校验值
24
+ * @returns 是否合法快照
25
+ */
26
+ export function isContextSizeSnapshot(v) {
27
+ if (!v || typeof v !== 'object')
28
+ return false;
29
+ const s = v;
30
+ return (typeof s.tokens === 'number' &&
31
+ (s.source === 'usage' || s.source === 'compact-est') &&
32
+ typeof s.asOf === 'number');
33
+ }
@@ -12,8 +12,8 @@ import { type ProcessIsolationProfile } from './process-isolation.js';
12
12
  export type EffectRunMode = 'workspace' | 'project' | 'host' | 'untrusted';
13
13
  /**
14
14
  * Engine default when `effectPolicy.mode` is omitted (secure-by-default).
15
- * Scaffold/`octopi init` / `octopi.example.json` set `mode: "host"` explicitly
16
- * so evaluation gets full capability; embedders who omit `mode` get `workspace`.
15
+ * `octopi init` scaffolds `mode: "project"` (coding-agent profile);
16
+ * `octopi.example.json` sets `mode: "host"` explicitly for full local capability.
17
17
  * See `docs/process-isolation.md`.
18
18
  */
19
19
  export declare const DEFAULT_EFFECT_RUN_MODE: EffectRunMode;
@@ -101,7 +101,8 @@ export type SecurityDegradation = 'no_process_jail' | 'network_open' | 'env_inhe
101
101
  export interface EffectPolicyConfig {
102
102
  /**
103
103
  * Omitted = `DEFAULT_EFFECT_RUN_MODE` (**workspace**, secure-by-default).
104
- * Scaffold/config templates set `"mode": "host"` explicitly for local evaluation.
104
+ * `octopi init` scaffolds `"mode": "project"` (coding-agent profile);
105
+ * `octopi.example.json` demonstrates `"mode": "host"` explicitly for full local capability.
105
106
  */
106
107
  mode?: EffectRunMode;
107
108
  /**
@@ -14,8 +14,8 @@ import { resolveHitlOutcome } from '../../governance/human-in-the-loop/decision-
14
14
  import { getRunSessionId, getRunScope } from '../../run/run-scope.js';
15
15
  /**
16
16
  * Engine default when `effectPolicy.mode` is omitted (secure-by-default).
17
- * Scaffold/`octopi init` / `octopi.example.json` set `mode: "host"` explicitly
18
- * so evaluation gets full capability; embedders who omit `mode` get `workspace`.
17
+ * `octopi init` scaffolds `mode: "project"` (coding-agent profile);
18
+ * `octopi.example.json` sets `mode: "host"` explicitly for full local capability.
19
19
  * See `docs/process-isolation.md`.
20
20
  */
21
21
  export const DEFAULT_EFFECT_RUN_MODE = 'workspace';
@@ -18,7 +18,7 @@
18
18
  */
19
19
  import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
20
20
  /** 审计事件词表(§7) */
21
- export type OpsAuditEvent = 'ops.jail.state' | 'ops.command.executed' | 'ops.system_path.write' | 'ops.policy.degraded' | 'ops.config.security_changed' | 'ops.escalation.requested' | 'ops.escalation.denied' | 'ops.privileged.exec' | 'ops.kill_switch.tripped';
21
+ export type OpsAuditEvent = 'ops.jail.state' | 'ops.command.executed' | 'ops.system_path.write' | 'ops.policy.degraded' | 'ops.config.security_changed' | 'ops.knowledge.run_refused' | 'ops.escalation.requested' | 'ops.escalation.denied' | 'ops.privileged.exec' | 'ops.kill_switch.tripped';
22
22
  /** 账本条目(hash 链节点) */
23
23
  export interface OpsAuditEntry {
24
24
  /** 从 1 起单调递增 */
@@ -19,6 +19,7 @@ import { statSync, realpathSync } from 'node:fs';
19
19
  import { homedir, tmpdir } from 'node:os';
20
20
  import { dirname, isAbsolute, resolve, sep } from 'node:path';
21
21
  import { killProcessTree, scrubEnv } from './process-isolation.js';
22
+ import { elidedCharsMarker } from '@octopi-agent/core/elision.js';
22
23
  function envForExec() {
23
24
  // root 态下 PATH/HOME 都是注入面(per-user 配置、可写 PATH 目录)——钉死系统值。
24
25
  // 其余一律不透传(凭证/注入面收敛)。
@@ -33,7 +34,9 @@ function envForExec() {
33
34
  }
34
35
  const OUTPUT_CAP = 128 * 1024;
35
36
  function capOutput(text) {
36
- return text.length > OUTPUT_CAP ? `${text.slice(0, OUTPUT_CAP)}\n…[truncated ${text.length - OUTPUT_CAP} chars]` : text;
37
+ return text.length > OUTPUT_CAP
38
+ ? `${text.slice(0, OUTPUT_CAP)}\n${elidedCharsMarker(text.length - OUTPUT_CAP)}`
39
+ : text;
37
40
  }
38
41
  /**
39
42
  * 执行一条已匹配的提权命令(不经 shell、不包 jail、cwd 钉住)。
@@ -2,7 +2,7 @@
2
2
  * L1 资源限制 — 工具执行看门狗(ToolEffectPolicy / OP-17)
3
3
  *
4
4
  * 统一强制 `definition.timeoutMs`;与 abortSignal 联动。
5
- * run 级硬停(token/iteration)仍归 Budget/Run,不在此域。
5
+ * run 级硬停(token/step)仍归 Budget/Run,不在此域。
6
6
  */
7
7
  export declare class ToolTimeoutError extends Error {
8
8
  readonly timedOut = true;
@@ -2,7 +2,7 @@
2
2
  * L1 资源限制 — 工具执行看门狗(ToolEffectPolicy / OP-17)
3
3
  *
4
4
  * 统一强制 `definition.timeoutMs`;与 abortSignal 联动。
5
- * run 级硬停(token/iteration)仍归 Budget/Run,不在此域。
5
+ * run 级硬停(token/step)仍归 Budget/Run,不在此域。
6
6
  */
7
7
  export class ToolTimeoutError extends Error {
8
8
  timedOut = true;
@@ -146,7 +146,7 @@ export class FileWorkspace {
146
146
  // ── 内部工具 ──
147
147
  async execGit(args) {
148
148
  return new Promise((resolve, reject) => {
149
- const proc = spawn('git', args, { cwd: this.root });
149
+ const proc = spawn('git', args, { cwd: this.root, windowsHide: true });
150
150
  let stdout = '';
151
151
  proc.stdout.on('data', (d) => { stdout += d.toString(); });
152
152
  proc.on('close', (code) => {
@@ -6,10 +6,20 @@
6
6
  *
7
7
  * 设计要点:
8
8
  * - 本文件只定义契约,不关心 HTTP / WebSocket 传输
9
- * - Plugin 通过 registerChannel(adapter) 注册实现
9
+ * - Plugin 通过 registerChannel(id, factory) 贡献命名工厂(contributes.channels),
10
+ * 宿主按 channels[].plugin 引用实例化为本契约 adapter
10
11
  * - Gateway / Integration 按部署形态挂载具体 adapter
11
12
  */
12
- export type ChannelMessageDelivery = 'steered' | 'followup' | 'run';
13
+ export type ChannelMessageDelivery = 'continued' | 'followup' | 'run';
14
+ /**
15
+ * Channel labels owned by built-in adapters. Plugin contributions must not
16
+ * claim them. Reply routing looks up `channels.get(msg.channel)` — i.e. by the
17
+ * **message label**, not by adapter name: the built-in HttpChannelAdapter
18
+ * emits `channel: 'http'` (REST) and `channel: 'ws'` (WebSocket), so a plugin
19
+ * registering either label would intercept built-in replies and command
20
+ * short-replies.
21
+ */
22
+ export declare const BUILTIN_CHANNEL_IDS: readonly ["http", "ws"];
13
23
  export interface ChannelMessage {
14
24
  id: string;
15
25
  channel: string;
@@ -31,9 +41,25 @@ export interface ChannelReply {
31
41
  replyToId?: string;
32
42
  metadata?: Record<string, unknown>;
33
43
  }
44
+ /**
45
+ * Adapter runtime state for health aggregation. `retiring` marks the drain
46
+ * window before a hot-reload swap or shutdown; `degraded` means the adapter is
47
+ * alive but impaired (e.g. backing off after repeated failures).
48
+ */
49
+ export interface ChannelAdapterStatus {
50
+ state: 'running' | 'dormant' | 'degraded' | 'retiring';
51
+ /** Human-readable elaboration, e.g. why the adapter is degraded. */
52
+ detail?: string;
53
+ }
34
54
  export interface ChannelAdapter {
35
55
  name: string;
36
56
  start(handler: (msg: ChannelMessage) => Promise<void>): Promise<void>;
37
57
  send(reply: ChannelReply): Promise<void>;
38
58
  stop(): Promise<void>;
59
+ /**
60
+ * Optional health probe. Adapters that do not implement it are reported as
61
+ * `running` after a successful start() — the contract guarantees start/stop
62
+ * symmetry, so "started" is the truthful default, not a placeholder.
63
+ */
64
+ status?(): ChannelAdapterStatus;
39
65
  }
@@ -6,7 +6,16 @@
6
6
  *
7
7
  * 设计要点:
8
8
  * - 本文件只定义契约,不关心 HTTP / WebSocket 传输
9
- * - Plugin 通过 registerChannel(adapter) 注册实现
9
+ * - Plugin 通过 registerChannel(id, factory) 贡献命名工厂(contributes.channels),
10
+ * 宿主按 channels[].plugin 引用实例化为本契约 adapter
10
11
  * - Gateway / Integration 按部署形态挂载具体 adapter
11
12
  */
12
- export {};
13
+ /**
14
+ * Channel labels owned by built-in adapters. Plugin contributions must not
15
+ * claim them. Reply routing looks up `channels.get(msg.channel)` — i.e. by the
16
+ * **message label**, not by adapter name: the built-in HttpChannelAdapter
17
+ * emits `channel: 'http'` (REST) and `channel: 'ws'` (WebSocket), so a plugin
18
+ * registering either label would intercept built-in replies and command
19
+ * short-replies.
20
+ */
21
+ export const BUILTIN_CHANNEL_IDS = ['http', 'ws'];
@@ -81,6 +81,18 @@ export declare class ClientToolRegistry {
81
81
  listProviders(sessionId: string, now?: number): ClientToolProvider[];
82
82
  /** 会话内是否有 live provider(tool 面过滤用) */
83
83
  hasLiveProvider(sessionId: string, name: ClientToolName, now?: number): boolean;
84
+ /**
85
+ * 快照枚举:live provider 覆盖的 (session, tool) 对。
86
+ * 可见性谓词数据化(ClientToolVisibilitySnapshot)的数据源;run 侧本地求值。
87
+ *
88
+ * @param toolNames - 关心的工具名(通常是已安装客户端工具全集)
89
+ * @param now - 可选时间点(测试用)
90
+ * @returns live 对列表
91
+ */
92
+ livePairs(toolNames: ClientToolName[], now?: number): Array<{
93
+ sessionId: string;
94
+ toolName: ClientToolName;
95
+ }>;
84
96
  /** 全局是否仍有任一 live provider(决定能否 uninstall) */
85
97
  hasAnyProvider(name: ClientToolName, now?: number): boolean;
86
98
  getDescriptor(sessionId: string, name: ClientToolName, now?: number): ClientToolDescriptor | undefined;