@octopi-agent/engine 0.102.10 → 0.121.15

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 (321) 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/console-access-key.d.ts +46 -0
  5. package/dist/config-admin/console-access-key.js +47 -0
  6. package/dist/config-admin/discover.d.ts +33 -4
  7. package/dist/config-admin/discover.js +101 -6
  8. package/dist/config-admin/env.d.ts +11 -0
  9. package/dist/config-admin/env.js +41 -0
  10. package/dist/config-admin/error-copy.d.ts +106 -0
  11. package/dist/config-admin/error-copy.js +287 -0
  12. package/dist/config-admin/i18n.d.ts +21 -0
  13. package/dist/config-admin/i18n.js +19 -0
  14. package/dist/config-admin/index.d.ts +8 -2
  15. package/dist/config-admin/index.js +4 -1
  16. package/dist/config-admin/model-presets.d.ts +14 -0
  17. package/dist/config-admin/model-presets.js +595 -70
  18. package/dist/config-admin/onboarding-apply.d.ts +83 -0
  19. package/dist/config-admin/onboarding-apply.js +259 -0
  20. package/dist/config-admin/onboarding.d.ts +160 -0
  21. package/dist/config-admin/onboarding.js +298 -0
  22. package/dist/config-admin/password-policy.d.ts +24 -0
  23. package/dist/config-admin/password-policy.js +31 -0
  24. package/dist/config-admin/redact.d.ts +42 -9
  25. package/dist/config-admin/redact.js +69 -5
  26. package/dist/config-schema/agent.d.ts +5 -1
  27. package/dist/config-schema/agent.js +20 -2
  28. package/dist/config-schema/browser.d.ts +62 -0
  29. package/dist/config-schema/browser.js +89 -0
  30. package/dist/config-schema/context.d.ts +7 -2
  31. package/dist/config-schema/context.js +6 -3
  32. package/dist/config-schema/engine.d.ts +86 -7
  33. package/dist/config-schema/engine.js +9 -2
  34. package/dist/config-schema/governance.d.ts +12 -1
  35. package/dist/config-schema/governance.js +10 -2
  36. package/dist/config-schema/models.d.ts +12 -8
  37. package/dist/config-schema/models.js +16 -1
  38. package/dist/config-schema/run.d.ts +4 -0
  39. package/dist/config-schema/run.js +10 -0
  40. package/dist/config-schema/shared.d.ts +1 -0
  41. package/dist/config-schema/shared.js +4 -2
  42. package/dist/config-schema/substrate.d.ts +5 -0
  43. package/dist/config-schema/substrate.js +8 -0
  44. package/dist/config.d.ts +116 -10
  45. package/dist/config.js +109 -13
  46. package/dist/file-mode.d.ts +67 -0
  47. package/dist/file-mode.js +182 -0
  48. package/dist/fork-child.d.ts +82 -0
  49. package/dist/fork-child.js +123 -0
  50. package/dist/harness/activation/delegated-run.d.ts +42 -0
  51. package/dist/harness/activation/delegated-run.js +71 -0
  52. package/dist/harness/activation/dispatcher.js +4 -0
  53. package/dist/harness/activation/index.d.ts +1 -0
  54. package/dist/harness/activation/run-backend.d.ts +92 -0
  55. package/dist/harness/activation/run-backend.js +16 -0
  56. package/dist/harness/activation/run-protocol.d.ts +392 -0
  57. package/dist/harness/activation/run-protocol.js +19 -0
  58. package/dist/harness/activation/runtime.d.ts +33 -0
  59. package/dist/harness/activation/runtime.js +119 -28
  60. package/dist/harness/activation/types.d.ts +19 -2
  61. package/dist/harness/agent/builder.d.ts +12 -0
  62. package/dist/harness/agent/builder.js +78 -22
  63. package/dist/harness/agent/config-bridge.d.ts +10 -1
  64. package/dist/harness/agent/config-bridge.js +15 -3
  65. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  66. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  67. package/dist/harness/agent/wire-agent-builder.d.ts +2 -0
  68. package/dist/harness/agent/wire-agent-builder.js +9 -2
  69. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  70. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  71. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  73. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  75. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  76. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -0
  77. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +13 -3
  80. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +48 -39
  81. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +4 -0
  83. package/dist/harness/collaboration/delegation/child-run.d.ts +9 -0
  84. package/dist/harness/collaboration/delegation/child-run.js +34 -2
  85. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  86. package/dist/harness/collaboration/delegation/service.d.ts +9 -4
  87. package/dist/harness/collaboration/delegation/service.js +33 -12
  88. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  89. package/dist/harness/collaboration/delegation/store.js +1 -0
  90. package/dist/harness/collaboration/delegation/types.d.ts +11 -0
  91. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  92. package/dist/harness/collaboration/delegation/wiring.js +1 -0
  93. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -5
  94. package/dist/harness/context/capabilities/compact/engine.js +127 -39
  95. package/dist/harness/context/capabilities/compact/index.d.ts +2 -1
  96. package/dist/harness/context/capabilities/compact/index.js +1 -1
  97. package/dist/harness/context/capabilities/compact/types.d.ts +59 -9
  98. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  99. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  100. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  101. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  102. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  103. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  104. package/dist/harness/context/capabilities/summary/types.d.ts +16 -0
  105. package/dist/harness/context/constitution/default-agents.md +85 -0
  106. package/dist/harness/context/context-size-ledger.js +8 -1
  107. package/dist/harness/context/default-context-engine.d.ts +100 -6
  108. package/dist/harness/context/default-context-engine.js +382 -89
  109. package/dist/harness/context/index.d.ts +2 -1
  110. package/dist/harness/context/index.js +1 -0
  111. package/dist/harness/context/layer-health.d.ts +4 -0
  112. package/dist/harness/context/layer-health.js +4 -0
  113. package/dist/harness/context/layer-types.d.ts +57 -0
  114. package/dist/harness/context/layer-types.js +73 -1
  115. package/dist/harness/context/layers.d.ts +3 -0
  116. package/dist/harness/context/layers.js +13 -6
  117. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  118. package/dist/harness/context/prefix-fingerprint.js +52 -0
  119. package/dist/harness/context/summarize.js +18 -0
  120. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  121. package/dist/harness/context/system-prompt-assembler.js +5 -2
  122. package/dist/harness/context/tool-result-aging.d.ts +104 -16
  123. package/dist/harness/context/tool-result-aging.js +211 -57
  124. package/dist/harness/context/types.d.ts +71 -4
  125. package/dist/harness/context/types.js +25 -1
  126. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  127. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  128. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  129. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  130. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +27 -1
  131. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  132. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  133. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  134. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  135. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  136. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  137. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +168 -1
  138. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +156 -15
  139. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  140. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  141. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  142. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  143. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +40 -5
  144. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +45 -26
  145. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +11 -1
  147. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +42 -76
  148. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +30 -1
  149. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +46 -0
  150. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +9 -0
  151. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +19 -14
  152. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +3 -1
  153. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +1 -1
  154. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  155. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  156. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  157. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  158. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  159. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  160. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -0
  161. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  163. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  164. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  165. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  167. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  168. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  169. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  170. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +10 -24
  171. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  172. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  173. package/dist/harness/governance/credentials/db.d.ts +9 -0
  174. package/dist/harness/governance/credentials/db.js +122 -31
  175. package/dist/harness/governance/credentials/store.d.ts +68 -7
  176. package/dist/harness/governance/credentials/store.js +177 -64
  177. package/dist/harness/governance/credentials/types.d.ts +13 -2
  178. package/dist/harness/governance/index.d.ts +1 -0
  179. package/dist/harness/governance/index.js +1 -0
  180. package/dist/harness/governance/registry/db.d.ts +32 -0
  181. package/dist/harness/governance/registry/db.js +142 -0
  182. package/dist/harness/governance/registry/index.d.ts +9 -0
  183. package/dist/harness/governance/registry/index.js +9 -0
  184. package/dist/harness/governance/registry/service.d.ts +381 -0
  185. package/dist/harness/governance/registry/service.js +825 -0
  186. package/dist/harness/governance/registry/types.d.ts +77 -0
  187. package/dist/harness/governance/registry/types.js +7 -0
  188. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  189. package/dist/harness/governance/security/default-security-guard.js +12 -1
  190. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  191. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  192. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  193. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  194. package/dist/harness/index.d.ts +5 -3
  195. package/dist/harness/index.js +2 -2
  196. package/dist/harness/knowledge/boot-config.d.ts +2 -0
  197. package/dist/harness/knowledge/boot-config.js +2 -0
  198. package/dist/harness/knowledge/client.d.ts +53 -7
  199. package/dist/harness/knowledge/client.js +77 -20
  200. package/dist/harness/knowledge/db.d.ts +16 -0
  201. package/dist/harness/knowledge/db.js +107 -41
  202. package/dist/harness/knowledge/engine-thread.js +5 -7
  203. package/dist/harness/knowledge/grounding.js +4 -1
  204. package/dist/harness/knowledge/http-app.d.ts +15 -0
  205. package/dist/harness/knowledge/http-app.js +82 -21
  206. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  207. package/dist/harness/knowledge/http-bridge.js +19 -0
  208. package/dist/harness/knowledge/knowledge-serve-child.js +2 -3
  209. package/dist/harness/knowledge/query-service.d.ts +12 -2
  210. package/dist/harness/knowledge/query-service.js +75 -41
  211. package/dist/harness/knowledge/query-worker-client.d.ts +5 -1
  212. package/dist/harness/knowledge/query-worker-client.js +4 -1
  213. package/dist/harness/knowledge/query-worker.js +5 -3
  214. package/dist/harness/knowledge/read-http.d.ts +2 -0
  215. package/dist/harness/knowledge/read-http.js +9 -2
  216. package/dist/harness/knowledge/retriever.d.ts +1 -1
  217. package/dist/harness/knowledge/retriever.js +1 -2
  218. package/dist/harness/knowledge/serve.d.ts +6 -1
  219. package/dist/harness/knowledge/serve.js +5 -6
  220. package/dist/harness/knowledge/source-store.d.ts +101 -5
  221. package/dist/harness/knowledge/source-store.js +297 -71
  222. package/dist/harness/knowledge/start-service-process.d.ts +27 -8
  223. package/dist/harness/knowledge/start-service-process.js +49 -90
  224. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  225. package/dist/harness/knowledge/tenant-gate.js +167 -0
  226. package/dist/harness/knowledge/writer-service.d.ts +18 -2
  227. package/dist/harness/knowledge/writer-service.js +80 -16
  228. package/dist/harness/knowledge/writer-worker-client.d.ts +9 -2
  229. package/dist/harness/knowledge/writer-worker-client.js +20 -3
  230. package/dist/harness/knowledge/writer-worker.js +11 -4
  231. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  232. package/dist/harness/memory/backfill-trigger.js +19 -19
  233. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  234. package/dist/harness/memory/cognition-seeds.js +67 -0
  235. package/dist/harness/memory/cognition.d.ts +12 -3
  236. package/dist/harness/memory/cognition.js +55 -35
  237. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  238. package/dist/harness/memory/conceptualizer.js +10 -1
  239. package/dist/harness/memory/context-slice.d.ts +42 -0
  240. package/dist/harness/memory/context-slice.js +197 -0
  241. package/dist/harness/memory/health-probe.d.ts +8 -2
  242. package/dist/harness/memory/health-probe.js +10 -13
  243. package/dist/harness/memory/index.d.ts +5 -1
  244. package/dist/harness/memory/index.js +3 -1
  245. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  246. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  247. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  248. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  249. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  250. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  251. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  252. package/dist/harness/memory/types.d.ts +18 -2
  253. package/dist/harness/observability/observer/hub.d.ts +10 -0
  254. package/dist/harness/observability/observer/hub.js +95 -2
  255. package/dist/harness/run/agent/agent.js +3 -2
  256. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  257. package/dist/harness/run/reliability/run-agent.d.ts +22 -0
  258. package/dist/harness/run/reliability/run-agent.js +79 -10
  259. package/dist/harness/run/run-host.d.ts +302 -0
  260. package/dist/harness/run/run-host.js +978 -0
  261. package/dist/harness/run/run-scope.d.ts +11 -0
  262. package/dist/harness/run/run-scope.js +19 -1
  263. package/dist/harness/run/runner.d.ts +149 -22
  264. package/dist/harness/run/runner.js +352 -35
  265. package/dist/harness/session/in-memory-store.js +13 -1
  266. package/dist/harness/session/schedules/service.d.ts +10 -2
  267. package/dist/harness/session/schedules/service.js +13 -2
  268. package/dist/harness/session/tasks/tools.js +12 -0
  269. package/dist/harness/session/types.d.ts +10 -14
  270. package/dist/harness/shared/events/agent-event-map.d.ts +29 -0
  271. package/dist/harness/shared/types/agent-definition.d.ts +6 -0
  272. package/dist/index.d.ts +3 -2
  273. package/dist/index.js +2 -1
  274. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  275. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  276. package/dist/integration/browser/camoufox.d.ts +40 -0
  277. package/dist/integration/browser/camoufox.js +80 -0
  278. package/dist/integration/browser/index.d.ts +91 -0
  279. package/dist/integration/browser/index.js +110 -0
  280. package/dist/integration/browser/install.d.ts +47 -0
  281. package/dist/integration/browser/install.js +214 -0
  282. package/dist/integration/browser/playwright.d.ts +224 -0
  283. package/dist/integration/browser/playwright.js +925 -0
  284. package/dist/integration/browser/service.d.ts +41 -0
  285. package/dist/integration/browser/service.js +181 -0
  286. package/dist/integration/browser/stealth.d.ts +42 -0
  287. package/dist/integration/browser/stealth.js +104 -0
  288. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  289. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  290. package/dist/integration/providers/anthropic.js +27 -2
  291. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  292. package/dist/integration/providers/fetch-timeout.js +24 -0
  293. package/dist/integration/providers/openai.d.ts +8 -0
  294. package/dist/integration/providers/openai.js +41 -1
  295. package/dist/integration/providers/wire-dump-diff.js +2 -1
  296. package/dist/integration/providers/wire-dump.d.ts +56 -2
  297. package/dist/integration/providers/wire-dump.js +119 -6
  298. package/dist/integration/storage/archive-manager.d.ts +14 -2
  299. package/dist/integration/storage/archive-manager.js +24 -8
  300. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  301. package/dist/integration/storage/atomic-tmp.js +36 -0
  302. package/dist/integration/storage/jsonl.d.ts +9 -0
  303. package/dist/integration/storage/jsonl.js +137 -38
  304. package/dist/integration/storage/session-index.d.ts +5 -0
  305. package/dist/integration/storage/session-index.js +25 -4
  306. package/dist/integration/tools/assemble.d.ts +50 -0
  307. package/dist/integration/tools/assemble.js +137 -0
  308. package/dist/paths.d.ts +18 -0
  309. package/dist/paths.js +36 -0
  310. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  311. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  312. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  313. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  314. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  315. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  316. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  317. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  318. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  319. package/dist/subsystems/wisdom-steward/formation/config.yaml +3 -0
  320. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  321. package/package.json +5 -3
@@ -108,9 +108,51 @@ export interface WireCallResponseInfo {
108
108
  text?: string;
109
109
  /** 推理增量汇总(同截断;部分拒答只留 reasoning,须一并留痕) */
110
110
  reasoning?: string;
111
+ /** 响应中的工具调用原始留痕(见 {@link WireToolCallTrace}) */
112
+ toolCalls?: WireToolCallTrace[];
111
113
  /** 结束原因(stop / tool_calls / length / error) */
112
114
  finishReason?: string;
113
115
  }
116
+ /**
117
+ * 响应中的工具调用原始留痕(OP-TOOL-1)
118
+ *
119
+ * 用途:OP-TOOL-1 事故(工具执行参数被 `…[N chars]` 降级标记污染)无法裁决
120
+ * 「标记是模型原始输出就有,还是引擎在派发前替换」——请求 dump 只有输入侧,
121
+ * 缺响应侧 tool_call 原文。这里把模型输出的 arguments **原文**留痕,
122
+ * 复现时与会话落盘/实际执行的参数逐字对比即可一锤定音。
123
+ */
124
+ export interface WireToolCallTrace {
125
+ /** tool_call id(会话落盘的对账主键;缺失时按 index 聚合并标 ambiguous) */
126
+ id?: string;
127
+ name: string;
128
+ /**
129
+ * 模型原始 arguments 文本(stream 按增量拼接的原文;chat 无原文可用时
130
+ * 为解析后对象的 JSON 序列化——此时非逐字节原始,以 `raw: false` 标注)
131
+ */
132
+ arguments: string;
133
+ /**
134
+ * arguments 全长(字符;`arguments` 被截断时大于其长度)。raw:true 时为
135
+ * 原文长度;raw:false 时为序列化长度(非原文,长度指纹仅供参考)
136
+ */
137
+ argumentsChars: number;
138
+ /** arguments 超出 {@link TOOL_CALL_ARGS_CAPTURE_CAP} 被显式截断(头+尾保全,绝不静默) */
139
+ truncated?: true;
140
+ /** arguments 是否为逐字节原文(stream=true;chat 序列化=false) */
141
+ raw: boolean;
142
+ /** 模型输出的 arguments 是非法 JSON、解析侧已丢原文(chat 路径的最坏情况,显式标注) */
143
+ parseError?: true;
144
+ /** 无法可靠区分 tool_call 边界(id 与 index 全缺时的聚合):内容可能混入多条调用 */
145
+ ambiguous?: true;
146
+ /** 流是否完整走到 done(false = 断流/提前退出,args 可能只是半截,勿当全量证据) */
147
+ complete?: boolean;
148
+ }
149
+ /**
150
+ * 单条 tool_call arguments 留痕上限(字符):超出则头+尾保全、中间显式省略
151
+ * (降级标记是尾锚定形态,只留头部会挖掉唯一需要的证据——OP-TOOL-1 评审 M6)。
152
+ * 与 {@link RESPONSE_CAPTURE_HARD_CAP} 同为捕获护栏常数;如运营上需要按部署
153
+ * 调整再升配置字段(wire-dump 既有硬护栏先例:MAX_ERROR_MESSAGE_CHARS)。
154
+ */
155
+ export declare const TOOL_CALL_ARGS_CAPTURE_CAP = 65536;
114
156
  /** 单次调用的收尾句柄 */
115
157
  export interface WireCallHandle {
116
158
  id: string;
@@ -189,8 +231,20 @@ export declare function defaultWireDumpDir(): string;
189
231
  /**
190
232
  * 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
191
233
  *
192
- * - OpenAI:`body.messages`
193
- * - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
234
+ * **本函数的单元序列 ≠ token 顺序**:缓存前缀的真实顺序是 `tools → system → messages`,
235
+ * 而这里只产出 `system → messages`,tools 另记 `toolsHash`(见 {@link extractWireUnits}
236
+ * 调用点)。tools 不能作为单元加入本序列:它一变整条前缀即失效,已由 diff 的
237
+ * `toolsChanged → cacheableChars=0` 单独裁决,重复计入会把 stableChars 算错。
238
+ *
239
+ * dump 落盘 body 的 JSON **key 顺序**(`model/max_tokens/messages/system/tools`)只是
240
+ * provider 代码里对象字面量的书写顺序,被 `JSON.stringify` 保留下来,
241
+ * **同样不是 token 顺序**——翻看 dump 时若按 key 先后推断缓存结构会得出相反结论
242
+ * (实测:摘要请求未命中仅 6,890 token = 尾部新增两条消息,system+tools 的 94,949
243
+ * 字符一次未重算)。
244
+ *
245
+ * - OpenAI 形态:`body.messages`(system 作为 messages[0])
246
+ * - Anthropic 形态:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义
247
+ * 上位于**messages 之前**(但仍晚于 tools)
194
248
  *
195
249
  * @param body - provider 实际发送的请求体
196
250
  * @returns 前缀单元(role + 该单元 JSON 文本)
@@ -20,9 +20,33 @@
20
20
  import { createHash, randomBytes } from 'node:crypto';
21
21
  import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
22
22
  import { join } from 'node:path';
23
+ import { elidedCharsMarker } from '@octopi-agent/core/elision.js';
23
24
  import { getOctopiHome } from '../../paths.js';
24
25
  import { readHttpStatus, readStreamDiag, } from './provider-diagnostics.js';
25
26
  import { readAttemptBudgetExhausted } from '../../harness/run/reliability/fallback-provider.js';
27
+ /**
28
+ * 单条 tool_call arguments 留痕上限(字符):超出则头+尾保全、中间显式省略
29
+ * (降级标记是尾锚定形态,只留头部会挖掉唯一需要的证据——OP-TOOL-1 评审 M6)。
30
+ * 与 {@link RESPONSE_CAPTURE_HARD_CAP} 同为捕获护栏常数;如运营上需要按部署
31
+ * 调整再升配置字段(wire-dump 既有硬护栏先例:MAX_ERROR_MESSAGE_CHARS)。
32
+ */
33
+ export const TOOL_CALL_ARGS_CAPTURE_CAP = 65_536;
34
+ /** 超限时保留的尾部长度(尾锚定证据区) */
35
+ const TOOL_CALL_ARGS_TAIL_KEEP = 16_384;
36
+ /**
37
+ * chat 路径的 arguments 序列化(无原文可用;序列化失败不遮蔽真实响应)
38
+ *
39
+ * @param args - 解析后的参数对象
40
+ * @returns JSON 文本(失败降级为 String())
41
+ */
42
+ function stringifyArgsForTrace(args) {
43
+ try {
44
+ return JSON.stringify(args ?? {}) ?? String(args);
45
+ }
46
+ catch {
47
+ return String(args);
48
+ }
49
+ }
26
50
  /**
27
51
  * 响应留痕构造:正文/推理为空时不落字段——chat 与 stream 共用同一形态,
28
52
  * 下游不得按 `text === ''` 与 `=== undefined` 分叉解读(对称性)。
@@ -30,18 +54,58 @@ import { readAttemptBudgetExhausted } from '../../harness/run/reliability/fallba
30
54
  * @param text - 响应正文
31
55
  * @param reasoning - 推理汇总
32
56
  * @param finishReason - 结束原因
33
- * @returns 留痕对象;三项皆空时 undefined
57
+ * @param toolCalls - 工具调用原始留痕(无工具调用时不传)
58
+ * @returns 留痕对象;四项皆空时 undefined
34
59
  */
35
- function buildWireResponse(text, reasoning, finishReason) {
60
+ function buildWireResponse(text, reasoning, finishReason, toolCalls) {
36
61
  const info = {};
37
62
  if (text.length > 0)
38
63
  info.text = text;
39
64
  if (reasoning.length > 0)
40
65
  info.reasoning = reasoning;
66
+ if (toolCalls && toolCalls.length > 0)
67
+ info.toolCalls = toolCalls;
41
68
  if (finishReason !== undefined)
42
69
  info.finishReason = finishReason;
43
70
  return Object.keys(info).length > 0 ? info : undefined;
44
71
  }
72
+ /**
73
+ * 构造单条 tool_call 留痕:全文留痕、超上限显式截断(记全长,不静默)
74
+ *
75
+ * @param name - 工具名
76
+ * @param argsText - arguments 文本(stream 原文 / chat 序列化)
77
+ * @param raw - 是否逐字节原文
78
+ * @returns 留痕对象
79
+ */
80
+ /**
81
+ * 构造单条 tool_call 留痕:超上限时头+尾保全、中间显式省略(记全长,不静默)
82
+ *
83
+ * @param name - 工具名
84
+ * @param argsText - arguments 文本(stream 原文 / chat 序列化)
85
+ * @param raw - 是否逐字节原文
86
+ * @param extra - id / complete / parseError / ambiguous 附加留痕
87
+ * @returns 留痕对象
88
+ */
89
+ function buildToolCallTrace(name, argsText, raw, extra = {}) {
90
+ const overCap = argsText.length > TOOL_CALL_ARGS_CAPTURE_CAP;
91
+ let argumentsText = argsText;
92
+ if (overCap) {
93
+ const headLen = TOOL_CALL_ARGS_CAPTURE_CAP - TOOL_CALL_ARGS_TAIL_KEEP;
94
+ const omitted = argsText.length - headLen - TOOL_CALL_ARGS_TAIL_KEEP;
95
+ argumentsText =
96
+ `${argsText.slice(0, headLen)}` +
97
+ `\n${elidedCharsMarker(omitted, 'wire-dump capture')}\n` +
98
+ `${argsText.slice(-TOOL_CALL_ARGS_TAIL_KEEP)}`;
99
+ }
100
+ return {
101
+ name,
102
+ arguments: argumentsText,
103
+ argumentsChars: argsText.length,
104
+ ...(overCap ? { truncated: true } : {}),
105
+ raw,
106
+ ...extra,
107
+ };
108
+ }
45
109
  /** 错误消息落盘上限(字符):上游错误体可能带整段响应,撑爆索引无意义 */
46
110
  const MAX_ERROR_MESSAGE_CHARS = 800;
47
111
  /** 流式响应正文累积硬上限(字符):装饰器层的内存护栏,最终截断在 sink 的 maxResponseChars */
@@ -94,8 +158,20 @@ export function defaultWireDumpDir() {
94
158
  /**
95
159
  * 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
96
160
  *
97
- * - OpenAI:`body.messages`
98
- * - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
161
+ * **本函数的单元序列 ≠ token 顺序**:缓存前缀的真实顺序是 `tools → system → messages`,
162
+ * 而这里只产出 `system → messages`,tools 另记 `toolsHash`(见 {@link extractWireUnits}
163
+ * 调用点)。tools 不能作为单元加入本序列:它一变整条前缀即失效,已由 diff 的
164
+ * `toolsChanged → cacheableChars=0` 单独裁决,重复计入会把 stableChars 算错。
165
+ *
166
+ * dump 落盘 body 的 JSON **key 顺序**(`model/max_tokens/messages/system/tools`)只是
167
+ * provider 代码里对象字面量的书写顺序,被 `JSON.stringify` 保留下来,
168
+ * **同样不是 token 顺序**——翻看 dump 时若按 key 先后推断缓存结构会得出相反结论
169
+ * (实测:摘要请求未命中仅 6,890 token = 尾部新增两条消息,system+tools 的 94,949
170
+ * 字符一次未重算)。
171
+ *
172
+ * - OpenAI 形态:`body.messages`(system 作为 messages[0])
173
+ * - Anthropic 形态:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义
174
+ * 上位于**messages 之前**(但仍晚于 tools)
99
175
  *
100
176
  * @param body - provider 实际发送的请求体
101
177
  * @returns 前缀单元(role + 该单元 JSON 文本)
@@ -424,11 +500,20 @@ export function withWireDump(inner, sink) {
424
500
  const startedAt = Date.now();
425
501
  try {
426
502
  const res = await inner.chat(request);
503
+ let toolCalls;
504
+ if (res.toolCalls?.length) {
505
+ toolCalls = res.toolCalls.map((tc) => buildToolCallTrace(tc.name, stringifyArgsForTrace(tc.arguments), false, {
506
+ ...(tc.id ? { id: tc.id } : {}),
507
+ complete: true,
508
+ // 解析失败原文已丢(call-model 就地置 {}):必须显式标注,防误当全量证据
509
+ ...(tc.argumentsParseError !== undefined ? { parseError: true } : {}),
510
+ }));
511
+ }
427
512
  handle?.finish({
428
513
  outcome: 'ok',
429
514
  usage: res.usage,
430
515
  durationMs: Date.now() - startedAt,
431
- response: buildWireResponse(res.content, res.reasoning ?? '', res.finishReason),
516
+ response: buildWireResponse(res.content, res.reasoning ?? '', res.finishReason, toolCalls),
432
517
  });
433
518
  return res;
434
519
  }
@@ -455,6 +540,12 @@ export function withWireDump(inner, sink) {
455
540
  let reasoningText = '';
456
541
  let contentChunksSeen = 0;
457
542
  let finishReason;
543
+ /**
544
+ * tool_call 原文留痕(OP-TOOL-1 裁决物证):优先按 id 聚合、退化按 index,
545
+ * id 与 index 全缺时聚到同一槽并显式标 ambiguous(宁可标不可伪精确)
546
+ */
547
+ const toolCallTraces = new Map();
548
+ const AMBIGUOUS_KEY = '\u0000ambiguous';
458
549
  try {
459
550
  for await (const chunk of inner.stream(request)) {
460
551
  if (ttftMs == null)
@@ -463,6 +554,20 @@ export function withWireDump(inner, sink) {
463
554
  sawDone = true;
464
555
  finishReason = chunk.finishReason;
465
556
  }
557
+ if (chunk.type === 'tool_call' && chunk.toolCall) {
558
+ const tc = chunk.toolCall;
559
+ const key = tc.id ?? (tc.index !== undefined ? `idx:${tc.index}` : AMBIGUOUS_KEY);
560
+ const existing = toolCallTraces.get(key);
561
+ const entry = existing ?? { name: '', args: '' };
562
+ if (tc.id)
563
+ entry.id = tc.id;
564
+ if (tc.name)
565
+ entry.name = tc.name;
566
+ entry.args += tc.arguments ?? '';
567
+ if (existing && key === AMBIGUOUS_KEY)
568
+ entry.ambiguous = true;
569
+ toolCallTraces.set(key, entry);
570
+ }
466
571
  // done 携带全文的实现:仅当本流没有 content 增量时采用,避免正文重复一份
467
572
  if (chunk.type === 'content' && typeof chunk.content === 'string') {
468
573
  contentChunksSeen += 1;
@@ -487,8 +592,14 @@ export function withWireDump(inner, sink) {
487
592
  throw err;
488
593
  }
489
594
  finally {
595
+ const toolCalls = [...toolCallTraces.values()].map((entry) => buildToolCallTrace(entry.name, entry.args, true, {
596
+ ...(entry.id ? { id: entry.id } : {}),
597
+ ...(entry.ambiguous ? { ambiguous: true } : {}),
598
+ // 断流/提前退出的半截捕获必须与全量可辨(勿误判「模型只输出了一半」)
599
+ complete: sawDone || completed,
600
+ }));
490
601
  // 单个超大 chunk 也能顶穿上限:截断必须在累积之后
491
- const response = buildWireResponse(responseText.slice(0, RESPONSE_CAPTURE_HARD_CAP), reasoningText.slice(0, RESPONSE_CAPTURE_HARD_CAP), finishReason);
602
+ const response = buildWireResponse(responseText.slice(0, RESPONSE_CAPTURE_HARD_CAP), reasoningText.slice(0, RESPONSE_CAPTURE_HARD_CAP), finishReason, toolCalls);
492
603
  handle.finish({
493
604
  // 正常读完但服务端没发 done 哨兵(代理断流/兼容实现)不等于消费者放弃:
494
605
  // 判 abandoned 会把真实完成记成"提前中断",并误报给 llm-diff
@@ -501,5 +612,7 @@ export function withWireDump(inner, sink) {
501
612
  });
502
613
  }
503
614
  },
615
+ // 转发 dispose:否则 wire dump 开启时,退役/停机回收会对装饰实例静默失效
616
+ ...(typeof inner.dispose === 'function' ? { dispose: () => inner.dispose?.() } : {}),
504
617
  };
505
618
  }
@@ -60,14 +60,26 @@ export declare class SessionArchiveManager {
60
60
  private appendToArchive;
61
61
  /**
62
62
  * 查询归档中的 session
63
+ *
64
+ * @param sessionId - 会话 id
65
+ * @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
63
66
  */
64
- queryArchive(sessionId: string): Promise<SessionData | null>;
67
+ queryArchive(sessionId: string, opts?: {
68
+ tenantId?: string;
69
+ }): Promise<SessionData | null>;
65
70
  /**
66
71
  * 列出归档中的 session 元数据
72
+ *
73
+ * @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
74
+ * 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
67
75
  */
68
- listArchived(agentId?: string): Promise<Array<{
76
+ listArchived(filter?: string | {
77
+ agentId?: string;
78
+ tenantId?: string;
79
+ }): Promise<Array<{
69
80
  sessionId: string;
70
81
  agentId: string;
82
+ tenantId?: string;
71
83
  archivedAt: number;
72
84
  }>>;
73
85
  /**
@@ -11,10 +11,12 @@
11
11
  *
12
12
  * @module
13
13
  */
14
- import { mkdir, readdir, stat, unlink, readFile, writeFile } from 'node:fs/promises';
14
+ import { mkdir, readdir, stat, unlink, readFile } from 'node:fs/promises';
15
15
  import { gzip, gunzip } from 'node:zlib';
16
16
  import { promisify } from 'node:util';
17
17
  import { join } from 'node:path';
18
+ import { atomicWriteFile } from './atomic-tmp.js';
19
+ import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
18
20
  import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
19
21
  export class SessionArchiveManager {
20
22
  store;
@@ -120,15 +122,18 @@ export class SessionArchiveManager {
120
122
  }
121
123
  const newContent = existing + line;
122
124
  const compressed = await this.compress(Buffer.from(newContent, 'utf-8'));
123
- const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
124
- await writeFile(tmpPath, compressed);
125
- const { rename } = await import('node:fs/promises');
126
- await rename(tmpPath, filePath);
125
+ // tmp+rename 原子落位(读侧不见半截)。已知局限(评审 del-3c3fcfeb MIN-3):
126
+ // existing+line 的读改写无并发串行,同文件并发追加会丢行——当前 runArchive
127
+ // 顺序执行无触发点;启用归档调度前必须按文件路径串行化(arch/open-problems.md)。
128
+ await atomicWriteFile(filePath, compressed);
127
129
  }
128
130
  /**
129
131
  * 查询归档中的 session
132
+ *
133
+ * @param sessionId - 会话 id
134
+ * @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
130
135
  */
131
- async queryArchive(sessionId) {
136
+ async queryArchive(sessionId, opts) {
132
137
  const files = await this.listArchiveFiles();
133
138
  for (const file of files) {
134
139
  try {
@@ -138,6 +143,9 @@ export class SessionArchiveManager {
138
143
  for (const line of lines) {
139
144
  const entry = JSON.parse(line);
140
145
  if (entry.sessionId === sessionId) {
146
+ if (opts?.tenantId !== undefined && (entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID) !== opts.tenantId) {
147
+ return null;
148
+ }
141
149
  return entry.data;
142
150
  }
143
151
  }
@@ -150,8 +158,12 @@ export class SessionArchiveManager {
150
158
  }
151
159
  /**
152
160
  * 列出归档中的 session 元数据
161
+ *
162
+ * @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
163
+ * 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
153
164
  */
154
- async listArchived(agentId) {
165
+ async listArchived(filter) {
166
+ const normalized = typeof filter === 'string' ? { agentId: filter } : (filter ?? {});
155
167
  const files = await this.listArchiveFiles();
156
168
  const results = [];
157
169
  for (const file of files) {
@@ -162,10 +174,14 @@ export class SessionArchiveManager {
162
174
  for (const line of lines) {
163
175
  const entry = JSON.parse(line);
164
176
  const pick = toIndexPick(entry.data);
165
- if (!agentId || sessionMatchesAgent(pick, agentId)) {
177
+ const entryTenant = entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID;
178
+ if (normalized.tenantId !== undefined && entryTenant !== normalized.tenantId)
179
+ continue;
180
+ if (!normalized.agentId || sessionMatchesAgent(pick, normalized.agentId)) {
166
181
  results.push({
167
182
  sessionId: entry.sessionId,
168
183
  agentId: entry.data.agentId,
184
+ tenantId: entryTenant,
169
185
  archivedAt: entry.archivedAt,
170
186
  });
171
187
  }
@@ -0,0 +1,12 @@
1
+ export declare function atomicTmpPath(target: string): string;
2
+ /**
3
+ * tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
4
+ *
5
+ * (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
6
+ * load→save 放大链路会把转录永久清空。)
7
+ *
8
+ * @param target - 目标文件路径
9
+ * @param content - 整文件内容
10
+ * @returns 写入完成(rename 落位)的 Promise
11
+ */
12
+ export declare function atomicWriteFile(target: string, content: string | Buffer): Promise<void>;
@@ -0,0 +1,36 @@
1
+ import { writeFile, rename } from 'node:fs/promises';
2
+ /**
3
+ * 原子写 tmp 路径命名(按「写操作」唯一)。
4
+ *
5
+ * tmp+rename 原子写的前提:tmp 名在同一目标上绝不复用。仅 pid+毫秒 不够——
6
+ * 同毫秒双写共用 tmp 名:先到者 rename 走 tmp,后到者 rename ENOENT;更糟时
7
+ * 后到者 writeFile 的半截被 rename 进目标(静默损坏)。T5 演练实锤 2026-11-14
8
+ * (sessions.json 元索引同毫秒双写)。
9
+ *
10
+ * 前提声明:唯一性成立域是**单机**(pid 不撞);多机共享同一 OCTOPI_HOME(P2
11
+ * 拓扑)时补 random 段兜底。进程内另以单调序号断言同 ms 不复用。
12
+ *
13
+ * @param target - 目标文件路径
14
+ * @returns 该次写操作专属的 tmp 路径(pid + 毫秒 + 进程内单调序号 + 随机段)
15
+ */
16
+ let seq = 0;
17
+ export function atomicTmpPath(target) {
18
+ seq += 1;
19
+ const rand = Math.random().toString(36).slice(2, 8);
20
+ return `${target}.${process.pid}.${Date.now()}.${seq}.${rand}.tmp`;
21
+ }
22
+ /**
23
+ * tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
24
+ *
25
+ * (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
26
+ * load→save 放大链路会把转录永久清空。)
27
+ *
28
+ * @param target - 目标文件路径
29
+ * @param content - 整文件内容
30
+ * @returns 写入完成(rename 落位)的 Promise
31
+ */
32
+ export async function atomicWriteFile(target, content) {
33
+ const tmpPath = atomicTmpPath(target);
34
+ await writeFile(tmpPath, content);
35
+ await rename(tmpPath, target);
36
+ }
@@ -69,6 +69,15 @@ export declare class JsonlSessionStore implements SessionStore<SessionData> {
69
69
  * 整包 save 是常态动作,对齐即自愈。
70
70
  */
71
71
  syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
72
+ /**
73
+ * spawnBy 投影 backfill(每实例一次):升级前落盘的会话其索引条目缺 `spawnBy`
74
+ * (权威值在 state.json),历史隐藏子会话 / 父子归组依赖该投影。
75
+ * 只补缺失条目,幂等;失败不阻断 list(显式降级 = 子会话暂在历史露出),
76
+ * warn 后清缓存待下次 list 重试,不静默吞。
77
+ */
78
+ private spawnLinkBackfill?;
79
+ private ensureSpawnLinkBackfill;
80
+ private backfillSpawnLinks;
72
81
  list(filter?: SessionListFilter): Promise<SessionMeta[]>;
73
82
  /**
74
83
  * 按会话事实 lifecycle 过滤(索引投影;缺省视为 active)。