@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
@@ -3,23 +3,23 @@
3
3
  *
4
4
  * 只决定注入形态;失败/超时由 resolveInjectPlan fail-open。
5
5
  */
6
- const INTENT_SYSTEM = `You triage how to open uploaded attachments for an agent.
7
- Return ONLY a compact JSON object, no prose.
8
-
9
- Schema:
10
- {
11
- "mode": "structure_tools" | "recall_tools" | "overview_tools",
12
- "focus": "<short retrieval phrase or empty>",
13
- "targets": ["<attachment name>", ...] or empty,
14
- "reason": "<one short sentence>"
15
- }
16
-
17
- Rules:
18
- - structure_tools: task needs most of the document(s) (summarize/translate/review whole file).
19
- - recall_tools: task is about a local topic; set focus to a short search phrase (keep entity names).
20
- - overview_tools: intent is vague or multi-interpret.
21
- - Do NOT classify as whole-doc just because a word like "翻译/translate" appears in a filename (e.g. "翻译稿" is a document title).
22
- - Prefer recall/structure over injecting full text when documents are long.
6
+ const INTENT_SYSTEM = `You triage how to open uploaded attachments for an agent.
7
+ Return ONLY a compact JSON object, no prose.
8
+
9
+ Schema:
10
+ {
11
+ "mode": "structure_tools" | "recall_tools" | "overview_tools",
12
+ "focus": "<short retrieval phrase or empty>",
13
+ "targets": ["<attachment name>", ...] or empty,
14
+ "reason": "<one short sentence>"
15
+ }
16
+
17
+ Rules:
18
+ - structure_tools: task needs most of the document(s) (summarize/translate/review whole file).
19
+ - recall_tools: task is about a local topic; set focus to a short search phrase (keep entity names).
20
+ - overview_tools: intent is vague or multi-interpret.
21
+ - Do NOT classify as whole-doc just because a word like "翻译/translate" appears in a filename (e.g. "翻译稿" is a document title).
22
+ - Prefer recall/structure over injecting full text when documents are long.
23
23
  - targets lists only attachment names involved when the user clearly means specific files.`;
24
24
  /**
25
25
  * 用 ModelProvider 做一次短 chat 的意图分流
@@ -11,6 +11,7 @@ import { join } from 'node:path';
11
11
  import { computeEffectiveRights } from '../../governance/session-acl/rights.js';
12
12
  import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
13
13
  import { formatHistoryRef, parseHistoryRef, messageText } from './types.js';
14
+ import { isChatReplayHidden } from '../../context/layer-types.js';
14
15
  import { applyRoleWeight, authorAllows, extractSearchableFields, makeSnippet, matchFields, sessionScore, } from './score.js';
15
16
  const gunzipAsync = promisify(gunzip);
16
17
  /**
@@ -55,6 +56,7 @@ export function resolveHistoryAccess(acl, session, agentId, agentMax) {
55
56
  writeMemory: true,
56
57
  canManageTasks: true,
57
58
  canHandoff: false,
59
+ toolRights: { allow: undefined, deny: [], denyCapabilities: [] },
58
60
  };
59
61
  const rights = computeEffectiveRights({
60
62
  role: { id: 'owner', defaults: ownerDefaults, max: ownerDefaults },
@@ -386,6 +388,15 @@ class DefaultSessionHistoryPort {
386
388
  visibleMessages(session, agentId) {
387
389
  const all = session.messages ?? [];
388
390
  const indexed = all.map((message, index) => ({ index, message }));
391
+ // 聊天回放隐藏面(turn_end 载体 / 托管 systemPrompt…)不得作为 user/system 命中露出——
392
+ // 与 observer / ConversationAdapter 同一谓词(layer-types isChatReplayHidden)
393
+ const visible = indexed.filter(({ message }) => !isChatReplayHidden({
394
+ role: message.role,
395
+ source: typeof message.metadata?.source === 'string'
396
+ ? String(message.metadata.source)
397
+ : undefined,
398
+ text: messageText(message),
399
+ }));
389
400
  const scope = this.options.historyScope ?? 'participated';
390
401
  if (scope === 'participated' && agentId) {
391
402
  const pick = {
@@ -400,7 +411,7 @@ class DefaultSessionHistoryPort {
400
411
  }
401
412
  const acl = this.options.sessionAcl;
402
413
  if (!acl || !agentId)
403
- return indexed;
414
+ return visible;
404
415
  const access = resolveHistoryAccess(acl, session, agentId, this.options.resolveAgentMax?.(agentId));
405
416
  if (!access)
406
417
  return [];
@@ -409,7 +420,7 @@ class DefaultSessionHistoryPort {
409
420
  case 'none':
410
421
  return [];
411
422
  case 'full':
412
- return indexed;
423
+ return visible;
413
424
  case 'from_grant': {
414
425
  const participant = access.participant;
415
426
  // 缺 seq/at 一律 fail-closed(E6)
@@ -417,12 +428,12 @@ class DefaultSessionHistoryPort {
417
428
  return [];
418
429
  }
419
430
  const at = participant.grantedAt;
420
- return indexed.filter(({ message }) => (message.timestamp ?? 0) >= at);
431
+ return visible.filter(({ message }) => (message.timestamp ?? 0) >= at);
421
432
  }
422
433
  case 'summary_tail':
423
- return indexed.slice(-20);
434
+ return visible.slice(-20);
424
435
  default:
425
- return indexed;
436
+ return visible;
426
437
  }
427
438
  }
428
439
  renderMessage(m, format, includeToolIo) {
@@ -13,6 +13,12 @@ export declare class InMemorySessionStore implements SessionStore<SessionData> {
13
13
  private sessions;
14
14
  load(sessionId: string): Promise<SessionData | null>;
15
15
  save(sessionId: string, data: SessionData): Promise<void>;
16
+ updateMetadata(sessionId: string, mutate: (meta: Record<string, unknown>) => void | Record<string, unknown>): Promise<void>;
17
+ /**
18
+ * 消息序列对齐。契约见 SessionStore.syncMessages;
19
+ * 内存后端直接替换消息数组(与 JsonlSessionStore 同口径:不存在则跳过)。
20
+ */
21
+ syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
16
22
  list(filter?: SessionListFilter): Promise<SessionMeta[]>;
17
23
  delete(sessionId: string): Promise<void>;
18
24
  exists(sessionId: string): Promise<boolean>;
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * @layer harness/session — Session 域纯内存默认实现(非生产落盘后端)。
8
8
  */
9
- import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
9
+ import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
10
10
  function toIndexPick(s) {
11
11
  return {
12
12
  agentId: s.agentId ?? s.meta.agentId,
@@ -19,10 +19,56 @@ function toIndexPick(s) {
19
19
  export class InMemorySessionStore {
20
20
  sessions = new Map();
21
21
  async load(sessionId) {
22
- return this.sessions.get(sessionId) ?? null;
22
+ const prev = this.sessions.get(sessionId);
23
+ if (!prev)
24
+ return null;
25
+ // 与 JsonlSessionStore.load 同口径:meta 是投影(标题三键权威在 metadata,
26
+ // updateMetadata 写后 load().meta 立即新鲜,与索引后端行为一致)
27
+ return { ...prev, meta: { ...prev.meta, ...readTitleState(prev.metadata) } };
23
28
  }
24
29
  async save(sessionId, data) {
25
- this.sessions.set(sessionId, { ...data, id: sessionId });
30
+ const prev = this.sessions.get(sessionId);
31
+ // 与 JsonlSessionStore 对齐:已有会话的 metadata 浅合并,删键走 updateMetadata
32
+ const metadata = {
33
+ ...(prev?.metadata ?? {}),
34
+ ...(data.metadata ?? {}),
35
+ };
36
+ // 与 JsonlSessionStore 对齐:标题三键按 titleUpdatedAt 仲裁,陈旧值不回滚更新写入;
37
+ // incoming 缺时间戳视为陈旧(写端恒打三键),同样归磁盘胜
38
+ const freshTitle = readTitleState(prev?.metadata);
39
+ const incomingTitle = readTitleState(data.metadata);
40
+ if (freshTitle.titleUpdatedAt !== undefined &&
41
+ (incomingTitle.titleUpdatedAt === undefined ||
42
+ incomingTitle.titleUpdatedAt < freshTitle.titleUpdatedAt)) {
43
+ metadata.title = freshTitle.title;
44
+ metadata.titleSource = freshTitle.titleSource;
45
+ metadata.titleUpdatedAt = freshTitle.titleUpdatedAt;
46
+ }
47
+ this.sessions.set(sessionId, { ...data, id: sessionId, metadata });
48
+ }
49
+ async updateMetadata(sessionId, mutate) {
50
+ const prev = this.sessions.get(sessionId);
51
+ if (!prev)
52
+ return;
53
+ const meta = { ...prev.metadata };
54
+ const replaced = mutate(meta);
55
+ this.sessions.set(sessionId, {
56
+ ...prev,
57
+ metadata: replaced === undefined ? meta : replaced,
58
+ });
59
+ }
60
+ /**
61
+ * 消息序列对齐。契约见 SessionStore.syncMessages;
62
+ * 内存后端直接替换消息数组(与 JsonlSessionStore 同口径:不存在则跳过)。
63
+ */
64
+ async syncMessages(sessionId, messages) {
65
+ const prev = this.sessions.get(sessionId);
66
+ if (!prev)
67
+ return;
68
+ this.sessions.set(sessionId, {
69
+ ...prev,
70
+ messages: messages.slice(),
71
+ });
26
72
  }
27
73
  async list(filter) {
28
74
  const values = Array.from(this.sessions.values());
@@ -33,6 +79,12 @@ export class InMemorySessionStore {
33
79
  primaryAgentId: s.primaryAgentId ?? s.meta.primaryAgentId,
34
80
  preferredAgentId: s.preferredAgentId ?? s.meta.preferredAgentId,
35
81
  participantAgentIds: toIndexPick(s).participantAgentIds,
82
+ // 与 JsonlSessionStore.buildIndexEntry 同规则:置顶权威在 metadata.pinnedAt
83
+ pinnedAt: typeof s.metadata?.pinnedAt === 'number' && Number.isFinite(s.metadata.pinnedAt)
84
+ ? s.metadata.pinnedAt
85
+ : s.meta.pinnedAt,
86
+ // 与 JsonlSessionStore.buildIndexEntry 同规则:标题权威在 metadata 三键(无旧数据回退)
87
+ ...readTitleState(s.metadata),
36
88
  }));
37
89
  }
38
90
  async delete(sessionId) {
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Session schedules — Agent 自发起定时(timer_* / schedule_*)
3
+ *
4
+ * 见 arch/session-schedules.md。
5
+ */
6
+ export { ACTIVE_SCHEDULE_STATUSES, TERMINAL_SCHEDULE_STATUSES, SCHEDULE_TRANSITIONS, assertTransition, canTransition, isScheduleActiveish, parseDurationMs, type ScheduleCatchUp, type ScheduleDelivery, type SessionSchedule, type SessionScheduleCreateInput, type SessionScheduleKind, type SessionSchedulePayload, type SessionScheduleStatus, } from './types.js';
7
+ export { SessionScheduleStore, buildScheduleRecord, type SessionScheduleStoreOptions, } from './store.js';
8
+ export { SessionScheduleService, parseFireAt, scheduleIsOpen, type SessionScheduleServiceOptions, type SessionScheduleWakeup, type SessionScheduleNotify, type ScheduleTimeSpec, } from './service.js';
9
+ export { renderSessionSchedulesInjection } from './render.js';
10
+ export { createSessionScheduleTools, createTimerWaitTool, createTimerCancelTool, createScheduleSetTool, createScheduleUpdateTool, createScheduleListTool, createScheduleCancelTool, createSchedulePauseTool, createScheduleResumeTool, type TimerWaitToolOptions, } from './tools.js';
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Session schedules — Agent 自发起定时(timer_* / schedule_*)
3
+ *
4
+ * 见 arch/session-schedules.md。
5
+ */
6
+ export { ACTIVE_SCHEDULE_STATUSES, TERMINAL_SCHEDULE_STATUSES, SCHEDULE_TRANSITIONS, assertTransition, canTransition, isScheduleActiveish, parseDurationMs, } from './types.js';
7
+ export { SessionScheduleStore, buildScheduleRecord, } from './store.js';
8
+ export { SessionScheduleService, parseFireAt, scheduleIsOpen, } from './service.js';
9
+ export { renderSessionSchedulesInjection } from './render.js';
10
+ export { createSessionScheduleTools, createTimerWaitTool, createTimerCancelTool, createScheduleSetTool, createScheduleUpdateTool, createScheduleListTool, createScheduleCancelTool, createSchedulePauseTool, createScheduleResumeTool, } from './tools.js';
@@ -0,0 +1,13 @@
1
+ /**
2
+ * SessionSchedule 注入渲染 — `<session_schedules>`
3
+ *
4
+ * 对齐 renderSessionTasksInjection;直接由 Service 查询结果渲染,不投影进 state.json。
5
+ */
6
+ import type { SessionSchedule } from './types.js';
7
+ /**
8
+ * 渲染 `<session_schedules>` 注入块。
9
+ *
10
+ * @param schedules - 本会话作业(含 active / paused)
11
+ * @returns 注入字符串;无未闭合作业时返回空串
12
+ */
13
+ export declare function renderSessionSchedulesInjection(schedules: SessionSchedule[]): string;
@@ -0,0 +1,63 @@
1
+ /**
2
+ * SessionSchedule 注入渲染 — `<session_schedules>`
3
+ *
4
+ * 对齐 renderSessionTasksInjection;直接由 Service 查询结果渲染,不投影进 state.json。
5
+ */
6
+ function formatWhen(ts) {
7
+ try {
8
+ return new Date(ts).toISOString();
9
+ }
10
+ catch {
11
+ return String(ts);
12
+ }
13
+ }
14
+ /**
15
+ * 渲染 `<session_schedules>` 注入块。
16
+ *
17
+ * @param schedules - 本会话作业(含 active / paused)
18
+ * @returns 注入字符串;无未闭合作业时返回空串
19
+ */
20
+ export function renderSessionSchedulesInjection(schedules) {
21
+ const open = schedules
22
+ .filter((s) => s.status === 'active' || s.status === 'paused')
23
+ .sort((a, b) => a.nextFireAt - b.nextFireAt || a.createdBy.at - b.createdBy.at);
24
+ if (open.length === 0)
25
+ return '';
26
+ const lines = [
27
+ '<session_schedules>',
28
+ '当前会话未闭合的定时作业:',
29
+ '',
30
+ ];
31
+ for (const s of open) {
32
+ const title = s.payload.title
33
+ ? `「${s.payload.title}」`
34
+ : `「${s.payload.text.slice(0, 40)}」`;
35
+ const rhythm = s.kind === 'once'
36
+ ? `once @ ${formatWhen(s.fireAt ?? s.nextFireAt)}`
37
+ : s.kind === 'interval'
38
+ ? `every ${s.intervalMs}ms`
39
+ : `cron ${s.cron ?? ''}`;
40
+ const runs = s.maxRuns !== undefined
41
+ ? `run ${s.runCount}/${s.maxRuns}`
42
+ : `run ${s.runCount}`;
43
+ const whenNote = s.status === 'paused'
44
+ ? 'paused,不会自动点火'
45
+ : `next ${formatWhen(s.nextFireAt)}`;
46
+ lines.push(`- [${s.id}] ${s.status} | ${rhythm} | ${runs} | ${whenNote} | ${title}`);
47
+ }
48
+ const hasActive = open.some((s) => s.status === 'active');
49
+ const hasPaused = open.some((s) => s.status === 'paused');
50
+ lines.push('');
51
+ lines.push('说明:');
52
+ if (hasActive) {
53
+ lines.push('- active 作业到点后系统会在本会话自动唤醒并执行事项正文。');
54
+ }
55
+ if (hasPaused) {
56
+ lines.push('- paused 作业**不会**自动点火;恢复请 schedule_resume,取消请 schedule_cancel。');
57
+ }
58
+ lines.push('- **禁止在当前回合执行上述事项**;现在只处理用户当前消息,或直接结束回合。');
59
+ lines.push('- 不必重复 schedule_set 同一事项,除非要改时间或内容。');
60
+ lines.push('- 事项已结束时请 schedule_cancel,避免继续点火。');
61
+ lines.push('</session_schedules>');
62
+ return lines.join('\n');
63
+ }
@@ -0,0 +1,179 @@
1
+ /**
2
+ * SessionScheduleService — 会话日程唯一写入口
3
+ *
4
+ * 职责:
5
+ * - schedules.db 读写与状态机校验
6
+ * - 薄 timer 臂(own setTimeout;禁止 import orchestration TaskScheduler)
7
+ * - 到点先记账再 dispatch Trigger(at-most-once)
8
+ *
9
+ * 见 arch/session-schedules.md。
10
+ */
11
+ import type { EventBus } from '@octopi-agent/core/primitives/event-bus.js';
12
+ import type { Trigger } from '../../activation/types.js';
13
+ import { type ScheduleCatchUp, type SessionSchedule, type SessionScheduleCreateInput, type SessionScheduleStatus } from './types.js';
14
+ import { type SessionScheduleStoreOptions } from './store.js';
15
+ /** Node setTimeout 最大 delay(2^31-1);超过会钳成 ~1ms 立刻点火 */
16
+ export declare const MAX_TIMEOUT_MS = 2147483647;
17
+ /** 点火回调:宿主接 AgentRuntime.dispatch;emit 非阻塞 */
18
+ export type SessionScheduleWakeup = (trigger: Trigger, schedule: SessionSchedule) => void;
19
+ /** notify 投递:只落会话消息,不跑模型 */
20
+ export type SessionScheduleNotify = (input: {
21
+ schedule: SessionSchedule;
22
+ content: string;
23
+ }) => void | Promise<void>;
24
+ export interface SessionScheduleServiceOptions extends SessionScheduleStoreOptions {
25
+ events?: EventBus;
26
+ /** 默认 50;0 = 不限制 */
27
+ maxOpenPerSession?: number;
28
+ /** 每小时 wakeup 上限;0 = 不限(默认 120) */
29
+ maxWakesPerHour?: number;
30
+ /** 兜底扫描间隔;0 = 关闭(默认 60s) */
31
+ tickIntervalMs?: number;
32
+ /** 同 coalesceKey 合并窗口;默认 500ms */
33
+ coalesceWindowMs?: number;
34
+ /** 点火后由宿主 dispatch(gateway 挂 AgentRuntime) */
35
+ wakeup?: SessionScheduleWakeup;
36
+ /** delivery=notify 时由宿主写入会话消息 */
37
+ notify?: SessionScheduleNotify;
38
+ }
39
+ /** schedule_set 时间参数(四选一) */
40
+ export interface ScheduleTimeSpec {
41
+ /** 相对延后,如 "2h" / 秒数 */
42
+ delay?: string | number;
43
+ /** 绝对 ISO 时间戳或毫秒 */
44
+ at?: string | number;
45
+ /** 固定间隔,如 "30m" */
46
+ every?: string | number;
47
+ /** 五字段 cron */
48
+ cron?: string;
49
+ }
50
+ /**
51
+ * 解析绝对时间
52
+ *
53
+ * @param at - ISO 字符串或毫秒时间戳;较小的数字按 Unix 秒解释
54
+ */
55
+ export declare function parseFireAt(at: string | number): number;
56
+ /**
57
+ * SessionScheduleService
58
+ */
59
+ export declare class SessionScheduleService {
60
+ private readonly options;
61
+ private timers;
62
+ private firing;
63
+ private opened;
64
+ private wakeup?;
65
+ private notify?;
66
+ private store?;
67
+ private tickTimer?;
68
+ /** 滑动窗口:近 1h wakeup 点火时间戳 */
69
+ private wakeStamps;
70
+ /** coalesceKey → 上次 dispatch 时间 */
71
+ private coalesceSeen;
72
+ constructor(options?: SessionScheduleServiceOptions);
73
+ /**
74
+ * 打开/建库并重臂 active 作业。幂等。
75
+ */
76
+ open(): Promise<void>;
77
+ /** 兜底扫描:防 timer 丢失(P1) */
78
+ private startTick;
79
+ /**
80
+ * 注入点火宿主(gateway 绑 AgentRuntime.dispatch)
81
+ *
82
+ * @param fn - 非阻塞 dispatch
83
+ */
84
+ setWakeup(fn: SessionScheduleWakeup): void;
85
+ /**
86
+ * 注入 notify 宿主(只写会话消息)
87
+ *
88
+ * @param fn - 写入回调
89
+ */
90
+ setNotify(fn: SessionScheduleNotify): void;
91
+ /** 拆光 timer 并关库(gateway.stop) */
92
+ dispose(): void;
93
+ private requireStore;
94
+ private emitEvent;
95
+ private resolveSpec;
96
+ private computeNextFireAt;
97
+ /**
98
+ * 列出作业
99
+ *
100
+ * @param sessionId - 会话 id
101
+ * @param filter - status / activeOnly
102
+ */
103
+ list(sessionId: string, filter?: {
104
+ status?: SessionScheduleStatus;
105
+ activeOnly?: boolean;
106
+ }): SessionSchedule[];
107
+ /**
108
+ * 按 id 取作业
109
+ *
110
+ * @param id - ScheduleId
111
+ */
112
+ get(id: string): SessionSchedule | null;
113
+ /**
114
+ * 登记作业并 arm
115
+ *
116
+ * @param input - 创建入参 + 时间四选一
117
+ */
118
+ set(input: {
119
+ sessionId: string;
120
+ agentId: string;
121
+ payload: SessionScheduleCreateInput['payload'];
122
+ maxRuns?: number;
123
+ coalesceKey?: string;
124
+ catchUp?: ScheduleCatchUp;
125
+ createdByRunId?: string;
126
+ } & ScheduleTimeSpec): Promise<SessionSchedule>;
127
+ /**
128
+ * 取消作业
129
+ *
130
+ * @param id - ScheduleId
131
+ */
132
+ cancel(id: string, _reason?: string): SessionSchedule;
133
+ /**
134
+ * 暂停
135
+ *
136
+ * @param id - ScheduleId
137
+ */
138
+ pause(id: string): SessionSchedule;
139
+ /**
140
+ * 恢复(re-arm 时套用 catchUp)
141
+ *
142
+ * @param id - ScheduleId
143
+ */
144
+ resume(id: string): SessionSchedule;
145
+ /**
146
+ * 修改作业(prompt / title / max_runs / 时间 / catch_up)
147
+ * 仅 active|paused;改时间后重算 nextFireAt 并 re-arm。
148
+ *
149
+ * @param id - ScheduleId
150
+ * @param patch - 可选字段
151
+ */
152
+ update(id: string, patch: {
153
+ prompt?: string;
154
+ title?: string;
155
+ maxRuns?: number | null;
156
+ catchUp?: ScheduleCatchUp;
157
+ time?: ScheduleTimeSpec;
158
+ }): SessionSchedule;
159
+ /**
160
+ * 会话删除清理
161
+ *
162
+ * @param sessionId - 会话 id
163
+ */
164
+ purgeSession(sessionId: string): number;
165
+ private disarm;
166
+ private arm;
167
+ private rearmAll;
168
+ /** 测试/手动触发(穿冷却语义:仅 active) */
169
+ runNow(id: string): Promise<void>;
170
+ private onDue;
171
+ private shouldCoalesce;
172
+ private noteCoalesce;
173
+ private wakeLimitExceeded;
174
+ private noteWake;
175
+ private toTrigger;
176
+ }
177
+ /** 未闭合判断(list/注入用) */
178
+ export declare function scheduleIsOpen(status: SessionScheduleStatus): boolean;
179
+ export type { ScheduleCatchUp };