@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
@@ -4,11 +4,12 @@
4
4
  * 设计约定(架构收口,见 docs/architecture.md):
5
5
  * 1. 每个 run / 每个 catalog 条目只 resolve 一次
6
6
  * 2. 下游只读 ResolvedModel,禁止二次回退
7
- * 3. **contextWindow 仅认显式配置**;未配置 = unknown,不猜测
7
+ * 3. **contextWindow 认显式配置,或 provider 测量真值(F 类回填)**;两者皆无 = unknown,不猜测
8
8
  * 4. 会话覆盖到另一模型时,不继承 agent 默认模型的窗口
9
9
  *
10
10
  * @module harness/run/model/resolver
11
11
  */
12
+ import { getWindowTruth } from './window-truth.js';
12
13
  /**
13
14
  * 解析 `provider/model` 或裸模型名
14
15
  *
@@ -59,24 +60,31 @@ function positive(n) {
59
60
  */
60
61
  export function lookupModelCapability(input) {
61
62
  const { provider, modelName, explicit } = input;
63
+ // 能力声明(reasoning/input)与窗口判定解耦:无窗口也可能有声明
64
+ const info = provider && modelName ? provider.getModelInfo(modelName) : undefined;
65
+ const reasoning = info?.reasoning;
66
+ const inputModalities = info?.input;
62
67
  // explicit(调用方带来的配置声明)优先
63
68
  const explicitWindow = positive(explicit?.contextWindow);
64
69
  if (explicitWindow) {
65
70
  return {
66
71
  contextWindow: explicitWindow,
67
72
  maxOutputTokens: positive(explicit?.maxOutputTokens),
73
+ reasoning,
74
+ input: inputModalities,
68
75
  source: 'config',
69
76
  known: true,
70
77
  };
71
78
  }
72
79
  // provider ModelInfo(仅当构造 provider 时来自用户 models[] 配置)
73
80
  if (provider && modelName) {
74
- const info = provider.getModelInfo(modelName);
75
81
  const w = positive(info?.contextWindow);
76
82
  if (w) {
77
83
  return {
78
84
  contextWindow: w,
79
85
  maxOutputTokens: positive(info?.maxOutputTokens) ?? positive(explicit?.maxOutputTokens),
86
+ reasoning,
87
+ input: inputModalities,
80
88
  source: 'config',
81
89
  known: true,
82
90
  };
@@ -84,6 +92,8 @@ export function lookupModelCapability(input) {
84
92
  }
85
93
  return {
86
94
  maxOutputTokens: positive(explicit?.maxOutputTokens),
95
+ reasoning,
96
+ input: inputModalities,
87
97
  source: 'unknown',
88
98
  known: false,
89
99
  };
@@ -109,6 +119,24 @@ export function resolveModel(input) {
109
119
  });
110
120
  const bound = bindModelName(raw, modelName);
111
121
  const provider = wrapProvider ? wrapProvider(bound, providerName) : bound;
122
+ // F 类真值回填(T2②,红线 3):provider 测量 > 配置预测——配置漂移/缺失时
123
+ // 前馈直接用真值(守门人反哺调度器)。真值只覆盖窗口,不改 maxOutputTokens。
124
+ const truth = getWindowTruth(`${providerName}/${modelName}`);
125
+ if (truth) {
126
+ return {
127
+ ref: `${providerName}/${modelName}`,
128
+ providerName,
129
+ modelName,
130
+ provider,
131
+ contextWindow: truth.tokens,
132
+ maxOutputTokens: cap.maxOutputTokens,
133
+ reasoning: cap.reasoning,
134
+ input: cap.input,
135
+ source: 'measured',
136
+ known: true,
137
+ isOverride,
138
+ };
139
+ }
112
140
  return {
113
141
  ref: `${providerName}/${modelName}`,
114
142
  providerName,
@@ -116,6 +144,8 @@ export function resolveModel(input) {
116
144
  provider,
117
145
  contextWindow: cap.contextWindow,
118
146
  maxOutputTokens: cap.maxOutputTokens,
147
+ reasoning: cap.reasoning,
148
+ input: cap.input,
119
149
  source: cap.known ? 'config' : 'unknown',
120
150
  known: cap.known,
121
151
  isOverride,
@@ -159,6 +189,8 @@ export function resolveCatalogEntry(input) {
159
189
  model: resolved.modelName,
160
190
  contextWindow: resolved.contextWindow ?? null,
161
191
  maxOutputTokens: resolved.maxOutputTokens,
192
+ reasoning: resolved.reasoning,
193
+ input: resolved.input,
162
194
  known: resolved.known,
163
195
  source: resolved.source,
164
196
  };
@@ -173,6 +205,8 @@ export function resolveCatalogEntry(input) {
173
205
  model: input.modelName,
174
206
  contextWindow: cap.contextWindow ?? null,
175
207
  maxOutputTokens: cap.maxOutputTokens,
208
+ reasoning: cap.reasoning,
209
+ input: cap.input,
176
210
  known: cap.known,
177
211
  source: cap.known ? 'config' : 'unknown',
178
212
  };
@@ -22,6 +22,8 @@ export declare function withResolvedModel<T>(snapshot: ResolvedModel | undefined
22
22
  * @returns 快照;无覆盖时 undefined
23
23
  */
24
24
  export declare function getResolvedModel(): ResolvedModel | undefined;
25
+ /** Host-internal: synchronize a Core-authorized model with the full snapshot. */
26
+ export declare function updateResolvedModel(snapshot: ResolvedModel): void;
25
27
  /**
26
28
  * 读取当前 run 的 provider(无覆盖时回退)
27
29
  *
@@ -37,6 +37,13 @@ export async function* withResolvedModel(snapshot, gen) {
37
37
  export function getResolvedModel() {
38
38
  return runModelStorage.getStore()?.snapshot;
39
39
  }
40
+ /** Host-internal: synchronize a Core-authorized model with the full snapshot. */
41
+ export function updateResolvedModel(snapshot) {
42
+ const store = runModelStorage.getStore();
43
+ if (!store)
44
+ throw new Error('Cannot update the model outside a resolved Run scope');
45
+ store.snapshot = snapshot;
46
+ }
40
47
  /**
41
48
  * 读取当前 run 的 provider(无覆盖时回退)
42
49
  *
@@ -1,19 +1,30 @@
1
1
  /**
2
2
  * ResolvedModel — run/catalog 级模型快照
3
3
  *
4
- * contextWindow **仅**来自显式配置;未配置时为 undefined(未知),
5
- * 下游禁止用 builtin/默认值「猜」窗口。
4
+ * contextWindow 来自显式配置,或 provider 测量回填(长度类 400 报告的真值),
5
+ * 或 400 后的 run 级收缩上界;三者皆无时为 undefined(未知),下游禁止用
6
+ * builtin/默认值「猜」窗口。
6
7
  *
7
8
  * @module harness/run/model/types
8
9
  */
9
10
  import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
10
- /** contextWindow / maxTokens 的声明来源 */
11
- export type ModelCapabilitySource = 'config' | 'unknown';
11
+ import type { ModelInputType } from '@octopi-agent/core/types/agent-definition.js';
12
+ /**
13
+ * contextWindow / maxTokens 的声明来源
14
+ *
15
+ * `config`:显式配置(models.providers[].models[] / agent.model);
16
+ * `measured`:provider 长度类 400 错误文本报告的窗口真值(F 类回填,见
17
+ * window-truth.ts)——测量优先于预测;
18
+ * `shrunk`:长度类 400 后的收缩上界(run 级保守猜测,非持久真值);
19
+ * `unknown`:两者皆无(不猜测)。
20
+ */
21
+ export type ModelCapabilitySource = 'config' | 'measured' | 'shrunk' | 'unknown';
12
22
  /**
13
23
  * 已解析模型快照
14
24
  *
15
25
  * 不变量:
16
- * - `contextWindow` 有值 ⇔ `known === true` ⇔ 来自配置
26
+ * - `contextWindow` 有值 ⇔ `known === true`;来源见 `source`(config 显式配置 /
27
+ * measured provider 窗口真值 / shrunk run 级收缩上界)
17
28
  * - `contextWindow === undefined` 时,基于窗口的自动压缩/预算截断必须跳过
18
29
  * - `provider` 已 `bindModelName`,`defaultModel === modelName`
19
30
  */
@@ -28,6 +39,9 @@ export interface ResolvedModel {
28
39
  /** 显式配置的上下文窗口;未配置 = 未知 */
29
40
  contextWindow?: number;
30
41
  maxOutputTokens?: number;
42
+ /** 能力声明(models.providers[].models[] 透传;未声明不猜测) */
43
+ reasoning?: boolean;
44
+ input?: ModelInputType[];
31
45
  source: ModelCapabilitySource;
32
46
  /** contextWindow 是否来自显式配置 */
33
47
  known: boolean;
@@ -42,6 +56,9 @@ export interface ModelCatalogEntry {
42
56
  /** 未配置时为 null */
43
57
  contextWindow: number | null;
44
58
  maxOutputTokens?: number;
59
+ /** 能力声明(models.providers[].models[] 透传;未声明不猜测) */
60
+ reasoning?: boolean;
61
+ input?: ModelInputType[];
45
62
  known: boolean;
46
63
  source: ModelCapabilitySource;
47
64
  }
@@ -1,8 +1,9 @@
1
1
  /**
2
2
  * ResolvedModel — run/catalog 级模型快照
3
3
  *
4
- * contextWindow **仅**来自显式配置;未配置时为 undefined(未知),
5
- * 下游禁止用 builtin/默认值「猜」窗口。
4
+ * contextWindow 来自显式配置,或 provider 测量回填(长度类 400 报告的真值),
5
+ * 或 400 后的 run 级收缩上界;三者皆无时为 undefined(未知),下游禁止用
6
+ * builtin/默认值「猜」窗口。
6
7
  *
7
8
  * @module harness/run/model/types
8
9
  */
@@ -0,0 +1,37 @@
1
+ /**
2
+ * per-model 窗口真值注册表(F 类真值回填,arch/overflow-redesign.md T2②)
3
+ *
4
+ * 「配置窗口是预测、provider 是测量」:长度类 400 的错误文本常带 provider
5
+ * 报告的窗口上限(如 OpenAI "maximum context length is 128000 tokens")——
6
+ * 这是唯一知道真窗口的机制(守门人反哺调度器)。提取到的真值在此登记,
7
+ * resolver 解析能力时优先于配置声明(`source: 'measured'`)。
8
+ *
9
+ * 只登记 provider 报告的**真值**;T2③ 的收缩上界是保守猜测,只在 run 级
10
+ * 快照生效(见 context-length-feedback.ts),不入本表——猜测持久化会永久削窗。
11
+ *
12
+ * 状态为进程内存;重启后丢失的代价 = 再吃一次 400 重新回填(side effect,
13
+ * 非主路径依赖),可接受。
14
+ *
15
+ * @module harness/run/model/window-truth
16
+ */
17
+ /** 真值条目 */
18
+ export interface WindowTruthEntry {
19
+ /** provider 报告的窗口上限(tokens) */
20
+ tokens: number;
21
+ }
22
+ /**
23
+ * 登记 per-model 窗口真值(覆盖旧值——provider 的最新测量即真值)
24
+ *
25
+ * @param ref - 模型引用(`provider/modelName`,与 ResolvedModel.ref 同构)
26
+ * @param tokens - provider 报告的窗口上限
27
+ */
28
+ export declare function recordWindowTruth(ref: string, tokens: number): void;
29
+ /**
30
+ * 查询 per-model 窗口真值
31
+ *
32
+ * @param ref - 模型引用
33
+ * @returns 真值条目;未登记时 undefined
34
+ */
35
+ export declare function getWindowTruth(ref: string): WindowTruthEntry | undefined;
36
+ /** 清空注册表(测试用) */
37
+ export declare function resetWindowTruth(): void;
@@ -0,0 +1,39 @@
1
+ /**
2
+ * per-model 窗口真值注册表(F 类真值回填,arch/overflow-redesign.md T2②)
3
+ *
4
+ * 「配置窗口是预测、provider 是测量」:长度类 400 的错误文本常带 provider
5
+ * 报告的窗口上限(如 OpenAI "maximum context length is 128000 tokens")——
6
+ * 这是唯一知道真窗口的机制(守门人反哺调度器)。提取到的真值在此登记,
7
+ * resolver 解析能力时优先于配置声明(`source: 'measured'`)。
8
+ *
9
+ * 只登记 provider 报告的**真值**;T2③ 的收缩上界是保守猜测,只在 run 级
10
+ * 快照生效(见 context-length-feedback.ts),不入本表——猜测持久化会永久削窗。
11
+ *
12
+ * 状态为进程内存;重启后丢失的代价 = 再吃一次 400 重新回填(side effect,
13
+ * 非主路径依赖),可接受。
14
+ *
15
+ * @module harness/run/model/window-truth
16
+ */
17
+ const truthByRef = new Map();
18
+ /**
19
+ * 登记 per-model 窗口真值(覆盖旧值——provider 的最新测量即真值)
20
+ *
21
+ * @param ref - 模型引用(`provider/modelName`,与 ResolvedModel.ref 同构)
22
+ * @param tokens - provider 报告的窗口上限
23
+ */
24
+ export function recordWindowTruth(ref, tokens) {
25
+ truthByRef.set(ref, { tokens });
26
+ }
27
+ /**
28
+ * 查询 per-model 窗口真值
29
+ *
30
+ * @param ref - 模型引用
31
+ * @returns 真值条目;未登记时 undefined
32
+ */
33
+ export function getWindowTruth(ref) {
34
+ return truthByRef.get(ref);
35
+ }
36
+ /** 清空注册表(测试用) */
37
+ export function resetWindowTruth() {
38
+ truthByRef.clear();
39
+ }
@@ -0,0 +1,77 @@
1
+ /**
2
+ * F 类反馈环(arch/overflow-redesign.md T2②③)
3
+ *
4
+ * 长度类 400 的处理次序(错误分类是命门——只有 isContextLengthErrorText
5
+ * 判中的 400 才会走到这里):
6
+ *
7
+ * ② 真值回填(side effect,非主路径依赖):错误文本带 provider 报告的窗口
8
+ * 上限 → 登记 per-model 真值(window-truth.ts,测量 > 配置预测)+ 更新
9
+ * run 快照 → 下次装配前馈直接用新值(红线 3)。
10
+ * ③ 提取不到 → 收缩上界:min(上次成功请求实测, 已知值×0.7);缺一边时用
11
+ * 存在的一边(只有实测 → 实测;只有已知值 → ×0.7)。收缩是保守猜测,
12
+ * 只写 run 级快照(source:'shrunk'),**不入真值表**——猜测持久化会永久削窗。
13
+ *
14
+ * ④ 机械压缩不在此处:retry 重跑迭代 → transformContext 重新装配 → fits
15
+ * 判据对新上界失效 → P1 收敛阶梯自动砍(守门=发送同一产物)。
16
+ *
17
+ * 收缩上界写入后粘滞整个 run(ResolvedModel 是 run 级快照);后续若同 run
18
+ * 再遇 400 且文本带真值,②的真值会覆盖收缩值。
19
+ *
20
+ * 复利语义:「已知值×0.7」里的已知值 = 当前 run 快照值,因此第二次收缩是在
21
+ * 上一次收缩值上再 ×0.7(200k→140k→98k)。方向保守(宁小勿大)——「防砍
22
+ * 不给力连环 400」优先于容量浪费;重发限 2 兜底。
23
+ *
24
+ * @module harness/run/reliability/context-length-feedback
25
+ */
26
+ import type { ClassifiedError } from '@octopi-agent/core/interfaces/error-strategy.js';
27
+ /** 反馈结果 */
28
+ export interface ContextLengthFeedbackResult {
29
+ /** backfilled=真值回填;shrunk=收缩上界;noop=两者皆无可写 */
30
+ action: 'backfilled' | 'shrunk' | 'noop';
31
+ /** 生效的窗口上界(noop 时 undefined) */
32
+ bound?: number;
33
+ /** 提取到的 provider 真值(仅 backfilled) */
34
+ measured?: number;
35
+ }
36
+ /** 收缩公式输入 */
37
+ export interface ShrinkInput {
38
+ /** 上次成功请求实测 prompt tokens(provider usage 真值) */
39
+ lastSuccessActual?: number;
40
+ /** 已知窗口值(config 或此前的真值/收缩值) */
41
+ knownWindow?: number;
42
+ }
43
+ /**
44
+ * T2③ 收缩上界计算(纯函数)。
45
+ *
46
+ * `min(上次成功请求实测, 已知值×0.7)`;缺一边时用存在的一边;全缺 → undefined
47
+ * (无可收缩依据——重发原样必然再 400,由重发限 2 收口)。
48
+ *
49
+ * @param input - 上次成功实测 + 已知窗口
50
+ * @returns 收缩后的窗口上界;无法收缩时 undefined
51
+ */
52
+ export declare function computeShrunkWindowBound(input: ShrinkInput): number | undefined;
53
+ /**
54
+ * 应用 F 类反馈(onError 链路上的 side effect)。
55
+ *
56
+ * 读取当前 run 的 ResolvedModel 快照:②真值 → 登记 + 快照换 `measured`;
57
+ * ③收缩 → 快照换 `shrunk`。无 run 快照(非 resolved run)时无 ref 可登记、
58
+ * 无快照可更新——如实返回 noop(side effect 丢失,下次 400 再走一遍)。
59
+ *
60
+ * @param error - 已分类错误(须为 context_length 才有意义)
61
+ * @param opts.lastSuccessActual - 上次成功请求实测 prompt tokens
62
+ * @returns 反馈结果(含生效上界,供审计/告警)
63
+ */
64
+ export declare function applyContextLengthFeedback(error: ClassifiedError, opts?: {
65
+ lastSuccessActual?: number;
66
+ /** 会话 ID(告警载荷;来自 run-agent state/harness) */
67
+ sessionId?: string;
68
+ /** P3 告警出口(T2 触发):宿主接 Hub/EventBus;缺省仅日志 */
69
+ onAlert?: (alert: {
70
+ type: 'context.overflow.alert';
71
+ sessionId: string;
72
+ symptom: 'config_drift' | 'config_missing' | 'window_mismatch';
73
+ message: string;
74
+ contextWindow?: number;
75
+ trigger: 'T2';
76
+ }) => void;
77
+ }): ContextLengthFeedbackResult;
@@ -0,0 +1,128 @@
1
+ /**
2
+ * F 类反馈环(arch/overflow-redesign.md T2②③)
3
+ *
4
+ * 长度类 400 的处理次序(错误分类是命门——只有 isContextLengthErrorText
5
+ * 判中的 400 才会走到这里):
6
+ *
7
+ * ② 真值回填(side effect,非主路径依赖):错误文本带 provider 报告的窗口
8
+ * 上限 → 登记 per-model 真值(window-truth.ts,测量 > 配置预测)+ 更新
9
+ * run 快照 → 下次装配前馈直接用新值(红线 3)。
10
+ * ③ 提取不到 → 收缩上界:min(上次成功请求实测, 已知值×0.7);缺一边时用
11
+ * 存在的一边(只有实测 → 实测;只有已知值 → ×0.7)。收缩是保守猜测,
12
+ * 只写 run 级快照(source:'shrunk'),**不入真值表**——猜测持久化会永久削窗。
13
+ *
14
+ * ④ 机械压缩不在此处:retry 重跑迭代 → transformContext 重新装配 → fits
15
+ * 判据对新上界失效 → P1 收敛阶梯自动砍(守门=发送同一产物)。
16
+ *
17
+ * 收缩上界写入后粘滞整个 run(ResolvedModel 是 run 级快照);后续若同 run
18
+ * 再遇 400 且文本带真值,②的真值会覆盖收缩值。
19
+ *
20
+ * 复利语义:「已知值×0.7」里的已知值 = 当前 run 快照值,因此第二次收缩是在
21
+ * 上一次收缩值上再 ×0.7(200k→140k→98k)。方向保守(宁小勿大)——「防砍
22
+ * 不给力连环 400」优先于容量浪费;重发限 2 兜底。
23
+ *
24
+ * @module harness/run/reliability/context-length-feedback
25
+ */
26
+ import { extractContextWindowLimit, collectErrorText } from '@octopi-agent/core/loop/error-classifier.js';
27
+ import { getResolvedModel, updateResolvedModel } from '../model/run-scope.js';
28
+ import { recordWindowTruth } from '../model/window-truth.js';
29
+ /**
30
+ * T2③ 收缩上界计算(纯函数)。
31
+ *
32
+ * `min(上次成功请求实测, 已知值×0.7)`;缺一边时用存在的一边;全缺 → undefined
33
+ * (无可收缩依据——重发原样必然再 400,由重发限 2 收口)。
34
+ *
35
+ * @param input - 上次成功实测 + 已知窗口
36
+ * @returns 收缩后的窗口上界;无法收缩时 undefined
37
+ */
38
+ export function computeShrunkWindowBound(input) {
39
+ const candidates = [];
40
+ if (input.lastSuccessActual != null && input.lastSuccessActual > 0) {
41
+ candidates.push(input.lastSuccessActual);
42
+ }
43
+ if (input.knownWindow != null && input.knownWindow > 0) {
44
+ candidates.push(input.knownWindow * 0.7);
45
+ }
46
+ if (candidates.length === 0)
47
+ return undefined;
48
+ return Math.floor(Math.min(...candidates));
49
+ }
50
+ /**
51
+ * 应用 F 类反馈(onError 链路上的 side effect)。
52
+ *
53
+ * 读取当前 run 的 ResolvedModel 快照:②真值 → 登记 + 快照换 `measured`;
54
+ * ③收缩 → 快照换 `shrunk`。无 run 快照(非 resolved run)时无 ref 可登记、
55
+ * 无快照可更新——如实返回 noop(side effect 丢失,下次 400 再走一遍)。
56
+ *
57
+ * @param error - 已分类错误(须为 context_length 才有意义)
58
+ * @param opts.lastSuccessActual - 上次成功请求实测 prompt tokens
59
+ * @returns 反馈结果(含生效上界,供审计/告警)
60
+ */
61
+ export function applyContextLengthFeedback(error, opts = {}) {
62
+ const text = collectText(error);
63
+ // ② 真值回填:provider 报告的窗口上限
64
+ const measured = extractContextWindowLimit(text);
65
+ const snapshot = getResolvedModel();
66
+ if (measured != null && snapshot) {
67
+ recordWindowTruth(snapshot.ref, measured);
68
+ // 「contextWindow 配置漂移/缺失」告警(T2⑥/红线 7 同族):真值与配置不一致
69
+ // 或原配置缺失 = 配置病,必须运维可见——每次触发打告警,不当日常
70
+ if (snapshot.contextWindow !== measured) {
71
+ const symptom = snapshot.contextWindow == null ? 'config_missing' : 'config_drift';
72
+ const message = `[overflow] contextWindow ${symptom === 'config_missing' ? '配置缺失' : '配置漂移'}:ref=${snapshot.ref} configured=${snapshot.contextWindow ?? 'missing'} measured=${measured}(真值回填)`;
73
+ console.warn(message);
74
+ opts.onAlert?.({
75
+ type: 'context.overflow.alert',
76
+ sessionId: opts.sessionId ?? 'unknown',
77
+ symptom,
78
+ message,
79
+ contextWindow: measured,
80
+ trigger: 'T2',
81
+ });
82
+ }
83
+ updateResolvedModel({
84
+ ...snapshot,
85
+ contextWindow: measured,
86
+ source: 'measured',
87
+ known: true,
88
+ });
89
+ return { action: 'backfilled', bound: measured, measured };
90
+ }
91
+ // ③ 收缩上界:保守猜测,只写 run 快照
92
+ const shrunk = computeShrunkWindowBound({
93
+ lastSuccessActual: opts.lastSuccessActual,
94
+ knownWindow: snapshot?.contextWindow,
95
+ });
96
+ if (shrunk != null && snapshot) {
97
+ // 无实证(真值提取不到)不得断言配置漂移——配置可能正确、是尺子偏差(E 类);
98
+ // 语义为「请求超真窗口但归因未定」,收缩只是保守兜底
99
+ const symptom = 'window_mismatch';
100
+ const message = `[overflow] contextWindow 归因未定:ref=${snapshot.ref} known=${snapshot.contextWindow ?? 'missing'} lastSuccessActual=${opts.lastSuccessActual ?? 'missing'} -> bound=${shrunk}(收缩上界,未提取到真值——配置或尺子偏差待查)`;
101
+ console.warn(message);
102
+ opts.onAlert?.({
103
+ type: 'context.overflow.alert',
104
+ sessionId: opts.sessionId ?? 'unknown',
105
+ symptom,
106
+ message,
107
+ contextWindow: shrunk,
108
+ trigger: 'T2',
109
+ });
110
+ updateResolvedModel({
111
+ ...snapshot,
112
+ contextWindow: shrunk,
113
+ source: 'shrunk',
114
+ known: true,
115
+ });
116
+ return { action: 'shrunk', bound: shrunk };
117
+ }
118
+ return { action: 'noop' };
119
+ }
120
+ /** 错误文本:与分类器同源(复用 collectErrorText,支持普通对象 / cause / code) */
121
+ function collectText(error) {
122
+ const fromOriginal = collectErrorText(error.originalError);
123
+ // `message` 对对象型错误会被抹成 "[object Object]",此时只信原始对象文本
124
+ if (error.message && !error.message.startsWith('[object ')) {
125
+ return `${error.message}\n${fromOriginal}`;
126
+ }
127
+ return fromOriginal;
128
+ }
@@ -30,12 +30,12 @@ export interface BudgetControlEvent {
30
30
  userMessage: string;
31
31
  resumeHint?: string;
32
32
  }
33
- /** 资源 hard 总闸触发(P0:无 tokens 轴;wall_clock/iteration/tool_calls) */
33
+ /** 资源 hard 总闸触发(P0:无 tokens 轴;wall_clock/steps/tool_calls) */
34
34
  export type BudgetExceededEvent = {
35
35
  type: 'budget_exceeded';
36
36
  timestamp: number;
37
37
  data: {
38
- reason: 'wall_clock' | 'iteration' | 'tool_calls';
38
+ reason: 'wall_clock' | 'steps' | 'tool_calls';
39
39
  report?: unknown;
40
40
  };
41
41
  };
@@ -64,7 +64,7 @@ export type RunGuardMetricsEvent = {
64
64
  data: {
65
65
  sessionId?: string;
66
66
  agentId?: string;
67
- iteration: number;
67
+ steps: number;
68
68
  totalToolCalls: number;
69
69
  /** 诊断 nominal Σ(非成本 hard) */
70
70
  nominalTotalTokens: number;
@@ -30,6 +30,10 @@ export const MODEL_ERROR_MAX_ATTEMPTS = {
30
30
  // 内容过滤拒答多为阈值型误杀(同请求重试常过);给 2 次原样重试,
31
31
  // 仍被拦则如实收口(不教模型换说法绕过审核)
32
32
  content_filter: 2,
33
+ // 长度类 400(F 类,arch/overflow-redesign.md T2⑤):重发前已收缩上界 +
34
+ // 重装配砍量,必须重试;限 2 次防「砍不给力」连环 400(再 400 = 模型/
35
+ // 会话不适配,L3 语义收口换 session/model)
36
+ context_length: 2,
33
37
  };
34
38
  /**
35
39
  * 查询某错误原因允许的重试次数
@@ -11,8 +11,8 @@
11
11
  * - ErrorStrategy 重试策略(通过 onError 注入)
12
12
  *
13
13
  * 设计原则:
14
- * - 使用 onTurnComplete 做副作用(注入 steer 指令),不直接控制停止
15
- * - 使用 shouldStopAfterTurn 做停止决策(critical 循环、RunGuard)
14
+ * - 使用 onStepComplete 做副作用(注入 steer 指令),不直接控制停止
15
+ * - 使用 shouldStopAfterStep 做停止决策(critical 循环、RunGuard)
16
16
  * - 两层分离,不互相覆盖
17
17
  */
18
18
  import type { AgentContext, AgentLoopConfig } from '@octopi-agent/core/loop/types.js';
@@ -39,7 +39,7 @@ export interface ReliabilityConfig {
39
39
  /** wrap-up 相关配置 */
40
40
  wrapUp?: {
41
41
  /** wrap-up 窗口的轮次数(默认 3) */
42
- turns?: number;
42
+ steps?: number;
43
43
  /** Policy 触达时的行为(默认 wrap_up_then_stop) */
44
44
  onPolicyHit?: 'stop' | 'wrap_up_then_stop';
45
45
  /** context 轴 wrap-up 触发阈值比例(默认 0.85) */
@@ -83,4 +83,10 @@ export interface ConcreteReliabilityHarness extends CoreReliabilityHarness {
83
83
  *
84
84
  * 包装 agentLoop(),注入所有可靠性行为。
85
85
  */
86
- export declare function runAgentWithReliability(context: AgentContext, config: AgentLoopConfig, harness: CoreReliabilityHarness, signal?: AbortSignal): AsyncGenerator<HarnessLoopEvent>;
86
+ export declare function runAgentWithReliability(context: AgentContext, config: AgentLoopConfig, harness: CoreReliabilityHarness, signal?: AbortSignal, options?: {
87
+ /**
88
+ * 本 Run 的工具运行时(Runner/Agent.run 显式传入,与 runScope.toolRuntime 同一对象)。
89
+ * noteHumanWait 钩子装在它身上;显式传参消除 ALS 隐式绑定的错绑面(可绑到外层 run)。
90
+ */
91
+ toolRuntime?: import('../run-scope.js').RunToolRuntime;
92
+ }): AsyncGenerator<HarnessLoopEvent>;