@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +201 -8
  23. package/dist/config.js +105 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
package/dist/config.d.ts CHANGED
@@ -20,8 +20,10 @@ export interface AgentConfig {
20
20
  id: string;
21
21
  /** Agent home 目录:persona、skills 的根目录(session 在 OCTOPI_HOME/sessions;memory/wisdom 走 AgentDatabase SQLite) */
22
22
  home?: string;
23
- /** 沙箱工作目录:agent 工具操作的 cwd,默认为 home 下的 workspace 子目录 */
23
+ /** 沙箱工作目录:agent 工具操作的 cwd,默认为 home 下的 workspace 子目录;支持 ~ 形态(使用点展开) */
24
24
  workspace?: string;
25
+ /** ToolEffectPolicy(P3) */
26
+ effectPolicy?: import('./harness/extension/execution-environment/effect-policy.js').EffectPolicyConfig;
25
27
  /**
26
28
  * Persona 配置(向后兼容:string 形式等价于 home)
27
29
  * - string: persona 目录路径(已废弃,请使用 home)
@@ -54,6 +56,27 @@ export interface AgentConfig {
54
56
  knowledge?: {
55
57
  recall?: KnowledgeRecallMode;
56
58
  };
59
+ /** 特质标签(arch/delegation.md §9.2:供父 agent 按特质发现委派目标);无权限语义 */
60
+ traits?: string[];
61
+ /** 委派策略(arch/delegation.md §9.2);整段可省略 = 用 DEFAULT_DELEGATION_POLICY(委派默认开启)*/
62
+ delegation?: {
63
+ /** 能否被委派(默认 true;显式 false = 只能被用户直接对话) */
64
+ callable: boolean;
65
+ /** 允许哪些 agentId 调我(缺省 = 任意) */
66
+ callableBy?: string[];
67
+ /** 我能不能再委派、获得 delegate_* 工具(默认 true) */
68
+ canDelegate: boolean;
69
+ /** 递归上限(默认 1 = 我能派子,子不能再派;runaway 兜底) */
70
+ maxDepth?: number;
71
+ /** 被委派时的权利天花板(只能收紧不能放宽,D3) */
72
+ rightsCeiling?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionRights;
73
+ /** 委派预算上限(请求预算与此取交集) */
74
+ budget?: {
75
+ maxTurns?: number;
76
+ maxTokens?: number;
77
+ timeoutMs?: number;
78
+ };
79
+ };
57
80
  }
58
81
  /**
59
82
  * Knowledge 内容召回模式
@@ -65,6 +88,19 @@ export interface AgentConfig {
65
88
  export type KnowledgeRecallMode = 'off' | 'hint' | 'hybrid' | 'inject';
66
89
  /** Knowledge 全局配置(agents[].knowledge 覆盖 recall 等) */
67
90
  export interface KnowledgeRuntimeConfig {
91
+ /** Knowledge Service 连接(v2:Gateway 不打开 knowledge.db);对齐 KnowledgeConfigSchema */
92
+ service?: {
93
+ baseUrl?: string;
94
+ token?: string;
95
+ /** 缺省 true:serve 时拉起本地 Knowledge;false 则只连 baseUrl */
96
+ manageLocal?: boolean;
97
+ /** manageLocal 本地监听端口(缺省 18280) */
98
+ port?: number;
99
+ timeoutMs?: number;
100
+ connectTimeoutMs?: number;
101
+ };
102
+ /** true = Knowledge 不可用则 run 失败(默认 fail-open) */
103
+ required?: boolean;
68
104
  recall?: KnowledgeRecallMode;
69
105
  autoInject?: {
70
106
  minScore?: number;
@@ -211,6 +247,13 @@ export interface WebSearchToolConfig {
211
247
  export interface SessionConfig {
212
248
  /** DM 作用域: main / per-peer / per-channel-peer */
213
249
  dmScope?: 'main' | 'per-peer' | 'per-channel-peer';
250
+ /**
251
+ * 上下文租约(毫秒)。**显式配置才生效**;缺省关闭。
252
+ *
253
+ * 闲置超过该值后,下一轮 LLM 默认消息窗口从租约点截断(Discourse 全量保留,
254
+ * 可用 session_search / session_read 查旧内容)。与 memory 冷沉淀解耦。
255
+ */
256
+ idleExpiryMs?: number;
214
257
  }
215
258
  /**
216
259
  * Plugin 配置
@@ -395,6 +438,17 @@ export interface AgentRuntimeJsonConfig {
395
438
  /** 订阅 runtime.agent_signal(多 Agent 通知);默认随 escalate 一起挂 */
396
439
  agentSignal?: boolean;
397
440
  }
441
+ /**
442
+ * SessionSchedule 预算 / 兜底(arch/session-schedules.md P1)
443
+ */
444
+ export interface SchedulesJsonConfig {
445
+ /** 每会话未闭合作业上限;0 = 不限(默认 50) */
446
+ maxOpenPerSession?: number;
447
+ /** 每小时 wakeup 点火上限(进程级);0 = 不限(默认 120) */
448
+ maxWakesPerHour?: number;
449
+ /** 兜底扫描间隔 ms(默认 60000);0 = 关闭 */
450
+ tickIntervalMs?: number;
451
+ }
398
452
  /**
399
453
  * 上下文引擎配置
400
454
  *
@@ -407,11 +461,11 @@ export interface ContextEngineConfig {
407
461
  protectFirstN?: number;
408
462
  /** 尾部保护消息数(默认 20) */
409
463
  protectLastN?: number;
410
- /** 触发压缩的阈值比例(默认 0.5) */
411
- compactThreshold?: number;
412
464
  /**
413
- * 主动摘要阈值:消息 token / messagesBudget 超过该比例时,
414
- * 在硬溢出前先 LLM 摘要(默认 0.6;0 = 关闭)
465
+ * 窗口比例线:消息 token / messagesBudget 超过该比例时,
466
+ * 在硬溢出前先主动压缩(默认 0.6)。
467
+ * `0` = **禁止发起新的**路径 A 压缩(不只禁 LLM;目标线/窗口比例线同闸);**不**丢弃已有
468
+ * `previousSummary` 粘滞视图(粘滞重建仍生效)。turn 内(工具活动中)本就不打 LLM。
415
469
  */
416
470
  proactiveCompactRatio?: number;
417
471
  /**
@@ -419,6 +473,34 @@ export interface ContextEngineConfig {
419
473
  * 冷却期内优先缓存重建,降低单 turn 双摘要。
420
474
  */
421
475
  proactiveCooldownMs?: number;
476
+ /**
477
+ * 历史工具结果批量冻结老化(F1-B2):当前 run 永不老化、近 rawWindow 条跨轮原文、
478
+ * 更旧按 freezeBatch 成批降级为结构化指针(视图级、write-once、禁渐进)。
479
+ */
480
+ historyAging?: {
481
+ /** 总开关(默认 true) */
482
+ enabled?: boolean;
483
+ /** 跨轮原文保留条数(默认 40) */
484
+ rawWindow?: number;
485
+ /**
486
+ * 批量冻结步长(默认 20;最小 1)。
487
+ * ⚠️ 1 = 逐候选即降级(等同渐进老化、每轮烧前缀缓存,仅调试用);
488
+ * 生产取值应 ≥ 每轮工具结果数。
489
+ */
490
+ freezeBatch?: number;
491
+ /** 指针目标字符数(默认 400;是目标非硬顶) */
492
+ maxPointerChars?: number;
493
+ };
494
+ /**
495
+ * 工作目标 token(与窗口解耦,F1-B3):目标线 = targetTokens × compactFallbackRatio,
496
+ * 与窗口比例线取 min。默认 200000;0 = 只挂窗口比例线(proactiveCompactRatio)。
497
+ */
498
+ targetTokens?: number;
499
+ /**
500
+ * 目标线倍数(默认 3)。触发线 = targetTokens × compactFallbackRatio;
501
+ * 须 > B2 老化稳态,否则双机制打架。窗口比例线始终并存。
502
+ */
503
+ compactFallbackRatio?: number;
422
504
  /** 输出预留比例(默认 0.20) */
423
505
  outputRatio?: number;
424
506
  /** 输出预留最小值(默认 2000) */
@@ -517,6 +599,11 @@ export interface ContextAssemblerConfig {
517
599
  systemBudgetRatio?: number;
518
600
  /** 显式 system 预算 token(窗口未知时仍可用,优先于 ratio) */
519
601
  systemBudgetTokens?: number;
602
+ /**
603
+ * 易变快照组(E8,placement='snapshot' 层)的 token 预算。
604
+ * 缺省不设上限;设置后快照组超预算按层优先级截断/丢弃。
605
+ */
606
+ snapshotBudgetTokens?: number;
520
607
  /** 显式压缩目标 token;窗口未知时用于结构压缩/assemble 预算 */
521
608
  compactTargetTokens?: number;
522
609
  /**
@@ -682,9 +769,19 @@ export interface ModelsConfig {
682
769
  embedding?: EmbeddingModelConfig;
683
770
  }
684
771
  /** 自主子系统配置(框架级:搜索路径与审计;子系统自身参数写在各自 config.yaml) */
772
+ /** ModelCallConfig — octopi.json 中的 modelCall 字段(引擎模型调用 watchdog 超时) */
773
+ export interface ModelCallConfig {
774
+ /** 流式 chunk 间最大静默(含首 token 等待),毫秒 */
775
+ idleTimeoutMs?: number;
776
+ /** 单次模型调用总时长上限,毫秒 */
777
+ absoluteTimeoutMs?: number;
778
+ }
685
779
  export interface SubsystemsConfig {
686
- /** 审计日志目录(默认 ~/.octopi/audit) */
687
- auditDir?: string;
780
+ /**
781
+ * 审计日志目录(默认 `~/.octopi/audit`)。
782
+ * `false` = 显式关闭子系统审计。
783
+ */
784
+ auditDir?: string | false;
688
785
  /** 允许注册:id / packageId / `memory.steward.*` 前缀 */
689
786
  allowlist?: string[];
690
787
  /** 禁止注册(deny 优先) */
@@ -696,6 +793,13 @@ export interface SubsystemsConfig {
696
793
  export interface HarnessConfig {
697
794
  /** 自主子系统配置 */
698
795
  subsystems?: SubsystemsConfig;
796
+ /**
797
+ * 委派编排(arch/delegation.md §8)。
798
+ * `maxActiveDelegationsPerSession` 是失控防护,不是并发闸(D9)。
799
+ */
800
+ delegation?: {
801
+ maxActiveDelegationsPerSession?: number;
802
+ };
699
803
  /** Agent 列表 */
700
804
  agents: AgentConfig[];
701
805
  /** 模型配置(集中定义 provider + model) */
@@ -708,8 +812,12 @@ export interface HarnessConfig {
708
812
  budgetPolicy?: BudgetPolicyJsonConfig;
709
813
  /** 过程监督配置(行为监督;与 budget 组合) */
710
814
  runGuard?: RunGuardJsonConfig;
815
+ /** 模型调用 watchdog 超时(modelCall 段) */
816
+ modelCall?: ModelCallConfig;
711
817
  /** 激活宿主(long-lived;Schedule/Escalate 等) */
712
818
  agentRuntime?: AgentRuntimeJsonConfig;
819
+ /** SessionSchedule 预算与兜底 tick */
820
+ schedules?: SchedulesJsonConfig;
713
821
  /** 上下文引擎配置 */
714
822
  contextEngine?: ContextEngineConfig;
715
823
  /** 公用能力 summary(harness/context/capabilities) */
@@ -851,6 +959,13 @@ export interface HarnessConfig {
851
959
  *
852
960
  * 硬边界与 ToolCallRiskPolicy 始终执行;此处只调处置/范围/灵敏度。
853
961
  */
962
+ /**
963
+ * 命名凭证库策略(SEC-3c)
964
+ * 默认:有绑定则强制;无绑定可解析。requireBindings=true 时无绑定即拒。
965
+ */
966
+ credentials?: {
967
+ requireBindings?: boolean;
968
+ };
854
969
  security?: {
855
970
  /**
856
971
  * 风险命中后的处置(硬边界不受影响)
@@ -860,6 +975,14 @@ export interface HarnessConfig {
860
975
  enforce?: 'block' | 'audit';
861
976
  /** 注入检测灵敏度 */
862
977
  injectionSensitivity?: 'low' | 'medium' | 'high';
978
+ /**
979
+ * 工具/引擎出站网络门禁(http_request、Knowledge 默认)
980
+ * 默认拒私网/环回/metadata;内网目标需显式 allowPrivateNetwork
981
+ */
982
+ network?: {
983
+ /** 显式放行私网/环回(lab/内网);metadata/链路本地始终拒绝 */
984
+ allowPrivateNetwork?: boolean;
985
+ };
863
986
  /** 绝对路径额外允许范围 */
864
987
  allowedPaths?: string[];
865
988
  };
@@ -875,12 +998,24 @@ export interface HarnessConfig {
875
998
  * - `session-lock`:共享路径;同 sessionId 由 Runner 锁串行(不路径隔离)
876
999
  */
877
1000
  toolIsolation?: 'none' | 'session-subdir' | 'session-lock';
1001
+ /** ToolEffectPolicy 运行模式(P3) */
1002
+ effectPolicy?: import('./harness/extension/execution-environment/effect-policy.js').EffectPolicyConfig;
878
1003
  /**
879
1004
  * Session ACL 角色目录(E6)
880
1005
  *
881
1006
  * 缺省使用内置五角色;可覆盖/新增。handoff 默认仅宿主。
882
1007
  */
883
1008
  sessionAcl?: import('@octopi-agent/engine/harness/governance/session-acl/types.js').SessionAclConfig;
1009
+ /**
1010
+ * send_file 外发限额
1011
+ *
1012
+ * - `maxBytes`:单文件上限(字节);缺省 2GB
1013
+ * - `maxReleasesPerSession`:每会话 release 次数;缺省 / 0 = 不限
1014
+ */
1015
+ fileSend?: {
1016
+ maxBytes?: number;
1017
+ maxReleasesPerSession?: number;
1018
+ };
884
1019
  /** 并发控制配置 */
885
1020
  concurrency?: {
886
1021
  /** 多 Key Provider 负载均衡池 */
@@ -950,6 +1085,17 @@ export interface HarnessConfig {
950
1085
  captureStreamDeltas?: boolean;
951
1086
  /** 是否记录完整模型请求 */
952
1087
  captureModelRequest?: boolean;
1088
+ /**
1089
+ * LLM wire dump:把 provider 实际发送的完整请求体按 session 落盘,用于比对前缀稳定性
1090
+ *
1091
+ * 默认关闭。落盘根目录缺省 `<OCTOPI_HOME>/logs/llm-requests`;
1092
+ * 分析命令:`octopi llm-diff [sessionId]`。
1093
+ *
1094
+ * 生效路径:`octopi serve`(CLI daemon 自建共享 sink)。库嵌入方可把
1095
+ * `createWireDumpSink()` 的结果经 `createProviderFromConfig(name, pc, { wireDump })` 注入。
1096
+ * 配置面只含纯数据(不含 `resolveContext` 等运行时钩子)。
1097
+ */
1098
+ llmRequestDump?: import('./integration/providers/wire-dump.js').WireDumpConfig;
953
1099
  };
954
1100
  }
955
1101
  /**
@@ -975,10 +1121,57 @@ export interface NormalizedModelInfo {
975
1121
  contextWindow?: number;
976
1122
  maxTokens?: number;
977
1123
  }
1124
+ /**
1125
+ * 按 `observability.llmRequestDump` 配置构造 wire dump sink
1126
+ *
1127
+ * 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
1128
+ * `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
1129
+ * provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
1130
+ *
1131
+ * @param cfg - `observability.llmRequestDump` 配置段
1132
+ * @returns sink;未启用时 undefined
1133
+ */
1134
+ export declare function createWireDumpSinkFromConfig(cfg?: import('./integration/providers/wire-dump.js').WireDumpConfig): Promise<import('./integration/providers/wire-dump.js').WireDumpSink | undefined>;
978
1135
  /**
979
1136
  * 从 ModelProviderConfig 创建 ModelProvider 实例
980
1137
  *
981
1138
  * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
982
1139
  * 使用动态 import 以支持 ESM。
1140
+ *
1141
+ * @param name - provider 名称
1142
+ * @param pc - provider 配置
1143
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
1144
+ * @returns provider 实例(wire dump → 原生 provider 的装饰链;LLM 计时已 observability 化进 model.call.*)
1145
+ */
1146
+ export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig, options?: {
1147
+ wireDump?: import('./integration/providers/wire-dump.js').WireDumpSink;
1148
+ }): Promise<ModelProvider>;
1149
+ /**
1150
+ * 按 `observability` 配置构造 RunTelemetry 工厂(F3/D5 接线,组合根)
1151
+ *
1152
+ * TraceCollector → TraceLogger 按 `outputDir` 逐条同步落 JSONL(即 `traceDir`,无缓冲丢失风险);
1153
+ * `level` / `consoleLevel` 与配置的 0–5 数值同构(FATAL=0 … TRACE=5,schema 已校验范围)。
1154
+ * `consoleLevel` 缺省 null:trace 走文件通道,不向 gateway.log 混入控制台副本(要副本显式配置)。
1155
+ *
1156
+ * @param cfg - `observability` 配置段(level / consoleLevel / traceDir / capture*)
1157
+ * @param options - 可选:trace 文件名前缀(多 agent 归属标识)
1158
+ * @returns RunTelemetry 工厂(供 `AgentBuilder.telemetryFactory()` 注入)
1159
+ */
1160
+ export declare function createTelemetryFactoryFromConfig(cfg: NonNullable<HarnessConfig['observability']>, options?: {
1161
+ filePrefix?: string;
1162
+ }): Promise<import('./harness/observability/run-telemetry.js').RunTelemetryFactory>;
1163
+ /**
1164
+ * 按 `observability` 配置接线 AgentBuilder 观测装配(F3/D5)
1165
+ *
1166
+ * - 落盘:`traceDir / level / consoleLevel` → TraceCollector → JSONL
1167
+ * - 采集意图:`captureStreamDeltas / captureModelRequest` → `AgentBuilder.trace()`
1168
+ * - 工厂显式注入,不依赖包入口 `setRunTelemetryFactory` 副作用
1169
+ * (serve / 子路径 import 时该副作用未必执行过,不能拿它当接线)
1170
+ *
1171
+ * @param builder - 目标 builder(`build()` 之前调用)
1172
+ * @param cfg - `observability` 配置段;缺省时不做任何事
1173
+ * @param options - 可选:trace 文件名前缀(一般传 agentId)
983
1174
  */
984
- export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig): Promise<ModelProvider>;
1175
+ export declare function wireObservability(builder: import('./harness/agent/builder.js').AgentBuilder, cfg: HarnessConfig['observability'] | undefined, options?: {
1176
+ filePrefix?: string;
1177
+ }): Promise<void>;
package/dist/config.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { getRunScope } from './harness/run/run-scope.js';
1
2
  import { DEFAULT_CONTEXT_WINDOW } from '@octopi-agent/core/types/model-info.js';
2
3
  /** 产品默认上下文窗口(与 core/types/model-info 一致,未声明能力时按此预算) */
3
4
  export { DEFAULT_CONTEXT_WINDOW };
@@ -142,20 +143,121 @@ function resolveFallbackModels(fallbacks, models, defaults, depth = 0) {
142
143
  });
143
144
  }
144
145
  // ── Provider 工厂 ──
146
+ // ── 观测装配(F3/D5)──
147
+ /**
148
+ * 按 `observability.llmRequestDump` 配置构造 wire dump sink
149
+ *
150
+ * 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
151
+ * `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
152
+ * provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
153
+ *
154
+ * @param cfg - `observability.llmRequestDump` 配置段
155
+ * @returns sink;未启用时 undefined
156
+ */
157
+ export async function createWireDumpSinkFromConfig(cfg) {
158
+ if (!cfg?.enabled)
159
+ return undefined;
160
+ // 与 withWireDump 一致按需加载:dump 未启用时 fs/crypto 不进常规 provider 创建路径
161
+ const { createWireDumpSink } = await import('./integration/providers/wire-dump.js');
162
+ return createWireDumpSink({
163
+ dir: cfg.dir,
164
+ maxCallsPerSession: cfg.maxCallsPerSession,
165
+ maxBodyBytes: cfg.maxBodyBytes,
166
+ resolveContext: () => {
167
+ const scope = getRunScope();
168
+ return scope
169
+ ? { sessionId: scope.sessionId, agentId: scope.agentId, runId: scope.runId }
170
+ : undefined;
171
+ },
172
+ });
173
+ }
145
174
  /**
146
175
  * 从 ModelProviderConfig 创建 ModelProvider 实例
147
176
  *
148
177
  * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
149
178
  * 使用动态 import 以支持 ESM。
179
+ *
180
+ * @param name - provider 名称
181
+ * @param pc - provider 配置
182
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
183
+ * @returns provider 实例(wire dump → 原生 provider 的装饰链;LLM 计时已 observability 化进 model.call.*)
150
184
  */
151
- export async function createProviderFromConfig(name, pc) {
185
+ export async function createProviderFromConfig(name, pc, options) {
152
186
  const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
153
187
  const models = pc.models.map(m => ({ name: m.name ?? m.id, contextWindow: m.contextWindow, maxOutputTokens: m.maxTokens }));
154
188
  const defaultModel = pc.models[0]?.name ?? pc.models[0]?.id;
189
+ let decorate = (inner) => inner;
190
+ if (options?.wireDump) {
191
+ // 仅诊断路径才加载 wire dump(fs/crypto 不进入常规 provider 创建)。
192
+ // dump 必须贴在真实 provider 上才能拿到 `wireBodyFor`。
193
+ const { withWireDump } = await import('./integration/providers/wire-dump.js');
194
+ const sink = options.wireDump;
195
+ decorate = (inner) => withWireDump(inner, sink);
196
+ }
155
197
  if (apiType === 'anthropic') {
156
198
  const { AnthropicProvider } = await import('./integration/providers/anthropic.js');
157
- return new AnthropicProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined });
199
+ return decorate(new AnthropicProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
158
200
  }
159
201
  const { OpenAIProvider } = await import('./integration/providers/openai.js');
160
- return new OpenAIProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined });
202
+ return decorate(new OpenAIProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
203
+ }
204
+ /**
205
+ * 按 `observability` 配置构造 RunTelemetry 工厂(F3/D5 接线,组合根)
206
+ *
207
+ * TraceCollector → TraceLogger 按 `outputDir` 逐条同步落 JSONL(即 `traceDir`,无缓冲丢失风险);
208
+ * `level` / `consoleLevel` 与配置的 0–5 数值同构(FATAL=0 … TRACE=5,schema 已校验范围)。
209
+ * `consoleLevel` 缺省 null:trace 走文件通道,不向 gateway.log 混入控制台副本(要副本显式配置)。
210
+ *
211
+ * @param cfg - `observability` 配置段(level / consoleLevel / traceDir / capture*)
212
+ * @param options - 可选:trace 文件名前缀(多 agent 归属标识)
213
+ * @returns RunTelemetry 工厂(供 `AgentBuilder.telemetryFactory()` 注入)
214
+ */
215
+ export async function createTelemetryFactoryFromConfig(cfg, options) {
216
+ const { createRunTelemetry } = await import('./integration/observability/run-telemetry.js');
217
+ const { TraceCollector } = await import('./integration/observability/trace-collector.js');
218
+ const { getRunScope } = await import('./harness/run/run-scope.js');
219
+ // 配置 0–5 与 TraceLevel 数值同构;schema 保证 0-5 整数
220
+ const level = (cfg.level ?? 3);
221
+ const consoleLevel = (cfg.consoleLevel ?? null);
222
+ // 前缀进文件名:非法字符替换,防 agentId 越界成路径
223
+ const filePrefix = options?.filePrefix?.replace(/[^\w.-]/g, '_');
224
+ return (traceOptions) => createRunTelemetry({
225
+ ...traceOptions,
226
+ // model.call.* 归因:LoopObserver 路径经 RunScope ALS 取 sessionId/agentId(与 wire dump 同法)
227
+ resolveContext: () => {
228
+ const scope = getRunScope();
229
+ return scope ? { sessionId: scope.sessionId, agentId: scope.agentId } : {};
230
+ },
231
+ collector: new TraceCollector({
232
+ ...traceOptions,
233
+ level,
234
+ consoleLevel,
235
+ outputDir: cfg.traceDir ?? null,
236
+ ...(filePrefix ? { filePrefix } : {}),
237
+ }),
238
+ });
239
+ }
240
+ /**
241
+ * 按 `observability` 配置接线 AgentBuilder 观测装配(F3/D5)
242
+ *
243
+ * - 落盘:`traceDir / level / consoleLevel` → TraceCollector → JSONL
244
+ * - 采集意图:`captureStreamDeltas / captureModelRequest` → `AgentBuilder.trace()`
245
+ * - 工厂显式注入,不依赖包入口 `setRunTelemetryFactory` 副作用
246
+ * (serve / 子路径 import 时该副作用未必执行过,不能拿它当接线)
247
+ *
248
+ * @param builder - 目标 builder(`build()` 之前调用)
249
+ * @param cfg - `observability` 配置段;缺省时不做任何事
250
+ * @param options - 可选:trace 文件名前缀(一般传 agentId)
251
+ */
252
+ export async function wireObservability(builder, cfg, options) {
253
+ if (!cfg)
254
+ return;
255
+ builder.telemetryFactory(await createTelemetryFactoryFromConfig(cfg, options));
256
+ builder.trace({
257
+ captureStreamDeltas: cfg.captureStreamDeltas,
258
+ captureModelRequest: cfg.captureModelRequest,
259
+ // metrics 读取口未暴露(Builder 无 getTelemetry)且 LatencyTracker 无界:
260
+ // 暴露读取口前不启用,避免长驻 serve 只写不读的内存增长
261
+ enableMetrics: false,
262
+ });
161
263
  }
@@ -52,6 +52,9 @@ function compileOne(trigger) {
52
52
  ...(trigger.metadata?.parentAgentId
53
53
  ? { parentAgentId: trigger.metadata.parentAgentId }
54
54
  : {}),
55
+ ...(trigger.metadata?.delegationId
56
+ ? { delegationId: trigger.metadata.delegationId }
57
+ : {}),
55
58
  ...(trigger.metadata?.attachments?.length
56
59
  ? { attachmentIds: trigger.metadata.attachments.map((a) => a.id) }
57
60
  : {}),
@@ -54,6 +54,13 @@ export declare class AgentRuntime {
54
54
  abort(agentId: string, sessionId: string): void;
55
55
  /** 是否存在该 agent+session 的活跃 Run(/stop 文案与竞态观测) */
56
56
  hasActiveRun(agentId: string, sessionId: string): boolean;
57
+ /**
58
+ * 是否存在该会话的活跃 Run(不看 agent 归属)。
59
+ *
60
+ * @param sessionId - 会话 id
61
+ * @returns 该会话下任一 Run 在途即 true
62
+ */
63
+ hasActiveRunForSession(sessionId: string): boolean;
57
64
  /**
58
65
  * 监听 Runtime 事件。
59
66
  * - `on(listener)`:全部事件
@@ -10,6 +10,21 @@ import { CoalesceBuffer } from './coalesce.js';
10
10
  import { buildRunRequest, resolveSessionId } from './compiler.js';
11
11
  import { ExplicitRouter } from './router.js';
12
12
  import { RuntimeEvents } from './types.js';
13
+ /**
14
+ * Trigger → 事件回执用裁剪引用(不含 payload 正文)
15
+ *
16
+ * @param trigger - 完整 trigger
17
+ * @returns 裁剪引用(id/type/agentId/sessionId/metadata)
18
+ */
19
+ function toTriggerRef(trigger) {
20
+ return {
21
+ id: trigger.id,
22
+ type: trigger.type,
23
+ agentId: trigger.agentId,
24
+ sessionId: trigger.sessionId,
25
+ metadata: trigger.metadata,
26
+ };
27
+ }
13
28
  export class AgentRuntime {
14
29
  events;
15
30
  router;
@@ -102,6 +117,19 @@ export class AgentRuntime {
102
117
  }
103
118
  return false;
104
119
  }
120
+ /**
121
+ * 是否存在该会话的活跃 Run(不看 agent 归属)。
122
+ *
123
+ * @param sessionId - 会话 id
124
+ * @returns 该会话下任一 Run 在途即 true
125
+ */
126
+ hasActiveRunForSession(sessionId) {
127
+ for (const run of this.activeRuns.values()) {
128
+ if (run.sessionId === sessionId)
129
+ return true;
130
+ }
131
+ return false;
132
+ }
105
133
  on(typeOrListener, maybeListener) {
106
134
  if (typeof typeOrListener === 'function') {
107
135
  this.listeners.add(typeOrListener);
@@ -134,6 +162,7 @@ export class AgentRuntime {
134
162
  async dispatch(trigger, options) {
135
163
  if (!this.started) {
136
164
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
165
+ triggerRef: toTriggerRef(trigger),
137
166
  triggerId: trigger.id,
138
167
  reason: 'runtime_stopped',
139
168
  });
@@ -148,13 +177,26 @@ export class AgentRuntime {
148
177
  const targets = await this.router.resolve(trigger, this.agents);
149
178
  if (targets.length === 0) {
150
179
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
180
+ triggerRef: toTriggerRef(trigger),
151
181
  triggerId: trigger.id,
152
182
  reason: 'no_agent',
153
183
  });
154
184
  return { status: 'skipped', reason: 'no_agent' };
155
185
  }
156
186
  if (targets.length === 1) {
157
- return this.dispatchToTarget(trigger, targets[0], options);
187
+ const result = await this.dispatchToTarget(trigger, targets[0], options);
188
+ // 单目标丢弃也必须留下 TRIGGER_DROPPED(与 fan-out 对称):
189
+ // 「trigger 未被受理必有 dropped 事件」是委派送达回执(delegation §7.1)
190
+ // 依赖的不变量,缺事件 = 送达回执无法证伪。受理后 run 失败走 RUN_FAILED
191
+ // (消息可能已进父上下文,按已送达处理,不回执)
192
+ if (result.status === 'skipped') {
193
+ this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
194
+ triggerRef: toTriggerRef(trigger),
195
+ triggerId: trigger.id,
196
+ reason: result.reason,
197
+ });
198
+ }
199
+ return result;
158
200
  }
159
201
  // fan-out:串行;聚合为 FanoutDispatchResult(ran/aborted/failed 均不静默丢弃)
160
202
  const results = [];
@@ -167,6 +209,7 @@ export class AgentRuntime {
167
209
  const allSkipped = results.every((r) => r.result.status === 'skipped');
168
210
  if (anyFailed) {
169
211
  this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
212
+ triggerRef: toTriggerRef(trigger),
170
213
  triggerId: trigger.id,
171
214
  reason: 'fanout_partial_failure',
172
215
  results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
@@ -177,6 +220,12 @@ export class AgentRuntime {
177
220
  const reason = results[0]?.result.status === 'skipped'
178
221
  ? results[0].result.reason
179
222
  : 'no_agent';
223
+ this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
224
+ triggerRef: toTriggerRef(trigger),
225
+ triggerId: trigger.id,
226
+ reason,
227
+ results: results.map((r) => ({ agentId: r.agentId, status: r.result.status })),
228
+ });
180
229
  return { status: 'skipped', reason };
181
230
  }
182
231
  // anyRan(含 mixed ran + aborted/skipped)→ ran + 明细
@@ -219,7 +268,13 @@ export class AgentRuntime {
219
268
  if (!this.started) {
220
269
  return { status: 'skipped', reason: 'runtime_stopped' };
221
270
  }
222
- const request = buildRunRequest(agent, triggers, sessionId);
271
+ // I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
272
+ const isScheduleWake = triggers.some((t) => t.type === 'schedule');
273
+ const request = buildRunRequest(agent, triggers, sessionId, {
274
+ actorType: isScheduleWake ? 'timer' : undefined,
275
+ actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : undefined,
276
+ intent: isScheduleWake ? 'schedule_wake' : undefined,
277
+ });
223
278
  const controller = new AbortController();
224
279
  const run = {
225
280
  requestId: request.requestId,
@@ -272,6 +327,9 @@ export class AgentRuntime {
272
327
  requestId: request.requestId,
273
328
  agentId: agent.agentId,
274
329
  sessionId,
330
+ // 回执关联:已受理的 trigger(run 失败但消息可能已进父上下文,
331
+ // 送达语义视为已送达,订阅方自行判定)
332
+ triggerRefs: request.triggers.map(toTriggerRef),
275
333
  error: message,
276
334
  });
277
335
  return { status: 'failed', error: message };
@@ -6,12 +6,21 @@
6
6
  import type { EventBus } from '@octopi-agent/core/index.js';
7
7
  import type { Trigger, TriggerPayload, TriggerSource } from '../types.js';
8
8
  export declare const AGENT_SIGNAL_EVENT_TYPE = "runtime.agent_signal";
9
+ /**
10
+ * 查询总线上是否有存活的 `AgentSignalSource` 接收端。
11
+ *
12
+ * @param events - 事件总线
13
+ * @returns 有接收端返回 true;投递器应据此拒绝把通知判为已送达
14
+ */
15
+ export declare function hasAgentSignalReceiver(events: EventBus): boolean;
9
16
  export interface AgentSignal {
10
17
  fromAgentId: string;
11
18
  toAgentId: string;
12
19
  sessionId?: string;
13
20
  payload: TriggerPayload;
14
21
  reason?: string;
22
+ /** 委派单 ID(collaboration/delegation);透传到消息 metadata */
23
+ delegationId?: string;
15
24
  }
16
25
  export interface AgentSignalSourceConfig {
17
26
  id?: string;
@@ -23,6 +32,8 @@ export declare class AgentSignalSource implements TriggerSource {
23
32
  readonly type: "agent_signal";
24
33
  private disposables;
25
34
  private running;
35
+ /** 本实例是否已计入 receiverBuses(防未 start 的 stop / 二次 stop 误删兄弟登记) */
36
+ private receiverCounted;
26
37
  constructor(config?: AgentSignalSourceConfig);
27
38
  start(emit: (t: Trigger) => void): Promise<void>;
28
39
  stop(): Promise<void>;