@octopi-agent/engine 0.65.0 → 0.86.38

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 (421) 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 +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  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 +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  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 +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  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 +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  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 +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -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/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  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/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -247,3 +247,117 @@ export const MemoryConfigSchema = z.object({
247
247
  })
248
248
  .optional(),
249
249
  });
250
+ /** Cognition 概念图谱(arch/cognition-graph-formation.md) */
251
+ export const CognitionConfigSchema = z.object({
252
+ enabled: z.boolean().optional(),
253
+ conceptualize: z
254
+ .object({
255
+ onMemoryWrite: z.boolean().optional(),
256
+ onSessionEnd: z.boolean().optional(),
257
+ maxNodesPerProposition: z.number().int().positive().max(20).optional(),
258
+ maxEdgesPerProposition: z.number().int().positive().max(40).optional(),
259
+ })
260
+ .optional(),
261
+ relations: z
262
+ .object({
263
+ requireCue: z.boolean().optional(),
264
+ causesMinIndependentMemories: z.number().int().positive().min(1).max(10).optional(),
265
+ allowCooccurEscalation: z.literal(false).optional(),
266
+ })
267
+ .optional(),
268
+ identity: z
269
+ .object({
270
+ mergeThreshold: z.number().min(0).max(1).optional(),
271
+ candidateBandLo: z.number().min(0).max(1).optional(),
272
+ candidateBandHi: z.number().min(0).max(1).optional(),
273
+ })
274
+ .optional(),
275
+ plasticity: z
276
+ .object({
277
+ eta: z.number().gt(0).lt(1).optional(),
278
+ deltaRetrieval: z.number().gt(0).lt(1).optional(),
279
+ decayPerDay: z
280
+ .object({
281
+ related: z.number().min(0).lt(1).optional(),
282
+ causes: z.number().min(0).lt(1).optional(),
283
+ part_of: z.number().min(0).lt(1).optional(),
284
+ opposes: z.number().min(0).lt(1).optional(),
285
+ similar_to: z.number().min(0).lt(1).optional(),
286
+ evolves_to: z.number().min(0).lt(1).optional(),
287
+ })
288
+ .optional(),
289
+ })
290
+ .optional(),
291
+ consolidation: z
292
+ .object({
293
+ debounceMinutes: z.number().int().nonnegative().optional(),
294
+ ttlHours: z.number().int().positive().optional(),
295
+ })
296
+ .optional(),
297
+ capacity: z
298
+ .object({
299
+ warnNodes: z.number().int().positive().optional(),
300
+ warnEdges: z.number().int().positive().optional(),
301
+ stopNodes: z.number().int().positive().optional(),
302
+ stopEdges: z.number().int().positive().optional(),
303
+ })
304
+ .optional(),
305
+ retrieval: z
306
+ .object({
307
+ depth: z.number().int().positive().max(5).optional(),
308
+ delta: z.number().gt(0).lt(1).optional(),
309
+ tau: z.number().min(0).max(1).optional(),
310
+ limit: z.number().int().positive().max(100).optional(),
311
+ })
312
+ .optional(),
313
+ });
314
+ /** Wisdom 判断范式(arch/wisdom-layer-formation.md) */
315
+ export const WisdomConfigSchema = z.object({
316
+ enabled: z.boolean().optional(),
317
+ capacity: z
318
+ .object({
319
+ /** 存活面软顶(govern 淘汰);默认 50 */
320
+ softCap: z.number().int().positive().optional(),
321
+ /** admit 硬顶;默认 80 */
322
+ hardCap: z.number().int().positive().optional(),
323
+ })
324
+ .optional(),
325
+ formation: z
326
+ .object({
327
+ enabled: z.boolean().optional(),
328
+ dryRun: z.boolean().optional(),
329
+ ttlHours: z.number().int().positive().optional(),
330
+ minMemorySupport: z.number().int().positive().min(1).max(10).optional(),
331
+ minClusterSize: z.number().int().positive().min(2).max(50).optional(),
332
+ minPromotionStack: z.number().int().positive().min(1).max(20).optional(),
333
+ maxItemsPerRun: z.number().int().positive().max(10).optional(),
334
+ maxEvidenceChars: z.number().int().positive().optional(),
335
+ })
336
+ .optional(),
337
+ evaluation: z
338
+ .object({
339
+ dryRun: z.boolean().optional(),
340
+ windowHours: z.number().int().positive().optional(),
341
+ minAppliesForActive: z.number().int().positive().optional(),
342
+ contestRate: z.number().min(0).max(1).optional(),
343
+ counterevidenceWeight: z.number().positive().optional(),
344
+ strengthenMinApplies: z.number().int().positive().optional(),
345
+ })
346
+ .optional(),
347
+ injection: z
348
+ .object({
349
+ coreMaxItems: z.number().int().positive().max(32).optional(),
350
+ coreMaxTokens: z.number().int().positive().optional(),
351
+ scenarioMaxItems: z.number().int().positive().max(32).optional(),
352
+ trialVisible: z.boolean().optional(),
353
+ })
354
+ .optional(),
355
+ govern: z
356
+ .object({
357
+ dryRun: z.boolean().optional(),
358
+ zeroApplyIdleMs: z.number().int().positive().optional(),
359
+ priorityDecayStep: z.number().int().positive().optional(),
360
+ priorityFloor: z.number().int().nonnegative().optional(),
361
+ })
362
+ .optional(),
363
+ });
@@ -5,7 +5,7 @@
5
5
  */
6
6
  import { z } from 'zod';
7
7
  export declare const SubsystemsConfigSchema: z.ZodObject<{
8
- auditDir: z.ZodOptional<z.ZodString>;
8
+ auditDir: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
9
9
  allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
10
10
  denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
11
11
  }, z.core.$strip>;
@@ -5,7 +5,8 @@
5
5
  */
6
6
  import { z } from 'zod';
7
7
  export const SubsystemsConfigSchema = z.object({
8
- auditDir: z.string().optional(),
8
+ /** 审计目录;缺省 `<OCTOPI_HOME>/audit`,`false` 显式关闭 */
9
+ auditDir: z.union([z.string().min(1), z.literal(false)]).optional(),
9
10
  /** 允许注册:子系统 id / packageId / `memory.steward.*` 前缀 */
10
11
  allowlist: z.array(z.string().min(1)).optional(),
11
12
  /** 禁止注册(deny 优先) */
package/dist/config.d.ts CHANGED
@@ -22,6 +22,8 @@ export interface AgentConfig {
22
22
  home?: string;
23
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) */
@@ -773,6 +881,77 @@ export interface HarnessConfig {
773
881
  maxLength?: Partial<Record<'fact' | 'method' | 'norm', number>>;
774
882
  };
775
883
  };
884
+ /** Cognition 概念图谱(arch/cognition-graph-formation.md) */
885
+ cognition?: {
886
+ enabled?: boolean;
887
+ conceptualize?: {
888
+ onMemoryWrite?: boolean;
889
+ maxNodesPerProposition?: number;
890
+ maxEdgesPerProposition?: number;
891
+ };
892
+ relations?: {
893
+ requireCue?: boolean;
894
+ causesMinIndependentMemories?: number;
895
+ };
896
+ identity?: {
897
+ mergeThreshold?: number;
898
+ candidateBandHi?: number;
899
+ };
900
+ capacity?: {
901
+ warnNodes?: number;
902
+ warnEdges?: number;
903
+ stopNodes?: number;
904
+ stopEdges?: number;
905
+ };
906
+ retrieval?: {
907
+ depth?: number;
908
+ delta?: number;
909
+ tau?: number;
910
+ limit?: number;
911
+ };
912
+ consolidation?: {
913
+ debounceMinutes?: number;
914
+ ttlHours?: number;
915
+ };
916
+ };
917
+ /** Wisdom 判断范式(arch/wisdom-layer-formation.md) */
918
+ wisdom?: {
919
+ enabled?: boolean;
920
+ capacity?: {
921
+ softCap?: number;
922
+ hardCap?: number;
923
+ };
924
+ formation?: {
925
+ enabled?: boolean;
926
+ dryRun?: boolean;
927
+ ttlHours?: number;
928
+ minMemorySupport?: number;
929
+ minClusterSize?: number;
930
+ minPromotionStack?: number;
931
+ maxItemsPerRun?: number;
932
+ maxEvidenceChars?: number;
933
+ };
934
+ evaluation?: {
935
+ dryRun?: boolean;
936
+ windowHours?: number;
937
+ minAppliesForActive?: number;
938
+ contestRate?: number;
939
+ counterevidenceWeight?: number;
940
+ strengthenMinApplies?: number;
941
+ };
942
+ injection?: {
943
+ coreMaxItems?: number;
944
+ coreMaxTokens?: number;
945
+ scenarioMaxItems?: number;
946
+ trialVisible?: boolean;
947
+ };
948
+ govern?: {
949
+ dryRun?: boolean;
950
+ zeroApplyIdleMs?: number;
951
+ priorityDecayStep?: number;
952
+ priorityFloor?: number;
953
+ };
954
+ };
776
955
  /** Knowledge 检索/召回(全局缺省;agents[].knowledge.recall 可覆盖) */
777
956
  knowledge?: KnowledgeRuntimeConfig;
778
957
  /**
@@ -780,6 +959,13 @@ export interface HarnessConfig {
780
959
  *
781
960
  * 硬边界与 ToolCallRiskPolicy 始终执行;此处只调处置/范围/灵敏度。
782
961
  */
962
+ /**
963
+ * 命名凭证库策略(SEC-3c)
964
+ * 默认:有绑定则强制;无绑定可解析。requireBindings=true 时无绑定即拒。
965
+ */
966
+ credentials?: {
967
+ requireBindings?: boolean;
968
+ };
783
969
  security?: {
784
970
  /**
785
971
  * 风险命中后的处置(硬边界不受影响)
@@ -789,6 +975,14 @@ export interface HarnessConfig {
789
975
  enforce?: 'block' | 'audit';
790
976
  /** 注入检测灵敏度 */
791
977
  injectionSensitivity?: 'low' | 'medium' | 'high';
978
+ /**
979
+ * 工具/引擎出站网络门禁(http_request、Knowledge 默认)
980
+ * 默认拒私网/环回/metadata;内网目标需显式 allowPrivateNetwork
981
+ */
982
+ network?: {
983
+ /** 显式放行私网/环回(lab/内网);metadata/链路本地始终拒绝 */
984
+ allowPrivateNetwork?: boolean;
985
+ };
792
986
  /** 绝对路径额外允许范围 */
793
987
  allowedPaths?: string[];
794
988
  };
@@ -804,12 +998,24 @@ export interface HarnessConfig {
804
998
  * - `session-lock`:共享路径;同 sessionId 由 Runner 锁串行(不路径隔离)
805
999
  */
806
1000
  toolIsolation?: 'none' | 'session-subdir' | 'session-lock';
1001
+ /** ToolEffectPolicy 运行模式(P3) */
1002
+ effectPolicy?: import('./harness/extension/execution-environment/effect-policy.js').EffectPolicyConfig;
807
1003
  /**
808
1004
  * Session ACL 角色目录(E6)
809
1005
  *
810
1006
  * 缺省使用内置五角色;可覆盖/新增。handoff 默认仅宿主。
811
1007
  */
812
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
+ };
813
1019
  /** 并发控制配置 */
814
1020
  concurrency?: {
815
1021
  /** 多 Key Provider 负载均衡池 */
@@ -879,6 +1085,17 @@ export interface HarnessConfig {
879
1085
  captureStreamDeltas?: boolean;
880
1086
  /** 是否记录完整模型请求 */
881
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;
882
1099
  };
883
1100
  }
884
1101
  /**
@@ -904,10 +1121,35 @@ export interface NormalizedModelInfo {
904
1121
  contextWindow?: number;
905
1122
  maxTokens?: number;
906
1123
  }
1124
+ /**
1125
+ * 包一层计时探针:llm_start / llm_first_token(TTFT)/ llm_end
1126
+ *
1127
+ * @param inner - 真实 provider
1128
+ * @returns 透传装饰器
1129
+ */
1130
+ export declare function withTimingProbe(inner: ModelProvider): ModelProvider;
1131
+ /**
1132
+ * 按 `observability.llmRequestDump` 配置构造 wire dump sink
1133
+ *
1134
+ * 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
1135
+ * `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
1136
+ * provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
1137
+ *
1138
+ * @param cfg - `observability.llmRequestDump` 配置段
1139
+ * @returns sink;未启用时 undefined
1140
+ */
1141
+ export declare function createWireDumpSinkFromConfig(cfg?: import('./integration/providers/wire-dump.js').WireDumpConfig): Promise<import('./integration/providers/wire-dump.js').WireDumpSink | undefined>;
907
1142
  /**
908
1143
  * 从 ModelProviderConfig 创建 ModelProvider 实例
909
1144
  *
910
1145
  * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
911
1146
  * 使用动态 import 以支持 ESM。
1147
+ *
1148
+ * @param name - provider 名称
1149
+ * @param pc - provider 配置
1150
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
1151
+ * @returns provider 实例(计时探针 → wire dump → 原生 provider 的装饰链)
912
1152
  */
913
- export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig): Promise<ModelProvider>;
1153
+ export declare function createProviderFromConfig(name: string, pc: ModelProviderConfig, options?: {
1154
+ wireDump?: import('./integration/providers/wire-dump.js').WireDumpSink;
1155
+ }): Promise<ModelProvider>;
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,129 @@ function resolveFallbackModels(fallbacks, models, defaults, depth = 0) {
142
143
  });
143
144
  }
144
145
  // ── Provider 工厂 ──
146
+ // [timing probe] 长 session 首 run 延迟定位:LLM 调用计时装饰器(诊断后移除或转正)
147
+ /**
148
+ * 估算请求规模(字符近似值,仅用于计时日志)
149
+ *
150
+ * @param request - LLM 请求
151
+ * @returns msgs/chars/toolChars 计数串
152
+ */
153
+ function timingReqSize(request) {
154
+ let chars = 0;
155
+ for (const m of request.messages ?? []) {
156
+ const c = m.content;
157
+ chars += typeof c === 'string' ? c.length : JSON.stringify(c ?? '').length;
158
+ }
159
+ const toolChars = request.tools ? JSON.stringify(request.tools).length : 0;
160
+ return `msgs=${request.messages?.length ?? 0} chars=${chars} toolChars=${toolChars}`;
161
+ }
162
+ /**
163
+ * 包一层计时探针:llm_start / llm_first_token(TTFT)/ llm_end
164
+ *
165
+ * @param inner - 真实 provider
166
+ * @returns 透传装饰器
167
+ */
168
+ // [timing probe] 临时导出供 CLI daemon 的第二处 provider 工厂复用(诊断后随探针一起收)
169
+ export function withTimingProbe(inner) {
170
+ return {
171
+ name: inner.name,
172
+ defaultModel: inner.defaultModel,
173
+ models: inner.models,
174
+ isAvailable: () => inner.isAvailable(),
175
+ getModelInfo: (modelName) => inner.getModelInfo(modelName),
176
+ getModelInfos: () => inner.getModelInfos(),
177
+ chat: async (request) => {
178
+ const t0 = Date.now();
179
+ console.log(`[timing] stage=llm_start ms=${t0} provider=${inner.name} mode=chat model=${request.model ?? inner.defaultModel ?? '?'} ${timingReqSize(request)}`);
180
+ try {
181
+ const res = await inner.chat(request);
182
+ console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=chat outcome=ok finish=${res.finishReason ?? '?'} outChars=${(res.content ?? '').length}`);
183
+ return res;
184
+ }
185
+ catch (err) {
186
+ console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=chat outcome=error`);
187
+ throw err;
188
+ }
189
+ },
190
+ stream: async function* (request) {
191
+ const t0 = Date.now();
192
+ const model = request.model ?? inner.defaultModel ?? '?';
193
+ console.log(`[timing] stage=llm_start ms=${t0} provider=${inner.name} mode=stream model=${model} ${timingReqSize(request)}`);
194
+ let first = true;
195
+ let outcome = 'abandoned';
196
+ try {
197
+ for await (const chunk of inner.stream(request)) {
198
+ if (first) {
199
+ first = false;
200
+ console.log(`[timing] stage=llm_first_token ms=${Date.now()} ttft=${Date.now() - t0} provider=${inner.name} model=${model}`);
201
+ }
202
+ yield chunk;
203
+ }
204
+ outcome = 'ok';
205
+ }
206
+ catch (err) {
207
+ outcome = 'error';
208
+ throw err;
209
+ }
210
+ finally {
211
+ console.log(`[timing] stage=llm_end ms=${Date.now()} dur=${Date.now() - t0} provider=${inner.name} mode=stream outcome=${outcome}`);
212
+ }
213
+ },
214
+ };
215
+ }
216
+ /**
217
+ * 按 `observability.llmRequestDump` 配置构造 wire dump sink
218
+ *
219
+ * 放在组合根(本文件)而非 Harness:Harness 不得依赖 Integration(层规则)。
220
+ * `octopi serve`(CLI daemon)与库嵌入(config-bridge)共用本函数,避免两套接线漂移。
221
+ * provider 被跨 session 复用,身份只能在调用瞬间从 RunScope 取。
222
+ *
223
+ * @param cfg - `observability.llmRequestDump` 配置段
224
+ * @returns sink;未启用时 undefined
225
+ */
226
+ export async function createWireDumpSinkFromConfig(cfg) {
227
+ if (!cfg?.enabled)
228
+ return undefined;
229
+ // 与 withWireDump 一致按需加载:dump 未启用时 fs/crypto 不进常规 provider 创建路径
230
+ const { createWireDumpSink } = await import('./integration/providers/wire-dump.js');
231
+ return createWireDumpSink({
232
+ dir: cfg.dir,
233
+ maxCallsPerSession: cfg.maxCallsPerSession,
234
+ maxBodyBytes: cfg.maxBodyBytes,
235
+ resolveContext: () => {
236
+ const scope = getRunScope();
237
+ return scope
238
+ ? { sessionId: scope.sessionId, agentId: scope.agentId, runId: scope.runId }
239
+ : undefined;
240
+ },
241
+ });
242
+ }
145
243
  /**
146
244
  * 从 ModelProviderConfig 创建 ModelProvider 实例
147
245
  *
148
246
  * 根据 type 字段自动选择 OpenAI 或 Anthropic provider。
149
247
  * 使用动态 import 以支持 ESM。
248
+ *
249
+ * @param name - provider 名称
250
+ * @param pc - provider 配置
251
+ * @param options - 可选:wire dump sink(诊断用,见 `observability.llmRequestDump`)
252
+ * @returns provider 实例(计时探针 → wire dump → 原生 provider 的装饰链)
150
253
  */
151
- export async function createProviderFromConfig(name, pc) {
254
+ export async function createProviderFromConfig(name, pc, options) {
152
255
  const apiType = pc.api === 'anthropic-messages' ? 'anthropic' : 'openai';
153
256
  const models = pc.models.map(m => ({ name: m.name ?? m.id, contextWindow: m.contextWindow, maxOutputTokens: m.maxTokens }));
154
257
  const defaultModel = pc.models[0]?.name ?? pc.models[0]?.id;
258
+ let decorate = withTimingProbe;
259
+ if (options?.wireDump) {
260
+ // 仅诊断路径才加载 wire dump(fs/crypto 不进入常规 provider 创建)
261
+ const { withWireDump } = await import('./integration/providers/wire-dump.js');
262
+ const sink = options.wireDump;
263
+ decorate = (inner) => withTimingProbe(withWireDump(inner, sink));
264
+ }
155
265
  if (apiType === 'anthropic') {
156
266
  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 });
267
+ return decorate(new AnthropicProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
158
268
  }
159
269
  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 });
270
+ return decorate(new OpenAIProvider({ name, apiKey: pc.apiKey, baseUrl: pc.baseUrl, models, defaultModel, timeoutMs: pc.timeoutSeconds ? pc.timeoutSeconds * 1000 : undefined }));
161
271
  }
@@ -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)`:全部事件