@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
@@ -6,10 +6,10 @@
6
6
  import { z } from 'zod';
7
7
  import { AgentConfigSchema, ChannelConfigSchema, PluginConfigSchema } from './agent.js';
8
8
  import { ModelsConfigSchema } from './models.js';
9
- import { AgentRuntimeJsonConfigSchema, BudgetPolicyJsonConfigSchema, ConcurrencyConfigSchema, RunGuardJsonConfigSchema, } from './run.js';
9
+ import { AgentRuntimeJsonConfigSchema, BudgetPolicyJsonConfigSchema, ConcurrencyConfigSchema, ModelCallConfigSchema, RunGuardJsonConfigSchema, SchedulesJsonConfigSchema, } from './run.js';
10
10
  import { CompactCapabilityConfigSchema, ConstitutionConfigSchema, ContextAssemblerConfigSchema, ContextEngineConfigSchema, DocumentsConfigSchema, SummaryConfigSchema, } from './context.js';
11
11
  import { CognitionConfigSchema, KnowledgeConfigSchema, MemoryConfigSchema, WisdomConfigSchema, } from './substrate.js';
12
- import { SecurityConfigSchema, SessionAclConfigSchema, SessionConfigSchema, ToolIsolationConfigSchema, } from './governance.js';
12
+ import { FileSendConfigSchema, CredentialsConfigSchema, SecurityConfigSchema, SessionAclConfigSchema, SessionConfigSchema, ToolIsolationConfigSchema, EffectPolicyConfigSchema, } from './governance.js';
13
13
  import { ObservabilityConfigSchema, ObserverConfigSchema } from './observability.js';
14
14
  import { WebSearchConfigSchema } from './web-search.js';
15
15
  import { SubsystemsConfigSchema } from './subsystems.js';
@@ -24,7 +24,9 @@ export const engineConfigSchema = z.object({
24
24
  plugins: PluginConfigSchema.optional(),
25
25
  budgetPolicy: BudgetPolicyJsonConfigSchema.optional(),
26
26
  runGuard: RunGuardJsonConfigSchema.optional(),
27
+ modelCall: ModelCallConfigSchema.optional(),
27
28
  agentRuntime: AgentRuntimeJsonConfigSchema.optional(),
29
+ schedules: SchedulesJsonConfigSchema.optional(),
28
30
  contextEngine: ContextEngineConfigSchema.optional(),
29
31
  contextAssembler: ContextAssemblerConfigSchema.optional(),
30
32
  /** 公用能力 summary(capabilities) */
@@ -47,14 +49,41 @@ export const engineConfigSchema = z.object({
47
49
  /** Wisdom 判断范式(maxim) */
48
50
  wisdom: WisdomConfigSchema.optional(),
49
51
  security: SecurityConfigSchema.optional(),
52
+ /** Named credential vault policy (SEC-3c requireBindings) */
53
+ credentials: CredentialsConfigSchema.optional(),
50
54
  channels: z.array(ChannelConfigSchema).optional(),
51
55
  session: SessionConfigSchema.optional(),
52
56
  /** 工具效应隔离策略(宪法 I5);默认 none */
53
57
  toolIsolation: ToolIsolationConfigSchema.optional(),
58
+ effectPolicy: EffectPolicyConfigSchema.optional(),
54
59
  /** Session ACL 角色目录(E6);缺省 = 内置五角色 */
55
60
  sessionAcl: SessionAclConfigSchema.optional(),
61
+ /** send_file 外发限额(单文件大小 / 会话 release 次数) */
62
+ fileSend: FileSendConfigSchema.optional(),
56
63
  observability: ObservabilityConfigSchema.optional(),
57
64
  observer: ObserverConfigSchema,
58
65
  concurrency: ConcurrencyConfigSchema.optional(),
59
66
  webSearch: WebSearchConfigSchema.optional(),
67
+ /**
68
+ * 委派编排(`arch/delegation.md` §8)。
69
+ *
70
+ * `maxActiveDelegationsPerSession` 是**失控防护**,不是并发闸:
71
+ * 全局并发硬闸只在 SessionGate 一处(D9)。
72
+ */
73
+ delegation: z
74
+ .object({
75
+ /**
76
+ * 单个父 session 可同时挂载的未闭合委派上限。
77
+ *
78
+ * **失控防护**,不是并发闸(D9:并发硬闸只在 SessionGate 一处)。
79
+ * 默认 8 —— 委派已默认开启,必须有上限。
80
+ */
81
+ maxActiveDelegationsPerSession: z
82
+ .number()
83
+ .positive()
84
+ .optional()
85
+ .describe('Runaway guard: max un-closed delegations a parent session may hold at once. ' +
86
+ 'Default 8. Not a concurrency gate — hard concurrency stays in SessionGate only.'),
87
+ })
88
+ .optional(),
60
89
  });
@@ -16,6 +16,18 @@ export declare const SecurityConfigSchema: z.ZodObject<{
16
16
  high: "high";
17
17
  }>>;
18
18
  allowedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
+ network: z.ZodOptional<z.ZodObject<{
20
+ allowPrivateNetwork: z.ZodOptional<z.ZodBoolean>;
21
+ }, z.core.$strip>>;
22
+ }, z.core.$strip>;
23
+ /**
24
+ * `credentials` — named credential vault policy (SEC-3c).
25
+ *
26
+ * Default: non-empty `credential_bindings` are enforced; empty bindings resolve freely.
27
+ * `requireBindings: true` (or untrusted effect mode) rejects unbound credentials.
28
+ */
29
+ export declare const CredentialsConfigSchema: z.ZodObject<{
30
+ requireBindings: z.ZodOptional<z.ZodBoolean>;
19
31
  }, z.core.$strip>;
20
32
  export declare const SessionConfigSchema: z.ZodObject<{
21
33
  dmScope: z.ZodOptional<z.ZodEnum<{
@@ -23,6 +35,7 @@ export declare const SessionConfigSchema: z.ZodObject<{
23
35
  "per-peer": "per-peer";
24
36
  "per-channel-peer": "per-channel-peer";
25
37
  }>>;
38
+ idleExpiryMs: z.ZodOptional<z.ZodNumber>;
26
39
  }, z.core.$loose>;
27
40
  /**
28
41
  * `toolIsolation` — 工具效应面策略
@@ -31,11 +44,83 @@ export declare const SessionConfigSchema: z.ZodObject<{
31
44
  * - `session-subdir`:cwd = join(agent.workspace | RunConfig.cwd, sessionId)
32
45
  * - `session-lock`:共享路径;并发安全依赖 Runner 的 sessionId 锁(不路径隔离)
33
46
  */
47
+ /**
48
+ * `effectPolicy` — ToolEffectPolicy 运行模式(P3)
49
+ *
50
+ * 命名预设展开正交旋钮;agents[].effectPolicy 优先于顶层。
51
+ * 注意:与 `agents[].tools`(工具 allow/deny)无关。
52
+ * **省略 `mode` = engine 缺省 workspace(secure-by-default)**;
53
+ * 评估/本机全能力请在配置里显式 `"mode": "host"`(init / example 即如此)。
54
+ */
55
+ export declare const EffectPolicyConfigSchema: z.ZodObject<{
56
+ mode: z.ZodOptional<z.ZodEnum<{
57
+ host: "host";
58
+ workspace: "workspace";
59
+ project: "project";
60
+ untrusted: "untrusted";
61
+ }>>;
62
+ untrustedAdmission: z.ZodOptional<z.ZodEnum<{
63
+ refuse: "refuse";
64
+ degrade: "degrade";
65
+ }>>;
66
+ transactionRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
67
+ pathContainment: z.ZodOptional<z.ZodEnum<{
68
+ none: "none";
69
+ strict: "strict";
70
+ soft: "soft";
71
+ }>>;
72
+ shellEscape: z.ZodOptional<z.ZodEnum<{
73
+ deny: "deny";
74
+ confirm: "confirm";
75
+ allow: "allow";
76
+ }>>;
77
+ processLimits: z.ZodOptional<z.ZodBoolean>;
78
+ commit: z.ZodOptional<z.ZodEnum<{
79
+ auto: "auto";
80
+ manual: "manual";
81
+ }>>;
82
+ onClose: z.ZodOptional<z.ZodEnum<{
83
+ commit: "commit";
84
+ discard: "discard";
85
+ }>>;
86
+ effects: z.ZodOptional<z.ZodEnum<{
87
+ engine: "engine";
88
+ "host-gate": "host-gate";
89
+ }>>;
90
+ toolIsolation: z.ZodOptional<z.ZodEnum<{
91
+ none: "none";
92
+ "session-subdir": "session-subdir";
93
+ "session-lock": "session-lock";
94
+ }>>;
95
+ undoLimit: z.ZodOptional<z.ZodObject<{
96
+ maxEntries: z.ZodOptional<z.ZodNumber>;
97
+ maxBlobBytes: z.ZodOptional<z.ZodNumber>;
98
+ }, z.core.$strip>>;
99
+ shellJournal: z.ZodOptional<z.ZodEnum<{
100
+ snapshot: "snapshot";
101
+ off: "off";
102
+ }>>;
103
+ shellJournalLimit: z.ZodOptional<z.ZodObject<{
104
+ maxFiles: z.ZodOptional<z.ZodNumber>;
105
+ maxBytes: z.ZodOptional<z.ZodNumber>;
106
+ maxFileSize: z.ZodOptional<z.ZodNumber>;
107
+ }, z.core.$strip>>;
108
+ }, z.core.$strip>;
34
109
  export declare const ToolIsolationConfigSchema: z.ZodEnum<{
35
110
  none: "none";
36
111
  "session-subdir": "session-subdir";
37
112
  "session-lock": "session-lock";
38
113
  }>;
114
+ /**
115
+ * `fileSend` — send_file 外发限额
116
+ *
117
+ * - `maxBytes`:单文件上限(字节);缺省 **2GB**
118
+ * - `maxReleasesPerSession`:每会话 release 次数上限;缺省 / `0` = **不限**
119
+ */
120
+ export declare const FileSendConfigSchema: z.ZodObject<{
121
+ maxBytes: z.ZodOptional<z.ZodNumber>;
122
+ maxReleasesPerSession: z.ZodOptional<z.ZodNumber>;
123
+ }, z.core.$strip>;
39
124
  /**
40
125
  * `sessionAcl` — 角色目录与切换缺省
41
126
  *
@@ -57,6 +142,11 @@ export declare const SessionAclConfigSchema: z.ZodObject<{
57
142
  writeMemory: z.ZodBoolean;
58
143
  canManageTasks: z.ZodBoolean;
59
144
  canHandoff: z.ZodBoolean;
145
+ toolRights: z.ZodDefault<z.ZodObject<{
146
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
147
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
148
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
149
+ }, z.core.$strip>>;
60
150
  }, z.core.$strip>;
61
151
  max: z.ZodOptional<z.ZodObject<{
62
152
  canRun: z.ZodBoolean;
@@ -69,6 +159,11 @@ export declare const SessionAclConfigSchema: z.ZodObject<{
69
159
  writeMemory: z.ZodBoolean;
70
160
  canManageTasks: z.ZodBoolean;
71
161
  canHandoff: z.ZodBoolean;
162
+ toolRights: z.ZodDefault<z.ZodObject<{
163
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
164
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
165
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
166
+ }, z.core.$strip>>;
72
167
  }, z.core.$strip>>;
73
168
  }, z.core.$strip>>>;
74
169
  switchDefaults: z.ZodOptional<z.ZodObject<{
@@ -4,14 +4,35 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
- import { SessionRightsSchema } from './shared.js';
7
+ import { ConfigPathSchema, SessionRightsSchema } from './shared.js';
8
8
  export const SecurityConfigSchema = z.object({
9
9
  enforce: z.enum(['block', 'audit']).optional(),
10
10
  injectionSensitivity: z.enum(['low', 'medium', 'high']).optional(),
11
11
  allowedPaths: z.array(z.string()).optional(),
12
+ /**
13
+ * Tool/engine egress network guard (http_request, Knowledge default).
14
+ * Default rejects private/loopback/link-local/metadata (SSRF).
15
+ */
16
+ network: z
17
+ .object({
18
+ /** Explicitly allow private/loopback targets (lab / intranet). */
19
+ allowPrivateNetwork: z.boolean().optional(),
20
+ })
21
+ .optional(),
22
+ });
23
+ /**
24
+ * `credentials` — named credential vault policy (SEC-3c).
25
+ *
26
+ * Default: non-empty `credential_bindings` are enforced; empty bindings resolve freely.
27
+ * `requireBindings: true` (or untrusted effect mode) rejects unbound credentials.
28
+ */
29
+ export const CredentialsConfigSchema = z.object({
30
+ requireBindings: z.boolean().optional(),
12
31
  });
13
32
  export const SessionConfigSchema = z.object({
14
33
  dmScope: z.enum(['main', 'per-peer', 'per-channel-peer']).optional(),
34
+ /** 上下文租约(毫秒)。显式配置才生效;缺省不截断 LLM 窗口 */
35
+ idleExpiryMs: z.number().int().positive().optional(),
15
36
  }).passthrough();
16
37
  /**
17
38
  * `toolIsolation` — 工具效应面策略
@@ -20,13 +41,84 @@ export const SessionConfigSchema = z.object({
20
41
  * - `session-subdir`:cwd = join(agent.workspace | RunConfig.cwd, sessionId)
21
42
  * - `session-lock`:共享路径;并发安全依赖 Runner 的 sessionId 锁(不路径隔离)
22
43
  */
44
+ /**
45
+ * `effectPolicy` — ToolEffectPolicy 运行模式(P3)
46
+ *
47
+ * 命名预设展开正交旋钮;agents[].effectPolicy 优先于顶层。
48
+ * 注意:与 `agents[].tools`(工具 allow/deny)无关。
49
+ * **省略 `mode` = engine 缺省 workspace(secure-by-default)**;
50
+ * 评估/本机全能力请在配置里显式 `"mode": "host"`(init / example 即如此)。
51
+ */
52
+ export const EffectPolicyConfigSchema = z.object({
53
+ mode: z.enum(['workspace', 'project', 'host', 'untrusted']).optional(),
54
+ /**
55
+ * untrusted 无 L4 process jail 时:refuse(缺省)拒绝运行;
56
+ * degrade 降 effectiveMode + toolSurface=reduced + securityDegraded。
57
+ */
58
+ untrustedAdmission: z.enum(['refuse', 'degrade']).optional(),
59
+ /** 额外事务 root(绝对路径或 ~ 形态);并入 allowRoots */
60
+ transactionRoots: z.array(ConfigPathSchema).optional(),
61
+ pathContainment: z.enum(['strict', 'soft', 'none']).optional(),
62
+ shellEscape: z.enum(['deny', 'confirm', 'allow']).optional(),
63
+ processLimits: z.boolean().optional(),
64
+ commit: z.enum(['auto', 'manual']).optional(),
65
+ /** commit=manual 时,会话关闭/删除:commit=保留效应,discard=逆放 */
66
+ onClose: z.enum(['commit', 'discard']).optional(),
67
+ effects: z.enum(['engine', 'host-gate']).optional(),
68
+ toolIsolation: z.enum(['none', 'session-subdir', 'session-lock']).optional(),
69
+ /** undo 配额;缺省不限 */
70
+ undoLimit: z
71
+ .object({
72
+ /** 0 = 不限 */
73
+ maxEntries: z.number().int().nonnegative().optional(),
74
+ /** 0 = 不限 */
75
+ maxBlobBytes: z.number().int().nonnegative().optional(),
76
+ })
77
+ .optional(),
78
+ /** shell 记账深度 */
79
+ shellJournal: z.enum(['snapshot', 'off']).optional(),
80
+ shellJournalLimit: z
81
+ .object({
82
+ /** 0 = 不限 */
83
+ maxFiles: z.number().int().nonnegative().optional(),
84
+ /** 0 = 不限 */
85
+ maxBytes: z.number().int().nonnegative().optional(),
86
+ /** 0 = 不限 */
87
+ maxFileSize: z.number().int().nonnegative().optional(),
88
+ })
89
+ .optional(),
90
+ });
23
91
  export const ToolIsolationConfigSchema = z.enum(['none', 'session-subdir', 'session-lock']);
92
+ /**
93
+ * `fileSend` — send_file 外发限额
94
+ *
95
+ * - `maxBytes`:单文件上限(字节);缺省 **2GB**
96
+ * - `maxReleasesPerSession`:每会话 release 次数上限;缺省 / `0` = **不限**
97
+ */
98
+ export const FileSendConfigSchema = z.object({
99
+ maxBytes: z.number().int().positive().optional(),
100
+ maxReleasesPerSession: z.number().int().nonnegative().optional(),
101
+ });
102
+ const ToolRightsShape = z.object({
103
+ /** allowlist;缺省 = 名字不限(仍受 deny 约束)。`'*'` = 全放行 */
104
+ allow: z.array(z.string().min(1)).optional(),
105
+ /** 工具名黑名单;`'*'` = 全拒绝 */
106
+ deny: z.array(z.string().min(1)).optional(),
107
+ /** 能力标签黑名单(D5-a) */
108
+ denyCapabilities: z.array(z.string().min(1)).optional(),
109
+ });
110
+ /**
111
+ * Role defaults/max rights. `toolRights` is always present after parse
112
+ * (omitted config → unrestricted empty bag) so TS `EffectiveSessionRights`
113
+ * matches without casts.
114
+ */
24
115
  const SessionEffectiveRightsSchema = z.object({
25
116
  canRun: z.boolean(),
26
117
  readScope: z.enum(['full', 'from_grant', 'summary_tail', 'none']),
27
118
  writeMemory: z.boolean(),
28
119
  canManageTasks: z.boolean(),
29
120
  canHandoff: z.boolean(),
121
+ toolRights: ToolRightsShape.default({ deny: [], denyCapabilities: [] }),
30
122
  });
31
123
  /**
32
124
  * `sessionAcl` — 角色目录与切换缺省
@@ -6,8 +6,8 @@
6
6
  import { z } from 'zod';
7
7
  export declare const ModelsConfigSchema: z.ZodObject<{
8
8
  mode: z.ZodOptional<z.ZodEnum<{
9
- merge: "merge";
10
9
  replace: "replace";
10
+ merge: "merge";
11
11
  }>>;
12
12
  providers: z.ZodRecord<z.ZodString, z.ZodObject<{
13
13
  baseUrl: z.ZodString;
@@ -39,9 +39,9 @@ export declare const ModelsConfigSchema: z.ZodObject<{
39
39
  enabled: z.ZodOptional<z.ZodBoolean>;
40
40
  type: z.ZodOptional<z.ZodEnum<{
41
41
  openai: "openai";
42
+ http: "http";
42
43
  custom: "custom";
43
44
  ollama: "ollama";
44
- http: "http";
45
45
  }>>;
46
46
  provider: z.ZodOptional<z.ZodString>;
47
47
  model: z.ZodString;
@@ -92,9 +92,9 @@ export declare const EmbeddingModelConfigSchemaExport: z.ZodObject<{
92
92
  enabled: z.ZodOptional<z.ZodBoolean>;
93
93
  type: z.ZodOptional<z.ZodEnum<{
94
94
  openai: "openai";
95
+ http: "http";
95
96
  custom: "custom";
96
97
  ollama: "ollama";
97
- http: "http";
98
98
  }>>;
99
99
  provider: z.ZodOptional<z.ZodString>;
100
100
  model: z.ZodString;
@@ -10,6 +10,12 @@ export declare const ObservabilityConfigSchema: z.ZodObject<{
10
10
  traceDir: z.ZodOptional<z.ZodNullable<z.ZodString>>;
11
11
  captureStreamDeltas: z.ZodOptional<z.ZodBoolean>;
12
12
  captureModelRequest: z.ZodOptional<z.ZodBoolean>;
13
+ llmRequestDump: z.ZodOptional<z.ZodObject<{
14
+ enabled: z.ZodOptional<z.ZodBoolean>;
15
+ dir: z.ZodOptional<z.ZodString>;
16
+ maxCallsPerSession: z.ZodOptional<z.ZodNumber>;
17
+ maxBodyBytes: z.ZodOptional<z.ZodNumber>;
18
+ }, z.core.$strip>>;
13
19
  }, z.core.$strip>;
14
20
  /**
15
21
  * 产品 Observer 通道(Run 观测 / Run Observatory)
@@ -10,6 +10,22 @@ export const ObservabilityConfigSchema = z.object({
10
10
  traceDir: z.string().nullable().optional(),
11
11
  captureStreamDeltas: z.boolean().optional(),
12
12
  captureModelRequest: z.boolean().optional(),
13
+ /**
14
+ * LLM wire dump(前缀缓存比对)
15
+ *
16
+ * 默认关闭;开启后每个 LLM 调用落盘完整请求体 + 索引,可用 `octopi llm-diff` 比对。
17
+ */
18
+ llmRequestDump: z
19
+ .object({
20
+ enabled: z.boolean().optional(),
21
+ /** 落盘根目录(缺省 `<OCTOPI_HOME>/logs/llm-requests`) */
22
+ dir: z.string().optional(),
23
+ /** 每 session 保留调用数(环形,缺省 200) */
24
+ maxCallsPerSession: z.number().int().positive().max(5000).optional(),
25
+ /** 单次请求体落盘上限(字节,缺省 8_000_000) */
26
+ maxBodyBytes: z.number().int().positive().optional(),
27
+ })
28
+ .optional(),
13
29
  });
14
30
  /**
15
31
  * 产品 Observer 通道(Run 观测 / Run Observatory)
@@ -47,6 +47,10 @@ export declare const RunGuardJsonConfigSchema: z.ZodObject<{
47
47
  hardLimit: z.ZodOptional<z.ZodNumber>;
48
48
  hardWallClockMs: z.ZodOptional<z.ZodNumber>;
49
49
  }, z.core.$strip>;
50
+ export declare const ModelCallConfigSchema: z.ZodObject<{
51
+ idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
52
+ absoluteTimeoutMs: z.ZodOptional<z.ZodNumber>;
53
+ }, z.core.$strip>;
50
54
  export declare const AgentRuntimeJsonConfigSchema: z.ZodObject<{
51
55
  coalesceWindowMs: z.ZodOptional<z.ZodNumber>;
52
56
  expectedMaxConcurrentRuns: z.ZodOptional<z.ZodNumber>;
@@ -66,6 +70,12 @@ export declare const AgentRuntimeJsonConfigSchema: z.ZodObject<{
66
70
  }, z.core.$strip>>;
67
71
  agentSignal: z.ZodOptional<z.ZodBoolean>;
68
72
  }, z.core.$strip>;
73
+ /** SessionSchedule 预算与兜底(arch/session-schedules.md P1) */
74
+ export declare const SchedulesJsonConfigSchema: z.ZodObject<{
75
+ maxOpenPerSession: z.ZodOptional<z.ZodNumber>;
76
+ maxWakesPerHour: z.ZodOptional<z.ZodNumber>;
77
+ tickIntervalMs: z.ZodOptional<z.ZodNumber>;
78
+ }, z.core.$strip>;
69
79
  export declare const ConcurrencyConfigSchema: z.ZodObject<{
70
80
  providerPool: z.ZodOptional<z.ZodObject<{
71
81
  slots: z.ZodArray<z.ZodObject<{
@@ -44,6 +44,13 @@ export const RunGuardJsonConfigSchema = z.object({
44
44
  }
45
45
  return true;
46
46
  }, { message: 'minCheckpointInterval must be <= maxCheckpointInterval' });
47
+ // ── Model Call(引擎 watchdog 超时:流式 idle + 绝对上限)──
48
+ export const ModelCallConfigSchema = z.object({
49
+ /** 流式 chunk 间最大静默(含首 token 等待),毫秒 */
50
+ idleTimeoutMs: z.number().positive().optional(),
51
+ /** 单次模型调用总时长上限,毫秒 */
52
+ absoluteTimeoutMs: z.number().positive().optional(),
53
+ });
47
54
  // ── Agent Runtime(消息路径始终经 Runtime;Source 按配置块挂载)──
48
55
  export const AgentRuntimeJsonConfigSchema = z.object({
49
56
  coalesceWindowMs: z.number().min(0).optional(),
@@ -66,8 +73,19 @@ export const AgentRuntimeJsonConfigSchema = z.object({
66
73
  eventType: z.union([z.string(), z.array(z.string())]).optional(),
67
74
  })
68
75
  .optional(),
76
+ /**
77
+ * AgentSignalSource(agent_signal 通知)挂载三态:
78
+ * true=显式挂载;false=显式关闭(委派 notify 推送随之关闭,退化为 poll + 状态提示);
79
+ * 缺省=委派接线时自动补挂(委派 notify 推送的接收端)。
80
+ */
69
81
  agentSignal: z.boolean().optional(),
70
82
  });
83
+ /** SessionSchedule 预算与兜底(arch/session-schedules.md P1) */
84
+ export const SchedulesJsonConfigSchema = z.object({
85
+ maxOpenPerSession: z.number().min(0).optional(),
86
+ maxWakesPerHour: z.number().min(0).optional(),
87
+ tickIntervalMs: z.number().min(0).optional(),
88
+ });
71
89
  // ── Concurrency ──
72
90
  const RateLimitSlotSchema = z.object({
73
91
  requestsPerMinute: z.number().positive(),
@@ -4,12 +4,20 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
+ export { expandHomePath, isConfigPathShape } from '../paths.js';
8
+ /** 配置路径字段(workspace / transactionRoots 等):绝对路径或 ~ 形态 */
9
+ export declare const ConfigPathSchema: z.ZodString;
7
10
  /** 监听 host:local(默认仅本机)| lan(局域网)| 具体 IP/主机名 */
8
11
  export declare const NetworkHostSchema: z.ZodUnion<readonly [z.ZodEnum<{
9
12
  local: "local";
10
13
  lan: "lan";
11
14
  }>, z.ZodString]>;
12
15
  /** Session 权利字段(ACL E6;agent.maxSessionRights / 角色 defaults) */
16
+ export declare const ToolRightsSchema: z.ZodObject<{
17
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
18
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
19
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
20
+ }, z.core.$strip>;
13
21
  export declare const SessionRightsSchema: z.ZodObject<{
14
22
  canRun: z.ZodOptional<z.ZodBoolean>;
15
23
  readScope: z.ZodOptional<z.ZodEnum<{
@@ -21,6 +29,11 @@ export declare const SessionRightsSchema: z.ZodObject<{
21
29
  writeMemory: z.ZodOptional<z.ZodBoolean>;
22
30
  canManageTasks: z.ZodOptional<z.ZodBoolean>;
23
31
  canHandoff: z.ZodOptional<z.ZodBoolean>;
32
+ toolRights: z.ZodOptional<z.ZodObject<{
33
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
34
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
35
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
36
+ }, z.core.$strip>>;
24
37
  }, z.core.$strip>;
25
38
  export declare const InlinePersonaSchema: z.ZodObject<{
26
39
  name: z.ZodOptional<z.ZodString>;
@@ -4,18 +4,40 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
+ import { isConfigPathShape } from '../paths.js';
8
+ // 路径语义的唯一实现在 zod-free 的 paths.ts(harness 运行时同样引用);此处转出
9
+ // 保持 schema 消费方的导入面不变。
10
+ export { expandHomePath, isConfigPathShape } from '../paths.js';
11
+ /** 配置路径字段(workspace / transactionRoots 等):绝对路径或 ~ 形态 */
12
+ export const ConfigPathSchema = z
13
+ .string()
14
+ .min(1)
15
+ .refine(isConfigPathShape, {
16
+ message: 'must be an absolute path or ~-prefixed (~/…, ~\\…, or bare ~)',
17
+ })
18
+ .describe('Absolute path or ~-prefixed (~/…, ~\\…, bare ~); ~user is not supported');
7
19
  /** 监听 host:local(默认仅本机)| lan(局域网)| 具体 IP/主机名 */
8
20
  export const NetworkHostSchema = z.union([
9
21
  z.enum(['local', 'lan']),
10
22
  z.string().min(1),
11
23
  ]);
12
24
  /** Session 权利字段(ACL E6;agent.maxSessionRights / 角色 defaults) */
25
+ export const ToolRightsSchema = z.object({
26
+ /** 工具名白名单;缺省/空 = 不限(仍受 deny 约束) */
27
+ allow: z.array(z.string().min(1)).optional(),
28
+ /** 工具名黑名单(优先于 allow) */
29
+ deny: z.array(z.string().min(1)).optional(),
30
+ /** 能力标签黑名单(exec / egress / send / dynamic-code / …,D5-a) */
31
+ denyCapabilities: z.array(z.string().min(1)).optional(),
32
+ });
13
33
  export const SessionRightsSchema = z.object({
14
34
  canRun: z.boolean().optional(),
15
35
  readScope: z.enum(['full', 'from_grant', 'summary_tail', 'none']).optional(),
16
36
  writeMemory: z.boolean().optional(),
17
37
  canManageTasks: z.boolean().optional(),
18
38
  canHandoff: z.boolean().optional(),
39
+ /** SEC-2 per-tool surface;缺省不额外限制 */
40
+ toolRights: ToolRightsSchema.optional(),
19
41
  });
20
42
  export const InlinePersonaSchema = z.object({
21
43
  name: z.string().optional(),
@@ -17,9 +17,9 @@ export declare const KnowledgeConfigSchema: z.ZodObject<{
17
17
  required: z.ZodOptional<z.ZodBoolean>;
18
18
  recall: z.ZodOptional<z.ZodEnum<{
19
19
  off: "off";
20
+ inject: "inject";
20
21
  hint: "hint";
21
22
  hybrid: "hybrid";
22
- inject: "inject";
23
23
  }>>;
24
24
  autoInject: z.ZodOptional<z.ZodObject<{
25
25
  minScore: z.ZodOptional<z.ZodNumber>;
@@ -52,8 +52,8 @@ export declare const KnowledgeConfigSchema: z.ZodObject<{
52
52
  hybridKeyword: z.ZodOptional<z.ZodBoolean>;
53
53
  embedSecretPolicy: z.ZodOptional<z.ZodEnum<{
54
54
  allow: "allow";
55
- redact: "redact";
56
55
  skip: "skip";
56
+ redact: "redact";
57
57
  }>>;
58
58
  phaseA: z.ZodOptional<z.ZodObject<{
59
59
  concurrency: z.ZodOptional<z.ZodNumber>;
@@ -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 优先) */