@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
@@ -4,15 +4,25 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
- import { InlinePersonaSchema, ModelConfigSchema, NetworkHostSchema, SessionRightsSchema, ToolPolicySchema, } from './shared.js';
7
+ import { ConfigPathSchema, InlinePersonaSchema, ModelConfigSchema, NetworkHostSchema, SessionRightsSchema, ToolPolicySchema, } from './shared.js';
8
+ import { EffectPolicyConfigSchema } from './governance.js';
8
9
  export const AgentConfigSchema = z.object({
9
10
  id: z.string({ error: 'Agent must have an id' }).min(1, 'Agent id cannot be empty'),
10
- home: z.string().optional(),
11
- workspace: z.string().optional(),
12
- persona: z.union([z.string(), InlinePersonaSchema]).optional(),
11
+ /**
12
+ * agent 文件态 home(persona / skills / agent.db 基线)。与 `workspace` 同规:
13
+ * 绝对路径或 `~` 形态——相对路径加载即拒,杜绝隐式 resolve 到进程 cwd。
14
+ */
15
+ home: ConfigPathSchema.optional(),
16
+ /** 工具基路径:绝对路径或 ~ 形态(相对路径加载即拒,杜绝隐式 resolve 到进程 cwd) */
17
+ workspace: ConfigPathSchema.optional(),
18
+ /** ToolEffectPolicy 运行模式(P3);与 tools allow/deny 无关 */
19
+ effectPolicy: EffectPolicyConfigSchema.optional(),
20
+ /** 文件式 persona 目录,或内联 systemPrompt。legacy string 形态等价 home(同路径契约) */
21
+ persona: z.union([ConfigPathSchema, InlinePersonaSchema]).optional(),
13
22
  model: z.union([z.string().min(1), ModelConfigSchema]),
14
23
  tools: ToolPolicySchema.optional(),
15
- skillDirectory: z.string().optional(),
24
+ /** Skill 目录(缺省 `home/skills`):与 `workspace`/`home` 同规(绝对或 `~` 形态,拒相对) */
25
+ skillDirectory: ConfigPathSchema.optional(),
16
26
  skills: z.array(z.string()).optional(),
17
27
  channelBindings: z.record(z.string(), z.string()).optional(),
18
28
  /** Session ACL 天花板(E6 L1);与角色 max / 绑定取交集 */
@@ -23,6 +33,72 @@ export const AgentConfigSchema = z.object({
23
33
  recall: z.enum(['off', 'hint', 'hybrid', 'inject']).optional(),
24
34
  })
25
35
  .optional(),
36
+ /**
37
+ * 特质标签(`arch/delegation.md` §9.2)。
38
+ *
39
+ * 供父 agent 按特质发现委派目标(`AgentRegistry.findByTrait`)。
40
+ * 自由字符串,只影响**委派寻址**,不含任何权限语义。
41
+ *
42
+ * 命名说明:刻意不叫 `capabilities` —— 该词已被工具安全标签
43
+ * (`RegisteredTool.definition.capabilities`,如 `'fs-read'`/`'exec'`)占用,
44
+ * 后者由 SecurityGuard 做安全拦截,两者语义无关(`docs/task-system.md` A2)。
45
+ */
46
+ traits: z
47
+ .array(z.string())
48
+ .optional()
49
+ .describe('Trait tags for delegation discovery (e.g. ["research","general"]). ' +
50
+ 'Free strings matched exactly; ONLY affects which agent a capability-based ' +
51
+ 'delegate_dispatch resolves to. Carries NO permission meaning — control tool ' +
52
+ 'access via `tools`, rights via `delegation.rightsCeiling`/`maxSessionRights`. ' +
53
+ 'Not related to tool capability tags (RegisteredTool.definition.capabilities).'),
54
+ /**
55
+ * 委派策略(`arch/delegation.md` §9.2)。
56
+ *
57
+ * **整段可省略**:省略即用 `DEFAULT_DELEGATION_POLICY`
58
+ * —— 委派**默认开启**(可被委派、可发委派、限一层)。
59
+ * 关闭必须显式写 `false`。
60
+ * 有此段且 `callable: true` 的 agent 即「子 agent 模板」;
61
+ * 无 `channelBindings` 的这类 agent 不会出现在用户对话面。
62
+ */
63
+ delegation: z
64
+ .object({
65
+ /** 能否被委派(默认 true) */
66
+ callable: z
67
+ .boolean()
68
+ .default(true)
69
+ .describe('Whether this agent can BE delegated to (as a child agent). Default TRUE — ' +
70
+ 'agents are delegation-capable out of the box. Set false to restrict this agent ' +
71
+ 'to direct user conversation only.'),
72
+ /** 允许哪些 agentId 调我(缺省 = 任意) */
73
+ callableBy: z.array(z.string()).optional(),
74
+ /** 我能不能再委派(默认 true) */
75
+ canDelegate: z
76
+ .boolean()
77
+ .default(true)
78
+ .describe('Whether this agent GAINS the delegate_* tools (delegate_dispatch/list/get/cancel). ' +
79
+ 'Default TRUE. Set false to strip those tools from this agent.'),
80
+ /** 递归上限(默认 1 = 我能派子,子不能再派;runaway 兜底) */
81
+ maxDepth: z
82
+ .number()
83
+ .int()
84
+ .positive()
85
+ .optional()
86
+ .describe('How many delegation levels may originate here. Default 1 = I may spawn one ' +
87
+ 'level, my children cannot delegate further. This is the runaway guard now that ' +
88
+ 'delegation is on by default; raise to 2+ only when nested delegation is wanted.'),
89
+ /** 被委派时的权利天花板(只能收紧不能放宽,D3) */
90
+ rightsCeiling: SessionRightsSchema.optional(),
91
+ /** 委派预算上限(请求预算与此取交集) */
92
+ budget: z
93
+ .object({
94
+ maxTurns: z.number().positive().optional(),
95
+ maxTokens: z.number().positive().optional(),
96
+ timeoutMs: z.number().positive().optional(),
97
+ })
98
+ .optional(),
99
+ // outputSchema:结构化输出契约,v1 留字段位不实现(arch/delegation.md O2)
100
+ })
101
+ .optional(),
26
102
  });
27
103
  export const PluginConfigSchema = z.object({
28
104
  loadPaths: z.array(z.string()).optional(),
@@ -4,6 +4,15 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
+ /** 历史工具结果批量冻结老化(F1-B2):视图级降级、批量冻结、write-once */
8
+ export declare const HistoryAgingConfigSchema: z.ZodObject<{
9
+ enabled: z.ZodOptional<z.ZodBoolean>;
10
+ rawWindow: z.ZodOptional<z.ZodNumber>;
11
+ freezeBatch: z.ZodOptional<z.ZodNumber>;
12
+ maxPointerChars: z.ZodOptional<z.ZodNumber>;
13
+ ageToolArgs: z.ZodOptional<z.ZodBoolean>;
14
+ maxAgedArgChars: z.ZodOptional<z.ZodNumber>;
15
+ }, z.core.$strip>;
7
16
  export declare const ContextEngineConfigSchema: z.ZodObject<{
8
17
  type: z.ZodOptional<z.ZodEnum<{
9
18
  default: "default";
@@ -11,9 +20,18 @@ export declare const ContextEngineConfigSchema: z.ZodObject<{
11
20
  }>>;
12
21
  protectFirstN: z.ZodOptional<z.ZodNumber>;
13
22
  protectLastN: z.ZodOptional<z.ZodNumber>;
14
- compactThreshold: z.ZodOptional<z.ZodNumber>;
15
23
  proactiveCompactRatio: z.ZodOptional<z.ZodNumber>;
16
24
  proactiveCooldownMs: z.ZodOptional<z.ZodNumber>;
25
+ historyAging: z.ZodOptional<z.ZodObject<{
26
+ enabled: z.ZodOptional<z.ZodBoolean>;
27
+ rawWindow: z.ZodOptional<z.ZodNumber>;
28
+ freezeBatch: z.ZodOptional<z.ZodNumber>;
29
+ maxPointerChars: z.ZodOptional<z.ZodNumber>;
30
+ ageToolArgs: z.ZodOptional<z.ZodBoolean>;
31
+ maxAgedArgChars: z.ZodOptional<z.ZodNumber>;
32
+ }, z.core.$strip>>;
33
+ targetTokens: z.ZodOptional<z.ZodNumber>;
34
+ compactFallbackRatio: z.ZodOptional<z.ZodNumber>;
17
35
  outputRatio: z.ZodOptional<z.ZodNumber>;
18
36
  minOutputReserve: z.ZodOptional<z.ZodNumber>;
19
37
  maxOutputReserve: z.ZodOptional<z.ZodNumber>;
@@ -23,14 +41,15 @@ export declare const ContextEngineConfigSchema: z.ZodObject<{
23
41
  export declare const ContextAssemblerConfigSchema: z.ZodObject<{
24
42
  systemBudgetRatio: z.ZodOptional<z.ZodNumber>;
25
43
  systemBudgetTokens: z.ZodOptional<z.ZodNumber>;
44
+ snapshotBudgetTokens: z.ZodOptional<z.ZodNumber>;
26
45
  compactTargetTokens: z.ZodOptional<z.ZodNumber>;
27
46
  layerShares: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
28
47
  memory: "memory";
48
+ cognition: "cognition";
29
49
  wisdom: "wisdom";
30
50
  persona: "persona";
31
51
  skill: "skill";
32
52
  knowledge: "knowledge";
33
- cognition: "cognition";
34
53
  runtime: "runtime";
35
54
  }>, z.ZodNumber>>;
36
55
  includeLayerPreview: z.ZodOptional<z.ZodBoolean>;
@@ -58,9 +77,9 @@ export declare const SummaryConfigSchema: z.ZodObject<{
58
77
  maxReturnChars: z.ZodOptional<z.ZodNumber>;
59
78
  }, z.core.$catchall<z.ZodOptional<z.ZodObject<{
60
79
  mode: z.ZodOptional<z.ZodEnum<{
80
+ always: "always";
61
81
  auto: "auto";
62
82
  over_threshold: "over_threshold";
63
- always: "always";
64
83
  never: "never";
65
84
  kind_sensitive: "kind_sensitive";
66
85
  }>>;
@@ -105,10 +124,10 @@ export declare const CompactCapabilityConfigSchema: z.ZodObject<{
105
124
  defaultProtectTail: z.ZodOptional<z.ZodNumber>;
106
125
  defaultTargetTokens: z.ZodOptional<z.ZodNumber>;
107
126
  defaultMode: z.ZodOptional<z.ZodEnum<{
127
+ auto: "auto";
108
128
  structure_only: "structure_only";
109
129
  summary_only: "summary_only";
110
130
  head_tail_only: "head_tail_only";
111
- auto: "auto";
112
131
  }>>;
113
132
  }, z.core.$strip>;
114
133
  /** 公用能力:documents(DocumentPort 读抽取) */
@@ -153,8 +172,8 @@ export declare const DocumentsConfigSchema: z.ZodObject<{
153
172
  export declare const ConstitutionConfigSchema: z.ZodObject<{
154
173
  mode: z.ZodEnum<{
155
174
  off: "off";
156
- custom: "custom";
157
175
  product: "product";
176
+ custom: "custom";
158
177
  }>;
159
178
  path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
160
179
  }, z.core.$strip>;
@@ -4,13 +4,39 @@
4
4
  * @module
5
5
  */
6
6
  import { z } from 'zod';
7
+ /** 历史工具结果批量冻结老化(F1-B2):视图级降级、批量冻结、write-once */
8
+ export const HistoryAgingConfigSchema = z.object({
9
+ enabled: z.boolean().optional(),
10
+ /** 跨轮原文保留条数(默认 40) */
11
+ rawWindow: z.number().int().nonnegative().optional(),
12
+ /**
13
+ * 批量冻结步长(默认 40;最小 1)。⚠️ 1 = 逐候选即降级(等同渐进老化、
14
+ * 每轮烧前缀缓存,仅调试用);生产取值应 ≥ 每轮工具结果数。
15
+ */
16
+ freezeBatch: z.number().int().min(1).optional(),
17
+ /** 指针目标字符数(默认 400) */
18
+ maxPointerChars: z.number().int().positive().optional(),
19
+ /**
20
+ * 是否随结果老化同步降级该次调用的参数(默认 true)
21
+ *
22
+ * 参数是上下文中唯一无界增长的成分;只作用于「结果已被老化」的调用。
23
+ */
24
+ ageToolArgs: z.boolean().optional(),
25
+ /** 参数摘要目标字符数(默认 320;过小会退化为整体轮廓、丢掉键名) */
26
+ maxAgedArgChars: z.number().int().positive().optional(),
27
+ });
7
28
  export const ContextEngineConfigSchema = z.object({
8
29
  type: z.enum(['default', 'custom']).optional(),
9
30
  protectFirstN: z.number().min(0).optional(),
10
31
  protectLastN: z.number().min(0).optional(),
11
- compactThreshold: z.number().min(0).max(1).optional(),
32
+ /** 0 = 禁新的路径 A 压缩(不只禁 LLM;不丢粘滞视图);见 ContextEngineConfig JSDoc */
12
33
  proactiveCompactRatio: z.number().min(0).max(1).optional(),
13
34
  proactiveCooldownMs: z.number().min(0).optional(),
35
+ historyAging: HistoryAgingConfigSchema.optional(),
36
+ /** 工作目标 token(与窗口解耦,F1-B3);0 = 只挂窗口比例线(proactiveCompactRatio) */
37
+ targetTokens: z.number().int().nonnegative().optional(),
38
+ /** 目标线倍数(默认 3;目标线 = targetTokens × 倍数,须 > B2 老化稳态) */
39
+ compactFallbackRatio: z.number().positive().optional(),
14
40
  outputRatio: z.number().min(0).max(1).optional(),
15
41
  minOutputReserve: z.number().positive().optional(),
16
42
  maxOutputReserve: z.number().positive().optional(),
@@ -25,6 +51,7 @@ export const ContextEngineConfigSchema = z.object({
25
51
  export const ContextAssemblerConfigSchema = z.object({
26
52
  systemBudgetRatio: z.number().min(0.05).max(0.5).optional(),
27
53
  systemBudgetTokens: z.number().positive().optional(),
54
+ snapshotBudgetTokens: z.number().positive().optional(),
28
55
  compactTargetTokens: z.number().positive().optional(),
29
56
  layerShares: z
30
57
  .record(z.enum(['wisdom', 'persona', 'skill', 'knowledge', 'cognition', 'memory', 'runtime']), z.number().min(0).max(1))
@@ -7,7 +7,7 @@ import { z } from 'zod';
7
7
  /** engine 拥有的顶层配置段(不含 web / gateway 外挂段) */
8
8
  export declare const engineConfigSchema: z.ZodObject<{
9
9
  subsystems: z.ZodOptional<z.ZodObject<{
10
- auditDir: z.ZodOptional<z.ZodString>;
10
+ auditDir: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
11
11
  allowlist: z.ZodOptional<z.ZodArray<z.ZodString>>;
12
12
  denylist: z.ZodOptional<z.ZodArray<z.ZodString>>;
13
13
  }, z.core.$strip>>;
@@ -15,6 +15,60 @@ export declare const engineConfigSchema: z.ZodObject<{
15
15
  id: z.ZodString;
16
16
  home: z.ZodOptional<z.ZodString>;
17
17
  workspace: z.ZodOptional<z.ZodString>;
18
+ effectPolicy: z.ZodOptional<z.ZodObject<{
19
+ mode: z.ZodOptional<z.ZodEnum<{
20
+ host: "host";
21
+ workspace: "workspace";
22
+ project: "project";
23
+ untrusted: "untrusted";
24
+ }>>;
25
+ untrustedAdmission: z.ZodOptional<z.ZodEnum<{
26
+ refuse: "refuse";
27
+ degrade: "degrade";
28
+ }>>;
29
+ transactionRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
30
+ pathContainment: z.ZodOptional<z.ZodEnum<{
31
+ none: "none";
32
+ strict: "strict";
33
+ soft: "soft";
34
+ }>>;
35
+ shellEscape: z.ZodOptional<z.ZodEnum<{
36
+ deny: "deny";
37
+ confirm: "confirm";
38
+ allow: "allow";
39
+ }>>;
40
+ processLimits: z.ZodOptional<z.ZodBoolean>;
41
+ commit: z.ZodOptional<z.ZodEnum<{
42
+ auto: "auto";
43
+ manual: "manual";
44
+ }>>;
45
+ onClose: z.ZodOptional<z.ZodEnum<{
46
+ commit: "commit";
47
+ discard: "discard";
48
+ }>>;
49
+ effects: z.ZodOptional<z.ZodEnum<{
50
+ engine: "engine";
51
+ "host-gate": "host-gate";
52
+ }>>;
53
+ toolIsolation: z.ZodOptional<z.ZodEnum<{
54
+ none: "none";
55
+ "session-subdir": "session-subdir";
56
+ "session-lock": "session-lock";
57
+ }>>;
58
+ undoLimit: z.ZodOptional<z.ZodObject<{
59
+ maxEntries: z.ZodOptional<z.ZodNumber>;
60
+ maxBlobBytes: z.ZodOptional<z.ZodNumber>;
61
+ }, z.core.$strip>>;
62
+ shellJournal: z.ZodOptional<z.ZodEnum<{
63
+ snapshot: "snapshot";
64
+ off: "off";
65
+ }>>;
66
+ shellJournalLimit: z.ZodOptional<z.ZodObject<{
67
+ maxFiles: z.ZodOptional<z.ZodNumber>;
68
+ maxBytes: z.ZodOptional<z.ZodNumber>;
69
+ maxFileSize: z.ZodOptional<z.ZodNumber>;
70
+ }, z.core.$strip>>;
71
+ }, z.core.$strip>>;
18
72
  persona: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
19
73
  name: z.ZodOptional<z.ZodString>;
20
74
  description: z.ZodOptional<z.ZodString>;
@@ -52,20 +106,54 @@ export declare const engineConfigSchema: z.ZodObject<{
52
106
  writeMemory: z.ZodOptional<z.ZodBoolean>;
53
107
  canManageTasks: z.ZodOptional<z.ZodBoolean>;
54
108
  canHandoff: z.ZodOptional<z.ZodBoolean>;
109
+ toolRights: z.ZodOptional<z.ZodObject<{
110
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
111
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
112
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
113
+ }, z.core.$strip>>;
55
114
  }, z.core.$strip>>;
56
115
  knowledge: z.ZodOptional<z.ZodObject<{
57
116
  recall: z.ZodOptional<z.ZodEnum<{
58
117
  off: "off";
118
+ inject: "inject";
59
119
  hint: "hint";
60
120
  hybrid: "hybrid";
61
- inject: "inject";
62
121
  }>>;
63
122
  }, z.core.$strip>>;
123
+ traits: z.ZodOptional<z.ZodArray<z.ZodString>>;
124
+ delegation: z.ZodOptional<z.ZodObject<{
125
+ callable: z.ZodDefault<z.ZodBoolean>;
126
+ callableBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
127
+ canDelegate: z.ZodDefault<z.ZodBoolean>;
128
+ maxDepth: z.ZodOptional<z.ZodNumber>;
129
+ rightsCeiling: z.ZodOptional<z.ZodObject<{
130
+ canRun: z.ZodOptional<z.ZodBoolean>;
131
+ readScope: z.ZodOptional<z.ZodEnum<{
132
+ full: "full";
133
+ from_grant: "from_grant";
134
+ summary_tail: "summary_tail";
135
+ none: "none";
136
+ }>>;
137
+ writeMemory: z.ZodOptional<z.ZodBoolean>;
138
+ canManageTasks: z.ZodOptional<z.ZodBoolean>;
139
+ canHandoff: z.ZodOptional<z.ZodBoolean>;
140
+ toolRights: z.ZodOptional<z.ZodObject<{
141
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
142
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
143
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
144
+ }, z.core.$strip>>;
145
+ }, z.core.$strip>>;
146
+ budget: z.ZodOptional<z.ZodObject<{
147
+ maxTurns: z.ZodOptional<z.ZodNumber>;
148
+ maxTokens: z.ZodOptional<z.ZodNumber>;
149
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
150
+ }, z.core.$strip>>;
151
+ }, z.core.$strip>>;
64
152
  }, z.core.$strip>>;
65
153
  models: z.ZodObject<{
66
154
  mode: z.ZodOptional<z.ZodEnum<{
67
- merge: "merge";
68
155
  replace: "replace";
156
+ merge: "merge";
69
157
  }>>;
70
158
  providers: z.ZodRecord<z.ZodString, z.ZodObject<{
71
159
  baseUrl: z.ZodString;
@@ -97,9 +185,9 @@ export declare const engineConfigSchema: z.ZodObject<{
97
185
  enabled: z.ZodOptional<z.ZodBoolean>;
98
186
  type: z.ZodOptional<z.ZodEnum<{
99
187
  openai: "openai";
188
+ http: "http";
100
189
  custom: "custom";
101
190
  ollama: "ollama";
102
- http: "http";
103
191
  }>>;
104
192
  provider: z.ZodOptional<z.ZodString>;
105
193
  model: z.ZodString;
@@ -178,6 +266,10 @@ export declare const engineConfigSchema: z.ZodObject<{
178
266
  hardLimit: z.ZodOptional<z.ZodNumber>;
179
267
  hardWallClockMs: z.ZodOptional<z.ZodNumber>;
180
268
  }, z.core.$strip>>;
269
+ modelCall: z.ZodOptional<z.ZodObject<{
270
+ idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
271
+ absoluteTimeoutMs: z.ZodOptional<z.ZodNumber>;
272
+ }, z.core.$strip>>;
181
273
  agentRuntime: z.ZodOptional<z.ZodObject<{
182
274
  coalesceWindowMs: z.ZodOptional<z.ZodNumber>;
183
275
  expectedMaxConcurrentRuns: z.ZodOptional<z.ZodNumber>;
@@ -197,6 +289,11 @@ export declare const engineConfigSchema: z.ZodObject<{
197
289
  }, z.core.$strip>>;
198
290
  agentSignal: z.ZodOptional<z.ZodBoolean>;
199
291
  }, z.core.$strip>>;
292
+ schedules: z.ZodOptional<z.ZodObject<{
293
+ maxOpenPerSession: z.ZodOptional<z.ZodNumber>;
294
+ maxWakesPerHour: z.ZodOptional<z.ZodNumber>;
295
+ tickIntervalMs: z.ZodOptional<z.ZodNumber>;
296
+ }, z.core.$strip>>;
200
297
  contextEngine: z.ZodOptional<z.ZodObject<{
201
298
  type: z.ZodOptional<z.ZodEnum<{
202
299
  default: "default";
@@ -204,9 +301,18 @@ export declare const engineConfigSchema: z.ZodObject<{
204
301
  }>>;
205
302
  protectFirstN: z.ZodOptional<z.ZodNumber>;
206
303
  protectLastN: z.ZodOptional<z.ZodNumber>;
207
- compactThreshold: z.ZodOptional<z.ZodNumber>;
208
304
  proactiveCompactRatio: z.ZodOptional<z.ZodNumber>;
209
305
  proactiveCooldownMs: z.ZodOptional<z.ZodNumber>;
306
+ historyAging: z.ZodOptional<z.ZodObject<{
307
+ enabled: z.ZodOptional<z.ZodBoolean>;
308
+ rawWindow: z.ZodOptional<z.ZodNumber>;
309
+ freezeBatch: z.ZodOptional<z.ZodNumber>;
310
+ maxPointerChars: z.ZodOptional<z.ZodNumber>;
311
+ ageToolArgs: z.ZodOptional<z.ZodBoolean>;
312
+ maxAgedArgChars: z.ZodOptional<z.ZodNumber>;
313
+ }, z.core.$strip>>;
314
+ targetTokens: z.ZodOptional<z.ZodNumber>;
315
+ compactFallbackRatio: z.ZodOptional<z.ZodNumber>;
210
316
  outputRatio: z.ZodOptional<z.ZodNumber>;
211
317
  minOutputReserve: z.ZodOptional<z.ZodNumber>;
212
318
  maxOutputReserve: z.ZodOptional<z.ZodNumber>;
@@ -216,14 +322,15 @@ export declare const engineConfigSchema: z.ZodObject<{
216
322
  contextAssembler: z.ZodOptional<z.ZodObject<{
217
323
  systemBudgetRatio: z.ZodOptional<z.ZodNumber>;
218
324
  systemBudgetTokens: z.ZodOptional<z.ZodNumber>;
325
+ snapshotBudgetTokens: z.ZodOptional<z.ZodNumber>;
219
326
  compactTargetTokens: z.ZodOptional<z.ZodNumber>;
220
327
  layerShares: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
221
328
  memory: "memory";
329
+ cognition: "cognition";
222
330
  wisdom: "wisdom";
223
331
  persona: "persona";
224
332
  skill: "skill";
225
333
  knowledge: "knowledge";
226
- cognition: "cognition";
227
334
  runtime: "runtime";
228
335
  }>, z.ZodNumber>>;
229
336
  includeLayerPreview: z.ZodOptional<z.ZodBoolean>;
@@ -251,9 +358,9 @@ export declare const engineConfigSchema: z.ZodObject<{
251
358
  maxReturnChars: z.ZodOptional<z.ZodNumber>;
252
359
  }, z.core.$catchall<z.ZodOptional<z.ZodObject<{
253
360
  mode: z.ZodOptional<z.ZodEnum<{
361
+ always: "always";
254
362
  auto: "auto";
255
363
  over_threshold: "over_threshold";
256
- always: "always";
257
364
  never: "never";
258
365
  kind_sensitive: "kind_sensitive";
259
366
  }>>;
@@ -297,10 +404,10 @@ export declare const engineConfigSchema: z.ZodObject<{
297
404
  defaultProtectTail: z.ZodOptional<z.ZodNumber>;
298
405
  defaultTargetTokens: z.ZodOptional<z.ZodNumber>;
299
406
  defaultMode: z.ZodOptional<z.ZodEnum<{
407
+ auto: "auto";
300
408
  structure_only: "structure_only";
301
409
  summary_only: "summary_only";
302
410
  head_tail_only: "head_tail_only";
303
- auto: "auto";
304
411
  }>>;
305
412
  }, z.core.$strip>>;
306
413
  documents: z.ZodOptional<z.ZodObject<{
@@ -352,9 +459,9 @@ export declare const engineConfigSchema: z.ZodObject<{
352
459
  required: z.ZodOptional<z.ZodBoolean>;
353
460
  recall: z.ZodOptional<z.ZodEnum<{
354
461
  off: "off";
462
+ inject: "inject";
355
463
  hint: "hint";
356
464
  hybrid: "hybrid";
357
- inject: "inject";
358
465
  }>>;
359
466
  autoInject: z.ZodOptional<z.ZodObject<{
360
467
  minScore: z.ZodOptional<z.ZodNumber>;
@@ -387,8 +494,8 @@ export declare const engineConfigSchema: z.ZodObject<{
387
494
  hybridKeyword: z.ZodOptional<z.ZodBoolean>;
388
495
  embedSecretPolicy: z.ZodOptional<z.ZodEnum<{
389
496
  allow: "allow";
390
- redact: "redact";
391
497
  skip: "skip";
498
+ redact: "redact";
392
499
  }>>;
393
500
  phaseA: z.ZodOptional<z.ZodObject<{
394
501
  concurrency: z.ZodOptional<z.ZodNumber>;
@@ -471,22 +578,23 @@ export declare const engineConfigSchema: z.ZodObject<{
471
578
  constitution: z.ZodOptional<z.ZodObject<{
472
579
  mode: z.ZodEnum<{
473
580
  off: "off";
474
- custom: "custom";
475
581
  product: "product";
582
+ custom: "custom";
476
583
  }>;
477
584
  path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
478
585
  }, z.core.$strip>>;
479
586
  contextAssembler: z.ZodOptional<z.ZodObject<{
480
587
  systemBudgetRatio: z.ZodOptional<z.ZodNumber>;
481
588
  systemBudgetTokens: z.ZodOptional<z.ZodNumber>;
589
+ snapshotBudgetTokens: z.ZodOptional<z.ZodNumber>;
482
590
  compactTargetTokens: z.ZodOptional<z.ZodNumber>;
483
591
  layerShares: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
484
592
  memory: "memory";
593
+ cognition: "cognition";
485
594
  wisdom: "wisdom";
486
595
  persona: "persona";
487
596
  skill: "skill";
488
597
  knowledge: "knowledge";
489
- cognition: "cognition";
490
598
  runtime: "runtime";
491
599
  }>, z.ZodNumber>>;
492
600
  includeLayerPreview: z.ZodOptional<z.ZodBoolean>;
@@ -497,8 +605,8 @@ export declare const engineConfigSchema: z.ZodObject<{
497
605
  constitution: z.ZodOptional<z.ZodObject<{
498
606
  mode: z.ZodEnum<{
499
607
  off: "off";
500
- custom: "custom";
501
608
  product: "product";
609
+ custom: "custom";
502
610
  }>;
503
611
  path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
504
612
  }, z.core.$strip>>;
@@ -661,6 +769,12 @@ export declare const engineConfigSchema: z.ZodObject<{
661
769
  high: "high";
662
770
  }>>;
663
771
  allowedPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
772
+ network: z.ZodOptional<z.ZodObject<{
773
+ allowPrivateNetwork: z.ZodOptional<z.ZodBoolean>;
774
+ }, z.core.$strip>>;
775
+ }, z.core.$strip>>;
776
+ credentials: z.ZodOptional<z.ZodObject<{
777
+ requireBindings: z.ZodOptional<z.ZodBoolean>;
664
778
  }, z.core.$strip>>;
665
779
  channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
666
780
  type: z.ZodString;
@@ -679,12 +793,67 @@ export declare const engineConfigSchema: z.ZodObject<{
679
793
  "per-peer": "per-peer";
680
794
  "per-channel-peer": "per-channel-peer";
681
795
  }>>;
796
+ idleExpiryMs: z.ZodOptional<z.ZodNumber>;
682
797
  }, z.core.$loose>>;
683
798
  toolIsolation: z.ZodOptional<z.ZodEnum<{
684
799
  none: "none";
685
800
  "session-subdir": "session-subdir";
686
801
  "session-lock": "session-lock";
687
802
  }>>;
803
+ effectPolicy: z.ZodOptional<z.ZodObject<{
804
+ mode: z.ZodOptional<z.ZodEnum<{
805
+ host: "host";
806
+ workspace: "workspace";
807
+ project: "project";
808
+ untrusted: "untrusted";
809
+ }>>;
810
+ untrustedAdmission: z.ZodOptional<z.ZodEnum<{
811
+ refuse: "refuse";
812
+ degrade: "degrade";
813
+ }>>;
814
+ transactionRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
815
+ pathContainment: z.ZodOptional<z.ZodEnum<{
816
+ none: "none";
817
+ strict: "strict";
818
+ soft: "soft";
819
+ }>>;
820
+ shellEscape: z.ZodOptional<z.ZodEnum<{
821
+ deny: "deny";
822
+ confirm: "confirm";
823
+ allow: "allow";
824
+ }>>;
825
+ processLimits: z.ZodOptional<z.ZodBoolean>;
826
+ commit: z.ZodOptional<z.ZodEnum<{
827
+ auto: "auto";
828
+ manual: "manual";
829
+ }>>;
830
+ onClose: z.ZodOptional<z.ZodEnum<{
831
+ commit: "commit";
832
+ discard: "discard";
833
+ }>>;
834
+ effects: z.ZodOptional<z.ZodEnum<{
835
+ engine: "engine";
836
+ "host-gate": "host-gate";
837
+ }>>;
838
+ toolIsolation: z.ZodOptional<z.ZodEnum<{
839
+ none: "none";
840
+ "session-subdir": "session-subdir";
841
+ "session-lock": "session-lock";
842
+ }>>;
843
+ undoLimit: z.ZodOptional<z.ZodObject<{
844
+ maxEntries: z.ZodOptional<z.ZodNumber>;
845
+ maxBlobBytes: z.ZodOptional<z.ZodNumber>;
846
+ }, z.core.$strip>>;
847
+ shellJournal: z.ZodOptional<z.ZodEnum<{
848
+ snapshot: "snapshot";
849
+ off: "off";
850
+ }>>;
851
+ shellJournalLimit: z.ZodOptional<z.ZodObject<{
852
+ maxFiles: z.ZodOptional<z.ZodNumber>;
853
+ maxBytes: z.ZodOptional<z.ZodNumber>;
854
+ maxFileSize: z.ZodOptional<z.ZodNumber>;
855
+ }, z.core.$strip>>;
856
+ }, z.core.$strip>>;
688
857
  sessionAcl: z.ZodOptional<z.ZodObject<{
689
858
  roles: z.ZodOptional<z.ZodArray<z.ZodObject<{
690
859
  id: z.ZodString;
@@ -700,6 +869,11 @@ export declare const engineConfigSchema: z.ZodObject<{
700
869
  writeMemory: z.ZodBoolean;
701
870
  canManageTasks: z.ZodBoolean;
702
871
  canHandoff: z.ZodBoolean;
872
+ toolRights: z.ZodDefault<z.ZodObject<{
873
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
874
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
875
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
876
+ }, z.core.$strip>>;
703
877
  }, z.core.$strip>;
704
878
  max: z.ZodOptional<z.ZodObject<{
705
879
  canRun: z.ZodBoolean;
@@ -712,6 +886,11 @@ export declare const engineConfigSchema: z.ZodObject<{
712
886
  writeMemory: z.ZodBoolean;
713
887
  canManageTasks: z.ZodBoolean;
714
888
  canHandoff: z.ZodBoolean;
889
+ toolRights: z.ZodDefault<z.ZodObject<{
890
+ allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
891
+ deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
892
+ denyCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
893
+ }, z.core.$strip>>;
715
894
  }, z.core.$strip>>;
716
895
  }, z.core.$strip>>>;
717
896
  switchDefaults: z.ZodOptional<z.ZodObject<{
@@ -721,12 +900,22 @@ export declare const engineConfigSchema: z.ZodObject<{
721
900
  }, z.core.$strip>>;
722
901
  allowAgentInitiatedHandoff: z.ZodOptional<z.ZodBoolean>;
723
902
  }, z.core.$strip>>;
903
+ fileSend: z.ZodOptional<z.ZodObject<{
904
+ maxBytes: z.ZodOptional<z.ZodNumber>;
905
+ maxReleasesPerSession: z.ZodOptional<z.ZodNumber>;
906
+ }, z.core.$strip>>;
724
907
  observability: z.ZodOptional<z.ZodObject<{
725
908
  level: z.ZodOptional<z.ZodNumber>;
726
909
  consoleLevel: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
727
910
  traceDir: z.ZodOptional<z.ZodNullable<z.ZodString>>;
728
911
  captureStreamDeltas: z.ZodOptional<z.ZodBoolean>;
729
912
  captureModelRequest: z.ZodOptional<z.ZodBoolean>;
913
+ llmRequestDump: z.ZodOptional<z.ZodObject<{
914
+ enabled: z.ZodOptional<z.ZodBoolean>;
915
+ dir: z.ZodOptional<z.ZodString>;
916
+ maxCallsPerSession: z.ZodOptional<z.ZodNumber>;
917
+ maxBodyBytes: z.ZodOptional<z.ZodNumber>;
918
+ }, z.core.$strip>>;
730
919
  }, z.core.$strip>>;
731
920
  observer: z.ZodOptional<z.ZodObject<{
732
921
  level: z.ZodOptional<z.ZodEnum<{
@@ -824,5 +1013,8 @@ export declare const engineConfigSchema: z.ZodObject<{
824
1013
  }, z.core.$strip>>;
825
1014
  }, z.core.$strip>>>;
826
1015
  }, z.core.$strip>>;
1016
+ delegation: z.ZodOptional<z.ZodObject<{
1017
+ maxActiveDelegationsPerSession: z.ZodOptional<z.ZodNumber>;
1018
+ }, z.core.$strip>>;
827
1019
  }, z.core.$strip>;
828
1020
  export type EngineConfig = z.infer<typeof engineConfigSchema>;