@octopi-agent/engine 0.98.4 → 0.102.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (301) hide show
  1. package/dist/config-schema/agent.d.ts +35 -5
  2. package/dist/config-schema/agent.js +24 -4
  3. package/dist/config-schema/context.d.ts +6 -36
  4. package/dist/config-schema/context.js +4 -28
  5. package/dist/config-schema/engine.d.ts +57 -160
  6. package/dist/config-schema/engine.js +1 -5
  7. package/dist/config-schema/governance.d.ts +8 -1
  8. package/dist/config-schema/governance.js +8 -1
  9. package/dist/config-schema/models.d.ts +2 -8
  10. package/dist/config-schema/models.js +0 -2
  11. package/dist/config-schema/run.d.ts +2 -2
  12. package/dist/config-schema/run.js +2 -2
  13. package/dist/config-schema/shared.d.ts +0 -3
  14. package/dist/config-schema/shared.js +0 -2
  15. package/dist/config-schema/substrate.d.ts +14 -88
  16. package/dist/config-schema/substrate.js +22 -107
  17. package/dist/config.d.ts +45 -113
  18. package/dist/config.js +8 -2
  19. package/dist/harness/activation/dispatcher.js +7 -0
  20. package/dist/harness/activation/inbox.d.ts +3 -3
  21. package/dist/harness/activation/inbox.js +3 -3
  22. package/dist/harness/activation/runtime.js +13 -5
  23. package/dist/harness/activation/types.d.ts +2 -2
  24. package/dist/harness/agent/builder.d.ts +24 -3
  25. package/dist/harness/agent/builder.js +131 -27
  26. package/dist/harness/agent/config-bridge.js +9 -2
  27. package/dist/harness/agent/config-integrity.js +19 -2
  28. package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
  29. package/dist/harness/agent/wire-agent-builder.js +26 -7
  30. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  31. package/dist/harness/capabilities/document/factory.js +1 -0
  32. package/dist/harness/capabilities/document/port.js +6 -3
  33. package/dist/harness/capabilities/document/types.d.ts +5 -0
  34. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -1
  35. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
  36. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +2 -2
  37. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  38. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  39. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  40. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  42. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
  43. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +3 -3
  44. package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
  45. package/dist/harness/collaboration/delegation/child-run.js +4 -4
  46. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  47. package/dist/harness/collaboration/delegation/index.js +1 -1
  48. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  49. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  50. package/dist/harness/collaboration/delegation/service.d.ts +2 -0
  51. package/dist/harness/collaboration/delegation/service.js +2 -1
  52. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  53. package/dist/harness/collaboration/delegation/store.js +2 -1
  54. package/dist/harness/collaboration/delegation/types.d.ts +23 -2
  55. package/dist/harness/collaboration/delegation/types.js +22 -0
  56. package/dist/harness/collaboration/delegation/wiring.js +11 -1
  57. package/dist/harness/context/budget-allocator.d.ts +26 -18
  58. package/dist/harness/context/budget-allocator.js +67 -32
  59. package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
  60. package/dist/harness/context/capabilities/compact/engine.js +169 -121
  61. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  62. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  63. package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
  64. package/dist/harness/context/capabilities/compact/index.js +4 -0
  65. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  66. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  67. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  68. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  69. package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
  70. package/dist/harness/context/capabilities/compact/types.js +11 -1
  71. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  72. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  73. package/dist/harness/context/capabilities/summary/port.js +0 -1
  74. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  75. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  76. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  77. package/dist/harness/context/capabilities/summary/types.d.ts +3 -6
  78. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  79. package/dist/harness/context/context-size-ledger.js +236 -0
  80. package/dist/harness/context/default-context-engine.d.ts +195 -119
  81. package/dist/harness/context/default-context-engine.js +1241 -743
  82. package/dist/harness/context/index.d.ts +2 -2
  83. package/dist/harness/context/index.js +1 -1
  84. package/dist/harness/context/layer-types.d.ts +15 -0
  85. package/dist/harness/context/layer-types.js +14 -1
  86. package/dist/harness/context/layers.d.ts +14 -15
  87. package/dist/harness/context/layers.js +41 -11
  88. package/dist/harness/context/message-selector.d.ts +10 -8
  89. package/dist/harness/context/message-selector.js +49 -27
  90. package/dist/harness/context/summarize.d.ts +2 -2
  91. package/dist/harness/context/summarize.js +9 -2
  92. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  93. package/dist/harness/context/system-prompt-assembler.js +2 -1
  94. package/dist/harness/context/token-constants.d.ts +8 -6
  95. package/dist/harness/context/token-constants.js +8 -7
  96. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  97. package/dist/harness/context/token-estimate-fns.js +85 -66
  98. package/dist/harness/context/token-estimator.d.ts +27 -12
  99. package/dist/harness/context/token-estimator.js +120 -66
  100. package/dist/harness/context/token-segments.d.ts +88 -0
  101. package/dist/harness/context/token-segments.js +103 -0
  102. package/dist/harness/context/tool-result-aging.d.ts +6 -1
  103. package/dist/harness/context/tool-result-aging.js +16 -5
  104. package/dist/harness/context/tool-result-body.js +2 -0
  105. package/dist/harness/context/transform/anchors.d.ts +66 -0
  106. package/dist/harness/context/transform/anchors.js +125 -0
  107. package/dist/harness/context/transform/fold.d.ts +56 -0
  108. package/dist/harness/context/transform/fold.js +135 -0
  109. package/dist/harness/context/transform/migrate.d.ts +41 -0
  110. package/dist/harness/context/transform/migrate.js +69 -0
  111. package/dist/harness/context/transform/types.d.ts +129 -0
  112. package/dist/harness/context/transform/types.js +19 -0
  113. package/dist/harness/context/turn-envelope.d.ts +6 -3
  114. package/dist/harness/context/types.d.ts +127 -117
  115. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  116. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  117. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  118. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
  119. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  120. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  121. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  122. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  123. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  124. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  125. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  126. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  127. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  128. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  129. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  130. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  131. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  132. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  133. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  134. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  135. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  136. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  137. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  138. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  139. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  140. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  141. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  142. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  143. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  144. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  145. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
  146. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
  147. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
  149. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  150. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  151. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  153. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  155. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
  157. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
  161. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
  162. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  164. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  165. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  167. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
  168. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  171. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
  172. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  173. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  174. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  175. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  176. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  177. package/dist/harness/index.d.ts +12 -12
  178. package/dist/harness/index.js +7 -7
  179. package/dist/harness/knowledge/boot-config.d.ts +55 -0
  180. package/dist/harness/knowledge/boot-config.js +50 -0
  181. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  182. package/dist/harness/knowledge/client.d.ts +24 -2
  183. package/dist/harness/knowledge/client.js +19 -5
  184. package/dist/harness/knowledge/db.js +5 -0
  185. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  186. package/dist/harness/knowledge/describe-sample.js +58 -0
  187. package/dist/harness/knowledge/describe.d.ts +8 -0
  188. package/dist/harness/knowledge/describe.js +18 -2
  189. package/dist/harness/knowledge/engine-thread.js +6 -0
  190. package/dist/harness/knowledge/grounding.js +3 -1
  191. package/dist/harness/knowledge/http-app.js +35 -4
  192. package/dist/harness/knowledge/http-params.d.ts +18 -0
  193. package/dist/harness/knowledge/http-params.js +24 -0
  194. package/dist/harness/knowledge/index.d.ts +2 -0
  195. package/dist/harness/knowledge/index.js +1 -0
  196. package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
  197. package/dist/harness/knowledge/purge.js +5 -2
  198. package/dist/harness/knowledge/query-service.d.ts +13 -2
  199. package/dist/harness/knowledge/query-service.js +4 -2
  200. package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
  201. package/dist/harness/knowledge/query-worker-client.js +4 -2
  202. package/dist/harness/knowledge/query-worker.js +4 -2
  203. package/dist/harness/knowledge/read-http.js +5 -1
  204. package/dist/harness/knowledge/serve.d.ts +8 -7
  205. package/dist/harness/knowledge/serve.js +9 -0
  206. package/dist/harness/knowledge/source-store.js +26 -3
  207. package/dist/harness/knowledge/start-service-process.d.ts +15 -7
  208. package/dist/harness/knowledge/start-service-process.js +21 -9
  209. package/dist/harness/knowledge/types.d.ts +7 -0
  210. package/dist/harness/knowledge/writer-service.d.ts +37 -9
  211. package/dist/harness/knowledge/writer-service.js +120 -14
  212. package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
  213. package/dist/harness/knowledge/writer-worker-client.js +20 -2
  214. package/dist/harness/knowledge/writer-worker.js +9 -1
  215. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  216. package/dist/harness/memory/types.d.ts +6 -4
  217. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  218. package/dist/harness/memory/wisdom-formation.js +85 -22
  219. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  220. package/dist/harness/memory/wisdom-gates.js +59 -19
  221. package/dist/harness/memory/wisdom.js +9 -0
  222. package/dist/harness/observability/observer/hub.js +25 -15
  223. package/dist/harness/observability/observer/types.d.ts +10 -6
  224. package/dist/harness/run/agent/agent.d.ts +40 -21
  225. package/dist/harness/run/agent/agent.js +66 -13
  226. package/dist/harness/run/agent/index.d.ts +1 -1
  227. package/dist/harness/run/budget/budget.d.ts +28 -10
  228. package/dist/harness/run/budget/budget.js +38 -15
  229. package/dist/harness/run/model/index.d.ts +3 -1
  230. package/dist/harness/run/model/index.js +2 -1
  231. package/dist/harness/run/model/resolver.d.ts +4 -1
  232. package/dist/harness/run/model/resolver.js +36 -2
  233. package/dist/harness/run/model/run-scope.d.ts +2 -0
  234. package/dist/harness/run/model/run-scope.js +7 -0
  235. package/dist/harness/run/model/types.d.ts +22 -5
  236. package/dist/harness/run/model/types.js +3 -2
  237. package/dist/harness/run/model/window-truth.d.ts +37 -0
  238. package/dist/harness/run/model/window-truth.js +39 -0
  239. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  240. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  241. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  242. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  243. package/dist/harness/run/reliability/run-agent.d.ts +10 -4
  244. package/dist/harness/run/reliability/run-agent.js +137 -53
  245. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  246. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  247. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  248. package/dist/harness/run/run-scope.d.ts +37 -4
  249. package/dist/harness/run/runner.d.ts +44 -29
  250. package/dist/harness/run/runner.js +320 -102
  251. package/dist/harness/session/attachments/index.d.ts +1 -0
  252. package/dist/harness/session/attachments/index.js +1 -0
  253. package/dist/harness/session/attachments/inject.d.ts +21 -10
  254. package/dist/harness/session/attachments/inject.js +76 -24
  255. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  256. package/dist/harness/session/attachments/recall-index.js +219 -0
  257. package/dist/harness/session/attachments/service.d.ts +21 -0
  258. package/dist/harness/session/attachments/service.js +258 -139
  259. package/dist/harness/session/attachments/types.d.ts +6 -0
  260. package/dist/harness/session/transform-store.d.ts +136 -0
  261. package/dist/harness/session/transform-store.js +302 -0
  262. package/dist/harness/session/types.d.ts +2 -2
  263. package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
  264. package/dist/harness/shared/events/agent-event-map.js +3 -2
  265. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  266. package/dist/harness/shared/types/agent-definition.d.ts +1 -2
  267. package/dist/index.d.ts +14 -17
  268. package/dist/index.js +7 -9
  269. package/dist/integration/observability/metrics.d.ts +6 -6
  270. package/dist/integration/observability/metrics.js +13 -13
  271. package/dist/integration/observability/observer-bridge.js +2 -2
  272. package/dist/integration/observability/trace-collector.d.ts +5 -5
  273. package/dist/integration/observability/trace-collector.js +34 -35
  274. package/dist/integration/observability/trace-events.d.ts +3 -3
  275. package/dist/integration/observability/trace-events.js +3 -3
  276. package/dist/integration/providers/anthropic.js +14 -1
  277. package/dist/integration/providers/openai.js +7 -1
  278. package/dist/integration/providers/usage.d.ts +1 -1
  279. package/dist/integration/providers/wire-dump.d.ts +1 -1
  280. package/dist/integration/storage/archive-manager.d.ts +6 -0
  281. package/dist/integration/storage/archive-manager.js +10 -0
  282. package/dist/integration/storage/jsonl.d.ts +1 -1
  283. package/dist/integration/storage/jsonl.js +18 -16
  284. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  285. package/dist/subsystems/wisdom-steward/formation/config.yaml +1 -0
  286. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  287. package/package.json +11 -14
  288. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  289. package/dist/harness/context/hybrid-compressor.js +0 -159
  290. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  291. package/dist/harness/context/llm-summarizer.js +0 -249
  292. package/dist/harness/context/smart-router.d.ts +0 -75
  293. package/dist/harness/context/smart-router.js +0 -118
  294. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  295. package/dist/harness/context/truncate-compressor.js +0 -107
  296. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  297. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  298. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  299. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  300. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  301. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -55,12 +55,12 @@ export class DefaultRunGuard {
55
55
  this.checkpointCount++;
56
56
  let verdict;
57
57
  // ── 可选资源兜底(默认关闭;总闸归 ResourceBudget) ──
58
- if (this.config.hardLimit !== undefined && context.iteration >= this.config.hardLimit) {
58
+ if (this.config.hardLimit !== undefined && context.steps >= this.config.hardLimit) {
59
59
  verdict = {
60
60
  action: 'stop',
61
61
  failureKind: 'burn',
62
- reason: `硬上限触发:已运行 ${context.iteration} 轮(上限 ${this.config.hardLimit})`,
63
- userMessage: `任务已运行 ${context.iteration} 轮,达到安全上限。如需继续,请优化任务后重新开始。`,
62
+ reason: `硬上限触发:已运行 ${context.steps} 轮(上限 ${this.config.hardLimit})`,
63
+ userMessage: `任务已运行 ${context.steps} 轮,达到安全上限。如需继续,请优化任务后重新开始。`,
64
64
  };
65
65
  }
66
66
  else if (this.config.hardWallClockMs !== undefined &&
@@ -109,7 +109,7 @@ export class DefaultRunGuard {
109
109
  recoveryActions: actions,
110
110
  nextCheckpointIn: highSeverity.length > 0
111
111
  ? this.config.minCheckpointInterval
112
- : Math.max(this.config.minCheckpointInterval, Math.floor(context.iteration * 0.5) || this.config.minCheckpointInterval),
112
+ : Math.max(this.config.minCheckpointInterval, Math.floor(context.steps * 0.5) || this.config.minCheckpointInterval),
113
113
  };
114
114
  }
115
115
  }
@@ -146,7 +146,7 @@ export class DefaultRunGuard {
146
146
  return verdict;
147
147
  }
148
148
  normalVerdict(context) {
149
- const next = Math.min(this.config.maxCheckpointInterval, Math.max(this.config.minCheckpointInterval, Math.floor(context.iteration * 1.2) || this.config.checkpointInterval));
149
+ const next = Math.min(this.config.maxCheckpointInterval, Math.max(this.config.minCheckpointInterval, Math.floor(context.steps * 1.2) || this.config.checkpointInterval));
150
150
  return {
151
151
  action: 'continue',
152
152
  reason: '正常运行',
@@ -310,7 +310,7 @@ export class DefaultRunGuard {
310
310
  //
311
311
  // - 旧规则 5 的两个分支都不生效:`low` 没有任何消费方(裁决只取 high/medium);
312
312
  // `medium` 要求 `noopStreak >= 3`,而 run-agent 在 `consecutiveNoops >= noopThreshold`
313
- // 时已设置 `_noopLoopStop` 并发出可见停止事件,`shouldStopAfterTurn` 直接结束 turn,
313
+ // 时已设置 `_noopLoopStop` 并发出可见停止事件,`shouldStopAfterStep` 直接结束 turn,
314
314
  // 本规则只是重复判定,还会多注入一条 hint、污染 recoveryHistory。
315
315
  //
316
316
  // 结论:真正需要 Guard 的异常只有三类——同参同结果(无进展循环)、同参同错误(没换方法)、
@@ -338,7 +338,7 @@ export class DefaultRunGuard {
338
338
  const recoveryLine = ctx.recoveryHistory && ctx.recoveryHistory.length > 0
339
339
  ? `\n最近恢复尝试:\n${ctx.recoveryHistory
340
340
  .slice(-5)
341
- .map((h, i) => ` ${i + 1}. [iter ${h.iteration}] ${h.actionType}${h.failureKind ? ` (${h.failureKind})` : ''}: ${h.reason}`)
341
+ .map((h, i) => ` ${i + 1}. [iter ${h.steps}] ${h.actionType}${h.failureKind ? ` (${h.failureKind})` : ''}: ${h.reason}`)
342
342
  .join('\n')}`
343
343
  : '';
344
344
  const signalsLine = ctx.externalSignals && ctx.externalSignals.length > 0
@@ -352,7 +352,7 @@ export class DefaultRunGuard {
352
352
  ${summaryText}${taskLine}${recoveryLine}${signalsLine}
353
353
 
354
354
  当前指标:
355
- - 迭代次数: ${ctx.iteration}
355
+ - 迭代次数: ${ctx.steps}
356
356
  - 连续错误: ${ctx.metrics.consecutiveErrors}
357
357
  - 连续同一错误: ${ctx.metrics.consecutiveIdenticalFailures ?? '(未提供)'}
358
358
  - 工具失败率: ${(ctx.metrics.toolFailureRate * 100).toFixed(0)}%(窗口 ${ctx.metrics.toolCallsInWindow ?? '?'} 次)
@@ -10,6 +10,7 @@
10
10
  */
11
11
  import type { Message } from '@octopi-agent/core/types.js';
12
12
  import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
13
+ import type { ToolPolicy } from '@octopi-agent/core/types/agent-definition.js';
13
14
  import type { ToolIsolationMode } from '../extension/execution-environment/isolation.js';
14
15
  /** 工具执行时可见的 Run 运行时上下文 */
15
16
  export interface RunToolRuntime {
@@ -42,6 +43,8 @@ export interface RunToolRuntime {
42
43
  homeWrite?: boolean;
43
44
  /** Run-level securityDegraded hook */
44
45
  noteSecurityDegraded?: (reason: string) => void;
46
+ /** 人类输入等待回传(预算 wall-clock 扣减);由 run-agent 挂接 per-run Budget */
47
+ noteHumanWait?: (ms: number) => void;
45
48
  /** ops 审计回传(ops P2):动作/越权写入 → 统一审计账本 */
46
49
  recordOpsEvent?: (record: {
47
50
  event: string;
@@ -104,10 +107,7 @@ export interface RunToolRuntime {
104
107
  */
105
108
  sessionRights?: import('../governance/session-acl/types.js').EffectiveSessionRights;
106
109
  /** SEC-2 static agent tool policy (agents[].tools) */
107
- agentToolPolicy?: {
108
- allow?: string[];
109
- deny?: string[];
110
- };
110
+ agentToolPolicy?: ToolPolicy;
111
111
  }
112
112
  /** 一次 Run 的作用域身份(I1) */
113
113
  export interface RunScope {
@@ -118,8 +118,35 @@ export interface RunScope {
118
118
  * 由 Runner 在组装 RunScope 时生成;Observer/审计共用,不另造第二套 ID。
119
119
  */
120
120
  runId?: string;
121
+ /** Read-only Host Principal; supplied by the caller, never by a plugin. */
122
+ principal?: {
123
+ actorId?: string;
124
+ actorType?: string;
125
+ tenantId?: string;
126
+ };
127
+ /** Current effective input, used by extension attribution and collection. */
128
+ prompt?: string;
129
+ /** Host-owned per-Run model snapshot; plugin transforms must use the Host resolver. */
130
+ resolvedModel?: import('./model/types.js').ResolvedModel;
131
+ /** Host-only allowlist resolver for iteration model transforms. */
132
+ resolveConfiguredModel?: (selection: {
133
+ provider: string;
134
+ model: string;
135
+ }) => import('./model/types.js').ResolvedModel | null;
136
+ thinkingLevel?: import('@octopi-agent/core/types.js').ThinkingLevel;
137
+ extensionSnapshotBudgetTokens?: number;
138
+ iteration?: number;
121
139
  /** 本轮 systemPrompt 装配结果;供 convertToLlm / 层装配 */
122
140
  systemPrompt?: string;
141
+ /**
142
+ * 本 Run 实际发送的工具清单(与 loop 的 toolDefs 同源 = run 级 AgentContext.tools)。
143
+ * 估算与请求必须量同一集合(F1-B3「尺子与作用域同源」):convertToLlm 若回退
144
+ * 实例级 agent.context.tools,会话过滤面不同会产出系统性错位估算(2026-11-07:
145
+ * 委派子会话首步实测 23,811 / 估算 5,643,毒对进台账后被锚外推放大 5.4×)。
146
+ * M-6:实现须**活读**(getter 读 run context 当前 tools)——beforeStep 可替换
147
+ * tools 数组,快照会让估算与请求在 run 中途分叉;回退链止于「无 tools = 0 个」。
148
+ */
149
+ tools?: import('@octopi-agent/core/loop/types.js').AgentTool[];
123
150
  /**
124
151
  * turn 级 Knowledge grounding(arch/knowledge-layer.md §4.4)。
125
152
  * 内容命中不进 system;消息侧插槽 source='knowledgeGrounding'。
@@ -135,6 +162,12 @@ export interface RunScope {
135
162
  toolRuntime?: RunToolRuntime;
136
163
  /** Agent 模板 revision(Reserved:AgentRevision 绑 Run) */
137
164
  agentRevision?: string;
165
+ /**
166
+ * 交接式摘要素材的活来源(F8R-05):惰性渲染当前会话 task 快照。
167
+ * 装配/摘要时现取——session.tasks 与 SessionTaskService attachSession 是同一
168
+ * 内存对象,run 内任务变更即刻可见;避免自动压缩用注入历史里的旧副本。
169
+ */
170
+ taskSnapshot?: () => string;
138
171
  }
139
172
  /**
140
173
  * 生成与 RunScope 对齐的 runId(含 sessionId/agentId,可读且可排序)
@@ -18,6 +18,7 @@ type TypedSessionStore = SessionStore<SessionData>;
18
18
  import type { Agent } from './agent/index.js';
19
19
  import type { HarnessLoopEvent } from './reliability/harness-events.js';
20
20
  import type { ReliabilityHarness } from './reliability/run-agent.js';
21
+ import { type OpsAuditEvent } from '../extension/execution-environment/ops-audit.js';
21
22
  import type { SessionTaskService } from '../session/tasks/service.js';
22
23
  import type { SessionInboxEntry, SessionInboxBinding } from '../activation/inbox.js';
23
24
  import { type ToolIsolationMode } from '../extension/execution-environment/isolation.js';
@@ -147,13 +148,20 @@ export interface SessionAwareRunnerConfig {
147
148
  /** credentials.requireBindings(SEC-3c):无绑定凭证不可 resolve */
148
149
  requireCredentialBindings?: boolean;
149
150
  confirmEffect?: import("../extension/execution-environment/effect-policy.js").ConfirmEffect;
151
+ /** 附件轻量意图分流的默认 provider(仅无 Gateway 模型快照时回退)。 */
152
+ defaultIntentProvider?: import('@octopi-agent/core/interfaces/model-provider.js').ModelProvider;
150
153
  /** 附件注入参数(knowledge.attachments.inject;缺省用内建默认) */
151
154
  sessionAttachmentInject?: {
152
155
  fullTextMaxChars?: number;
156
+ recallTopK?: number;
153
157
  intent?: 'llm' | 'off';
154
158
  intentTimeoutMs?: number;
155
159
  emptyMessagePrompt?: string;
156
160
  };
161
+ /** Budget for plugin Runtime snapshot contributions; never part of systemPrompt. */
162
+ extensionSnapshotBudgetTokens?: number;
163
+ /** Host-owned narrow extension boundary; no plugin registry enters Runner. */
164
+ extensionHooks?: import('../extension/plugin-ecosystem/hooks/types.js').ExtensionHookPort;
157
165
  /**
158
166
  * 事件旁路(Telemetry)。每条适配后事件调用(含 llm_stream_delta),
159
167
  * 不改变 yield 语义。由 Builder 注入 RunTelemetry.onEvent。
@@ -164,7 +172,7 @@ export interface SessionAwareRunnerConfig {
164
172
  }) => void;
165
173
  }
166
174
  /**
167
- * 失败凭证消息中附带残句的截断上限(显示用途;完整残句在带 error 标记的 turn 账本)
175
+ * 失败凭证消息中附带残句的截断上限(显示用途;完整残句在带 error 标记的 step 账本)
168
176
  *
169
177
  * 展示型截断,与 wire-dump 的消息截断同性质——不是部署可变参数,故不进配置。
170
178
  */
@@ -180,10 +188,11 @@ export interface RunConfig {
180
188
  model?: string;
181
189
  /** model 为裸名时的 provider 缺省 */
182
190
  modelProvider?: string;
183
- temperature?: number;
184
191
  cwd?: string;
185
192
  /** 本次 Run 的工具隔离覆盖(缺省用 Runner 配置 / DEFAULT_TOOL_ISOLATION) */
186
193
  toolIsolation?: ToolIsolationMode;
194
+ /** Caller identity forwarded from the real RunRequest; not a plugin-provided claim. */
195
+ principal?: import('../extension/plugin-ecosystem/hooks/types.js').ExtensionHookContext['principal'];
187
196
  /** Agent 模板 revision 绑 Run(Reserved:AgentRevision);写入 RunScope / 审计 */
188
197
  agentRevision?: string;
189
198
  contextWindow?: number;
@@ -223,9 +232,9 @@ export declare function adaptLoopEvent(event: HarnessLoopEvent, meta: {
223
232
  * 失败轮的正文只能来自这里——不得回落到上一次调用的完整回复冒充本次输出。
224
233
  */
225
234
  callStreamedContent?: string;
226
- /** 最近一次 turn_end 的正文快照与错误标记,供 runner 落 turn 账本 */
227
- lastTurnContent?: string;
228
- lastTurnError?: boolean;
235
+ /** 最近一次 turn_end 的正文快照与错误标记,供 runner 落 step 账本 */
236
+ lastStepContent?: string;
237
+ lastStepError?: boolean;
229
238
  /** `agent_end.reason='error'` 时的错误文本,收口落失败凭证 */
230
239
  errorMessage?: string;
231
240
  lastUserContent?: string;
@@ -319,6 +328,8 @@ export declare class SessionAwareRunner {
319
328
  private groundingAssembler?;
320
329
  /** 模型快照解析器(Gateway 注入;每 run 只调一次) */
321
330
  private resolveModelOverride?;
331
+ /** 无 Gateway 快照时,附件轻量意图分流回退到 Builder 的当前会话 provider。 */
332
+ private defaultIntentProvider?;
322
333
  constructor(agent: Agent, harness: ReliabilityHarness, store: TypedSessionStore, config?: SessionAwareRunnerConfig & {
323
334
  events?: import('@octopi-agent/core/primitives/event-bus.js').EventBus;
324
335
  });
@@ -330,8 +341,24 @@ export declare class SessionAwareRunner {
330
341
  *
331
342
  * @param event - §7 事件词表
332
343
  * @param data - 事件载荷(hash 走 canonicalJson,键序无关)
344
+ * @param opts.ignoreRunOverride - true = 忽略 run 级 effectOpsAudit 粘滞值
345
+ * (准入拒绝发生在 run 起点之前,不受上一轮 run 的 opsAudit:'off' 影响)
333
346
  */
334
347
  private recordOpsAudit;
348
+ /**
349
+ * 对外 ops 记账口(账本 + 观测双写)——run 准入拒绝等发生在 Runner 执行流之外、
350
+ * 但属同一 ops 语义面的事件(如 gateway 侧 knowledge.required 闸门)用它对齐
351
+ * `ops.config.security_changed` / `ops.kill_switch.tripped` 的三件套待遇。
352
+ * (不叫 recordOpsEvent:与工具上下文的同名回调(仅账本)区分。)
353
+ *
354
+ * @param event - §7 事件词表
355
+ * @param data - 事件载荷(hash 走 canonicalJson,入账本)
356
+ * @param origin - 触发者锚点(观测事件的 agentId/sessionId;账本锚未落定时补锚)
357
+ */
358
+ recordAdmissionRefusal(event: OpsAuditEvent, data: Record<string, unknown>, origin: {
359
+ agentId: string;
360
+ sessionId: string;
361
+ }): void;
335
362
  /** 外送收口(懒建;仅配置了宿主侧收口路径时启用) */
336
363
  private resolveOpsExporter;
337
364
  /**
@@ -477,34 +504,22 @@ export declare class SessionAwareRunner {
477
504
  sessionId: string;
478
505
  agentId: string;
479
506
  messages: Message[];
480
- summarize?: (messages: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[], opts?: {
481
- maxTokens?: number;
482
- }) => Promise<string>;
507
+ summarize?: import('../context/types.js').SummarizeFunction;
483
508
  compactTargetTokens?: number;
484
509
  /** task 快照:交接式摘要指令尾部注入 */
485
510
  taskSnapshot?: string;
486
- }) => Promise<{
487
- ok: boolean;
488
- compacted: boolean;
489
- reason?: string;
490
- tokensBefore: number;
491
- tokensAfter?: number;
492
- summary?: string;
493
- /** 摘要覆盖终点(tailStart,不含) */
494
- coveredMessageCount?: number;
495
- }>;
496
- summarize?: (messages: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[], opts?: {
497
- maxTokens?: number;
498
- }) => Promise<string>;
511
+ /** 请求口径计量原料(2026-11-08 B1):与会话下一请求同源的 system/tools */
512
+ systemPrompt?: string;
513
+ tools?: import('@octopi-agent/core/interfaces/model-provider.js').LLMToolDefinition[];
514
+ /** 旧压缩快照读口(迁移输入) */
515
+ loadCompactState?: (sessionId: string) => Promise<import('../context/types.js').ContextCompactSnapshot | undefined> | import('../context/types.js').ContextCompactSnapshot | undefined;
516
+ }) => Promise<import('../context/capabilities/compact/types.js').CompactOutcome>;
517
+ summarize?: import('../context/types.js').SummarizeFunction;
499
518
  compactTargetTokens?: number;
500
- }): Promise<{
501
- ok: boolean;
502
- compacted: boolean;
503
- reason?: string;
504
- tokensBefore: number;
505
- tokensAfter?: number;
506
- summary?: string;
507
- }>;
519
+ /** 请求口径计量原料(2026-11-08 B1):透传给 compactStructural */
520
+ systemPrompt?: string;
521
+ tools?: import('@octopi-agent/core/interfaces/model-provider.js').LLMToolDefinition[];
522
+ }): Promise<import('../context/capabilities/compact/types.js').CompactTransportOutcome>;
508
523
  /**
509
524
  * 获取 Session 锁(经 SessionLease;E2 键 = sessionId)
510
525
  *