mixdog 1.4.2 → 1.4.4

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 (474) hide show
  1. package/package.json +2 -2
  2. package/scripts/build-shipped-history.mjs +15 -5
  3. package/scripts/gate-local.mjs +65 -19
  4. package/scripts/graph-parity.mjs +8 -3
  5. package/scripts/lib/gate-scheduler.mjs +2 -1
  6. package/scripts/lib/run-node-tests.mjs +17 -5
  7. package/scripts/lib/test-failure-summary.mjs +1 -8
  8. package/scripts/lib/test-spawn-ledger.mjs +33 -2
  9. package/scripts/post-release-check.mjs +26 -16
  10. package/scripts/provider-pingpong-live.mjs +1 -1
  11. package/scripts/prune-embedding-runtime.mjs +3 -1
  12. package/scripts/release-paths.mjs +7 -1
  13. package/src/defaults/shipped-history.json +24 -0
  14. package/src/defaults/skills/computer-use/SKILL.md +14 -3
  15. package/src/defaults/skills/memory-management/SKILL.md +10 -5
  16. package/src/defaults/skills/setup/SKILL.md +2 -2
  17. package/src/defaults/skills/setup/references/actions.md +17 -4
  18. package/src/defaults/skills/setup/references/surfaces.md +3 -0
  19. package/src/defaults/skills/setup-guide/SKILL.md +6 -1
  20. package/src/lib/instruction-text.cjs +36 -0
  21. package/src/lib/rules-builder.cjs +34 -20
  22. package/src/orchestration/balanced.md +23 -0
  23. package/src/orchestration/focused.md +22 -0
  24. package/src/orchestration/none.md +5 -0
  25. package/src/orchestration/swarm.md +24 -0
  26. package/src/rules/agent-mode/AGENT_MODE.md +3 -1
  27. package/src/rules/agent-mode/MIXY.md +5 -3
  28. package/src/runtime/agent/orchestrator/agent-runtime/agent-dispatch/session-prep.mjs +3 -3
  29. package/src/runtime/agent/orchestrator/agent-runtime/agent-dispatch.mjs +0 -1
  30. package/src/runtime/agent/orchestrator/agent-runtime/agent-progress-watchdog.mjs +4 -2
  31. package/src/runtime/agent/orchestrator/agent-runtime/cache-strategy.mjs +0 -9
  32. package/src/runtime/agent/orchestrator/agent-runtime/heartbeat-completion.mjs +2 -2
  33. package/src/runtime/agent/orchestrator/agent-runtime/session-builder.mjs +67 -0
  34. package/src/runtime/agent/orchestrator/agent-trace-format.mjs +1 -0
  35. package/src/runtime/agent/orchestrator/context/role-instructions.mjs +4 -4
  36. package/src/runtime/agent/orchestrator/mcp/agent-connectors.mjs +3 -1
  37. package/src/runtime/agent/orchestrator/mcp/child-tree.mjs +199 -46
  38. package/src/runtime/agent/orchestrator/mcp/client-config.mjs +3 -5
  39. package/src/runtime/agent/orchestrator/mcp/client-transport.mjs +9 -3
  40. package/src/runtime/agent/orchestrator/mcp/client.mjs +3 -5
  41. package/src/runtime/agent/orchestrator/mcp/oauth-client.mjs +1 -1
  42. package/src/runtime/agent/orchestrator/mcp/oauth-credentials.mjs +8 -2
  43. package/src/runtime/agent/orchestrator/mcp/oauth-probe.mjs +1 -1
  44. package/src/runtime/agent/orchestrator/mcp/oauth-provider.mjs +14 -0
  45. package/src/runtime/agent/orchestrator/mcp/oauth.mjs +1 -1
  46. package/src/runtime/agent/orchestrator/providers/admission-scheduler.mjs +2 -1
  47. package/src/runtime/agent/orchestrator/providers/anthropic-api-request.mjs +11 -1
  48. package/src/runtime/agent/orchestrator/providers/anthropic-oauth-client-version.mjs +1 -1
  49. package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-events/content-block-start.mjs +4 -0
  50. package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-events/content-block-stop.mjs +3 -3
  51. package/src/runtime/agent/orchestrator/providers/anthropic-sse-turn/turn-outcome.mjs +2 -0
  52. package/src/runtime/agent/orchestrator/providers/anthropic-turn-result.mjs +2 -0
  53. package/src/runtime/agent/orchestrator/providers/anthropic.mjs +2 -0
  54. package/src/runtime/agent/orchestrator/providers/codex-client-meta.mjs +1 -1
  55. package/src/runtime/agent/orchestrator/providers/custom-provider-config.mjs +121 -9
  56. package/src/runtime/agent/orchestrator/providers/custom-provider.mjs +4 -1
  57. package/src/runtime/agent/orchestrator/providers/gemini-thinking.mjs +2 -2
  58. package/src/runtime/agent/orchestrator/providers/lib/generation-window.mjs +9 -0
  59. package/src/runtime/agent/orchestrator/providers/openai-compat-chat-send.mjs +9 -1
  60. package/src/runtime/agent/orchestrator/providers/openai-compat-chat-stream/stream-result.mjs +2 -0
  61. package/src/runtime/agent/orchestrator/providers/openai-compat-chat-stream/stream-state.mjs +5 -0
  62. package/src/runtime/agent/orchestrator/providers/openai-compat-options.mjs +3 -0
  63. package/src/runtime/agent/orchestrator/providers/openai-compat-response-normalization.mjs +6 -6
  64. package/src/runtime/agent/orchestrator/providers/openai-compat-responses-head-parity.json +2784 -2872
  65. package/src/runtime/agent/orchestrator/providers/openai-compat-responses.mjs +10 -1
  66. package/src/runtime/agent/orchestrator/providers/openai-compat-xai.mjs +5 -8
  67. package/src/runtime/agent/orchestrator/providers/openai-http-sse-response-state/response-events.mjs +3 -0
  68. package/src/runtime/agent/orchestrator/providers/openai-http-sse-response-state/response-outcome.mjs +2 -0
  69. package/src/runtime/agent/orchestrator/providers/openai-responses-payload-parity.fixture.json +288 -300
  70. package/src/runtime/agent/orchestrator/providers/openai-ws-response-state.mjs +9 -2
  71. package/src/runtime/agent/orchestrator/providers/openrouter-provider-routing.mjs +28 -0
  72. package/src/runtime/agent/orchestrator/providers/openrouter.mjs +4 -1
  73. package/src/runtime/agent/orchestrator/providers/registry.mjs +30 -25
  74. package/src/runtime/agent/orchestrator/providers/vertex-ai.mjs +10 -1
  75. package/src/runtime/agent/orchestrator/providers/xai-tool-search-head-parity.json +10 -30
  76. package/src/runtime/agent/orchestrator/runtime-core/ask-user-result.mjs +66 -0
  77. package/src/runtime/agent/orchestrator/runtime-core/builtin-features.mjs +30 -0
  78. package/src/runtime/agent/orchestrator/runtime-core/config-helpers.mjs +0 -11
  79. package/src/runtime/agent/orchestrator/runtime-core/deferred-tool-availability.mjs +8 -0
  80. package/src/runtime/agent/orchestrator/runtime-core/deferred-tool-delta.mjs +17 -3
  81. package/src/runtime/agent/orchestrator/runtime-core/goal-control.mjs +47 -27
  82. package/src/runtime/agent/orchestrator/runtime-core/goal-deadlines.mjs +141 -10
  83. package/src/runtime/agent/orchestrator/runtime-core/goal-mutations.mjs +26 -63
  84. package/src/runtime/agent/orchestrator/runtime-core/goal-reminder.mjs +28 -3
  85. package/src/runtime/agent/orchestrator/runtime-core/goal-runtime.mjs +36 -11
  86. package/src/runtime/agent/orchestrator/runtime-core/goal-state.mjs +88 -56
  87. package/src/runtime/agent/orchestrator/runtime-core/goal-storage.mjs +4 -1
  88. package/src/runtime/agent/orchestrator/runtime-core/goal-store.mjs +51 -32
  89. package/src/runtime/agent/orchestrator/runtime-core/goal-text.mjs +45 -145
  90. package/src/runtime/agent/orchestrator/runtime-core/goal-tool-defs.mjs +15 -98
  91. package/src/runtime/agent/orchestrator/runtime-core/goal-tool-exec.mjs +32 -99
  92. package/src/runtime/agent/orchestrator/runtime-core/goal-turns.mjs +23 -78
  93. package/src/runtime/agent/orchestrator/runtime-core/orchestration.mjs +69 -48
  94. package/src/runtime/agent/orchestrator/runtime-core/todo-list.mjs +367 -0
  95. package/src/runtime/agent/orchestrator/runtime-core/todo-tool-defs.mjs +47 -0
  96. package/src/runtime/agent/orchestrator/runtime-core/tool-availability.mjs +155 -0
  97. package/src/runtime/agent/orchestrator/runtime-core/tool-catalog-data.mjs +9 -0
  98. package/src/runtime/agent/orchestrator/runtime-core/tool-catalog.mjs +119 -35
  99. package/src/runtime/agent/orchestrator/runtime-core/tool-defs.mjs +1 -1
  100. package/src/runtime/agent/orchestrator/runtime-core/workflow/context.mjs +1 -1
  101. package/src/runtime/agent/orchestrator/session/agent-loop.mjs +28 -22
  102. package/src/runtime/agent/orchestrator/session/agent-pool-progress.mjs +30 -0
  103. package/src/runtime/agent/orchestrator/session/attachment-preflight.mjs +1 -1
  104. package/src/runtime/agent/orchestrator/session/cache-warm.mjs +2 -2
  105. package/src/runtime/agent/orchestrator/session/catalog-db/index.mjs +2 -2
  106. package/src/runtime/agent/orchestrator/session/catalog-db/schema.mjs +1 -1
  107. package/src/runtime/agent/orchestrator/session/compact/execution-tail.mjs +1 -1
  108. package/src/runtime/agent/orchestrator/session/compact/runner.mjs +3 -0
  109. package/src/runtime/agent/orchestrator/session/compact/summary-route.mjs +1 -1
  110. package/src/runtime/agent/orchestrator/session/context-utils.mjs +8 -12
  111. package/src/runtime/agent/orchestrator/session/conversation-import/claude.mjs +1 -1
  112. package/src/runtime/agent/orchestrator/session/conversation-import/codex.mjs +1 -1
  113. package/src/runtime/agent/orchestrator/session/conversation-import/convert.mjs +1 -1
  114. package/src/runtime/agent/orchestrator/session/conversation-import/imported-session.mjs +7 -3
  115. package/src/runtime/agent/orchestrator/session/human-gate/held-message.mjs +1 -1
  116. package/src/runtime/agent/orchestrator/session/human-gate/requests.mjs +1 -2
  117. package/src/runtime/agent/orchestrator/session/human-gate/run-policy.mjs +1 -1
  118. package/src/runtime/agent/orchestrator/session/image-strip-recovery.mjs +1 -1
  119. package/src/runtime/agent/orchestrator/session/loop/completion-guards.mjs +11 -1
  120. package/src/runtime/agent/orchestrator/session/loop/context-overflow.mjs +1 -1
  121. package/src/runtime/agent/orchestrator/session/loop/loop-state.mjs +8 -1
  122. package/src/runtime/agent/orchestrator/session/loop/no-tool-turn/todo-check.mjs +196 -0
  123. package/src/runtime/agent/orchestrator/session/loop/no-tool-turn.mjs +116 -50
  124. package/src/runtime/agent/orchestrator/session/loop/pre-dispatch-deny.mjs +8 -1
  125. package/src/runtime/agent/orchestrator/session/loop/provider-tool-exclusions.mjs +1 -1
  126. package/src/runtime/agent/orchestrator/session/loop/route-fallback.mjs +1 -1
  127. package/src/runtime/agent/orchestrator/session/loop/steering.mjs +3 -1
  128. package/src/runtime/agent/orchestrator/session/loop/stored-tool-args.mjs +5 -6
  129. package/src/runtime/agent/orchestrator/session/loop/tool-exec/before-hook.mjs +6 -1
  130. package/src/runtime/agent/orchestrator/session/loop/tool-exec/dispatch.mjs +16 -2
  131. package/src/runtime/agent/orchestrator/session/loop/turn-report.mjs +35 -0
  132. package/src/runtime/agent/orchestrator/session/loop/usage.mjs +1 -1
  133. package/src/runtime/agent/orchestrator/session/manager/ask-session.mjs +57 -26
  134. package/src/runtime/agent/orchestrator/session/manager/ask-turn-auto-effort.mjs +9 -7
  135. package/src/runtime/agent/orchestrator/session/manager/ask-turn-execute.mjs +21 -3
  136. package/src/runtime/agent/orchestrator/session/manager/ask-turn-failure.mjs +27 -11
  137. package/src/runtime/agent/orchestrator/session/manager/ask-turn-open.mjs +37 -34
  138. package/src/runtime/agent/orchestrator/session/manager/ask-turn-prepare.mjs +15 -0
  139. package/src/runtime/agent/orchestrator/session/manager/ask-turn-settle.mjs +25 -15
  140. package/src/runtime/agent/orchestrator/session/manager/ask-turn-state.mjs +79 -24
  141. package/src/runtime/agent/orchestrator/session/manager/ask-turn-steering-drain.mjs +3 -0
  142. package/src/runtime/agent/orchestrator/session/manager/compaction-runner.mjs +12 -1
  143. package/src/runtime/agent/orchestrator/session/manager/context-meta.mjs +1 -1
  144. package/src/runtime/agent/orchestrator/session/manager/idle-cleanup.mjs +6 -1
  145. package/src/runtime/agent/orchestrator/session/manager/pending-messages.mjs +9 -1
  146. package/src/runtime/agent/orchestrator/session/manager/pending-spool-path.mjs +2 -2
  147. package/src/runtime/agent/orchestrator/session/manager/pending-spool-shard.mjs +1 -1
  148. package/src/runtime/agent/orchestrator/session/manager/prompt-settings.mjs +598 -0
  149. package/src/runtime/agent/orchestrator/session/manager/prompt-utils.mjs +19 -0
  150. package/src/runtime/agent/orchestrator/session/manager/rules-cache.mjs +19 -10
  151. package/src/runtime/agent/orchestrator/session/manager/runtime-liveness.mjs +8 -1
  152. package/src/runtime/agent/orchestrator/session/manager/session-close.mjs +5 -0
  153. package/src/runtime/agent/orchestrator/session/manager/session-fallback-title.mjs +1 -1
  154. package/src/runtime/agent/orchestrator/session/manager/session-lifecycle.mjs +31 -0
  155. package/src/runtime/agent/orchestrator/session/manager/session-lock.mjs +31 -0
  156. package/src/runtime/agent/orchestrator/session/manager/session-prompt-composition.mjs +42 -6
  157. package/src/runtime/agent/orchestrator/session/manager/session-record.mjs +2 -0
  158. package/src/runtime/agent/orchestrator/session/manager/tool-resolution.mjs +11 -1
  159. package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-context.mjs +8 -9
  160. package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-journal.mjs +339 -88
  161. package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint-recovery.mjs +135 -11
  162. package/src/runtime/agent/orchestrator/session/manager/turn-checkpoint.mjs +377 -104
  163. package/src/runtime/agent/orchestrator/session/manager/turn-durability.mjs +144 -0
  164. package/src/runtime/agent/orchestrator/session/manager/turn-interruption.mjs +1 -1
  165. package/src/runtime/agent/orchestrator/session/manager/usage-metrics.mjs +4 -0
  166. package/src/runtime/agent/orchestrator/session/manager.mjs +6 -0
  167. package/src/runtime/agent/orchestrator/session/mixy-name.mjs +1 -1
  168. package/src/runtime/agent/orchestrator/session/pre-send-compact.mjs +8 -1
  169. package/src/runtime/agent/orchestrator/session/save-session-worker.mjs +5 -1
  170. package/src/runtime/agent/orchestrator/session/store/canonical-reader.mjs +1 -1
  171. package/src/runtime/agent/orchestrator/session/store/liveness-veto.mjs +2 -2
  172. package/src/runtime/agent/orchestrator/session/store/save-worker.mjs +23 -2
  173. package/src/runtime/agent/orchestrator/session/store/sweep/sub-agent-retention.mjs +3 -3
  174. package/src/runtime/agent/orchestrator/session/store/transcript-durability.mjs +88 -0
  175. package/src/runtime/agent/orchestrator/session/store-agent-worker-rows.mjs +5 -0
  176. package/src/runtime/agent/orchestrator/session/store-summary-log.mjs +1 -1
  177. package/src/runtime/agent/orchestrator/session/store-transcript-projection.mjs +14 -5
  178. package/src/runtime/agent/orchestrator/session/store-transcript-worker.mjs +2 -2
  179. package/src/runtime/agent/orchestrator/session/store.mjs +17 -6
  180. package/src/runtime/agent/orchestrator/session/synthetic-user-envelope.mjs +7 -1
  181. package/src/runtime/agent/orchestrator/session/tail-reminder-rules.mjs +9 -1
  182. package/src/runtime/agent/orchestrator/session/transcript-restore/agent-envelope.mjs +1 -1
  183. package/src/runtime/agent/orchestrator/session/transcript-restore/restore.mjs +3 -1
  184. package/src/runtime/agent/orchestrator/session/transcript-restore/user-text.mjs +2 -2
  185. package/src/runtime/agent/orchestrator/stall-policy.mjs +3 -5
  186. package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/backgrounded-result.mjs +4 -1
  187. package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/misuse-guard.mjs +21 -3
  188. package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/result-format.mjs +1 -1
  189. package/src/runtime/agent/orchestrator/tools/builtin/bash-tool/worktree-add-guard.mjs +77 -0
  190. package/src/runtime/agent/orchestrator/tools/builtin/bash-tool.mjs +0 -1
  191. package/src/runtime/agent/orchestrator/tools/builtin/git-command-tool.mjs +7 -3
  192. package/src/runtime/agent/orchestrator/tools/builtin/git-worktree-tool.mjs +27 -9
  193. package/src/runtime/agent/orchestrator/tools/builtin/lib/search-input-helpers.mjs +2 -2
  194. package/src/runtime/agent/orchestrator/tools/builtin/lib/shell-output-silence.mjs +64 -0
  195. package/src/runtime/agent/orchestrator/tools/builtin/lib/shell-task-output.mjs +20 -6
  196. package/src/runtime/agent/orchestrator/tools/builtin/read-range-index.mjs +1 -1
  197. package/src/runtime/agent/orchestrator/tools/builtin/read-single-fast-paths.mjs +0 -1
  198. package/src/runtime/agent/orchestrator/tools/builtin/search-tool.mjs +0 -10
  199. package/src/runtime/agent/orchestrator/tools/builtin/shell-jobs.mjs +1 -2
  200. package/src/runtime/agent/orchestrator/tools/builtin/task-tool.mjs +12 -1
  201. package/src/runtime/agent/orchestrator/tools/builtin.mjs +1 -24
  202. package/src/runtime/agent/orchestrator/tools/code-graph/graph-binary/child-kill.mjs +4 -3
  203. package/src/runtime/agent/orchestrator/tools/code-graph/graph-binary.mjs +1 -2
  204. package/src/runtime/agent/orchestrator/tools/code-graph/modes/calls.mjs +1 -1
  205. package/src/runtime/agent/orchestrator/tools/code-graph/modes/symbols.mjs +2 -2
  206. package/src/runtime/agent/orchestrator/tools/code-graph/search.mjs +4 -5
  207. package/src/runtime/agent/orchestrator/tools/code-graph/symbol-index.mjs +3 -4
  208. package/src/runtime/agent/orchestrator/tools/code-graph.mjs +4 -22
  209. package/src/runtime/agent/orchestrator/tools/lib/shell-descendants.mjs +2 -2
  210. package/src/runtime/agent/orchestrator/tools/lib/shell-run-state.mjs +1 -1
  211. package/src/runtime/agent/orchestrator/tools/shell-command.mjs +0 -4
  212. package/src/runtime/agent/orchestrator/tools/shell-policy.mjs +0 -1
  213. package/src/runtime/attachments/attachment-reference.mjs +1 -1
  214. package/src/runtime/attachments/pdf-extract.mjs +1 -1
  215. package/src/runtime/attachments/store.d.mts +1 -0
  216. package/src/runtime/attachments/store.mjs +2 -2
  217. package/src/runtime/channels/lib/config-reload-watch.mjs +42 -0
  218. package/src/runtime/channels/lib/owned-runtime/config-reload.mjs +29 -9
  219. package/src/runtime/channels/lib/routines-db.mjs +35 -0
  220. package/src/runtime/channels/lib/scheduler.mjs +33 -0
  221. package/src/runtime/channels/lib/schedules-db.mjs +15 -4
  222. package/src/runtime/channels/lib/webhook/session-dispatch.mjs +4 -1
  223. package/src/runtime/channels/lib/webhooks-db.mjs +13 -3
  224. package/src/runtime/channels/lib/whisper-server.mjs +12 -12
  225. package/src/runtime/channels/lib/worker-main.mjs +9 -31
  226. package/src/runtime/computer-bridge/action-schema.mjs +2 -2
  227. package/src/runtime/computer-bridge/core-actions.mjs +16 -2
  228. package/src/runtime/computer-bridge/linux-readiness.mjs +10 -14
  229. package/src/runtime/computer-bridge/result-canonical.mjs +6 -0
  230. package/src/runtime/connectors/connector-accounts-mcp.mjs +169 -33
  231. package/src/runtime/connectors/gmail-app-password.mjs +2 -2
  232. package/src/runtime/connectors/google-mcp.mjs +1 -1
  233. package/src/runtime/effort-judge/judge-client.mjs +2 -2
  234. package/src/runtime/effort-judge/judge-input.mjs +4 -4
  235. package/src/runtime/explore/explorer.mjs +0 -5
  236. package/src/runtime/explore/tool.mjs +3 -3
  237. package/src/runtime/local-provider/hardware.mjs +1 -1
  238. package/src/runtime/media/adapters/codex-image.mjs +3 -3
  239. package/src/runtime/media/adapters/gemini-video.mjs +1 -1
  240. package/src/runtime/media/media-usage.mjs +1 -1
  241. package/src/runtime/media/store.mjs +1 -1
  242. package/src/runtime/memory/index.mjs +11 -1
  243. package/src/runtime/memory/lib/embedding-reindex.mjs +27 -0
  244. package/src/runtime/memory/lib/memory-embed.mjs +83 -14
  245. package/src/runtime/memory/lib/memory-process-lock.mjs +159 -36
  246. package/src/runtime/memory/lib/memory-text-utils.mjs +6 -1
  247. package/src/runtime/memory/lib/memory.mjs +17 -0
  248. package/src/runtime/memory/lib/pg/process.mjs +1 -1
  249. package/src/runtime/memory/lib/pg/supervisor.mjs +16 -96
  250. package/src/runtime/memory/lib/recall-hybrid/hybrid-sql.mjs +12 -3
  251. package/src/runtime/memory/tool-defs.mjs +1 -1
  252. package/src/runtime/office/authoring/docx-html-runner.mjs +1 -1
  253. package/src/runtime/office/authoring/pptx-author-action.mjs +1 -1
  254. package/src/runtime/office/authoring/xlsx-html-build.mjs +1 -1
  255. package/src/runtime/office/authoring/xlsx-html-runner.mjs +1 -1
  256. package/src/runtime/office/capabilities.mjs +1 -1
  257. package/src/runtime/office/core/office-core.mjs +1 -1
  258. package/src/runtime/office/design/content-model.mjs +3 -3
  259. package/src/runtime/office/design/docx/design-docx/section.mjs +6 -6
  260. package/src/runtime/office/design/xlsx/design-xlsx-components.mjs +1 -1
  261. package/src/runtime/office/design/xlsx/design-xlsx.mjs +1 -1
  262. package/src/runtime/office/pdf/ocr-engine.mjs +1 -1
  263. package/src/runtime/office/pdf/pdf-writer.mjs +4 -4
  264. package/src/runtime/office/portable/portable-docx-operations.mjs +2 -2
  265. package/src/runtime/office/portable/portable-soffice.mjs +8 -6
  266. package/src/runtime/office/portable/xlsx-contract.mjs +1 -1
  267. package/src/runtime/shared/atomic-file.d.mts +8 -0
  268. package/src/runtime/shared/background-tasks.mjs +22 -4
  269. package/src/runtime/shared/background-wait.mjs +66 -0
  270. package/src/runtime/shared/child-guardian.mjs +17 -7
  271. package/src/runtime/shared/config.mjs +313 -16
  272. package/src/runtime/shared/connector-catalog.d.mts +4 -5
  273. package/src/runtime/shared/connector-catalog.mjs +11 -1
  274. package/src/runtime/shared/file-lock.mjs +8 -3
  275. package/src/runtime/shared/git-runner.mjs +7 -2
  276. package/src/runtime/shared/idle-gc.mjs +30 -7
  277. package/src/runtime/shared/llm/http-agent.mjs +8 -5
  278. package/src/runtime/shared/llm/system-proxy.mjs +2 -1
  279. package/src/runtime/shared/llm/usage-accounting.mjs +110 -19
  280. package/src/runtime/shared/llm/usage-context.mjs +1 -1
  281. package/src/runtime/shared/llm/usage-ledger-quota.mjs +33 -12
  282. package/src/runtime/shared/llm/usage-ledger-requests.mjs +183 -0
  283. package/src/runtime/shared/llm/usage-ledger-rollup.mjs +90 -10
  284. package/src/runtime/shared/llm/usage-ledger-worker.mjs +2 -0
  285. package/src/runtime/shared/llm/usage-ledger.mjs +60 -1
  286. package/src/runtime/shared/llm/usage-request-status.mjs +48 -0
  287. package/src/runtime/shared/llm/usage-rollup.mjs +48 -0
  288. package/src/runtime/shared/maintenance-schedule.mjs +109 -0
  289. package/src/runtime/shared/process-runner.mjs +8 -4
  290. package/src/runtime/shared/routine-trigger.d.mts +13 -0
  291. package/src/runtime/shared/routine-trigger.mjs +34 -0
  292. package/src/runtime/shared/run-child.d.mts +2 -1
  293. package/src/runtime/shared/run-child.mjs +70 -18
  294. package/src/runtime/shared/session-scratch.mjs +14 -2
  295. package/src/runtime/shared/shipped-definitions.mjs +7 -1
  296. package/src/runtime/shared/tool-card-model.golden.json +3 -12
  297. package/src/runtime/shared/tool-execution-contract.mjs +2 -0
  298. package/src/runtime/shared/tool-result-summary.mjs +1 -1
  299. package/src/runtime/shared/tool-work-units.mjs +31 -6
  300. package/src/runtime/shared/turn-snapshot.mjs +26 -4
  301. package/src/runtime/shared/turn-worktree-snapshot.mjs +6 -11
  302. package/src/runtime/shared/worker-requests.mjs +17 -3
  303. package/src/runtime/shared/worktrees/branch-management.mjs +1 -5
  304. package/src/runtime/shared/worktrees/contract.mjs +16 -6
  305. package/src/runtime/shared/worktrees/dependencies.mjs +127 -89
  306. package/src/runtime/shared/worktrees/disk.mjs +79 -2
  307. package/src/runtime/shared/worktrees/git.mjs +44 -11
  308. package/src/runtime/shared/worktrees/include.mjs +6 -4
  309. package/src/runtime/shared/worktrees/maintenance.mjs +422 -30
  310. package/src/runtime/shared/worktrees/manager.mjs +772 -75
  311. package/src/runtime/shared/worktrees/settings.mjs +33 -7
  312. package/src/runtime/shared/worktrees/test-support.mjs +5 -1
  313. package/src/runtime/shared/worktrees/worker-snapshots.mjs +82 -0
  314. package/src/runtime/tidy/process.mjs +2 -1
  315. package/src/runtime/web-search/index.mjs +3 -22
  316. package/src/runtime/web-search/lib/web-tools.mjs +2 -2
  317. package/src/runtime/web-search/tool-defs.mjs +17 -26
  318. package/src/session-runtime/agent-home-delivery.mjs +76 -8
  319. package/src/session-runtime/agent-profile-changes.mjs +55 -4
  320. package/src/session-runtime/agent-task-sessions.mjs +63 -22
  321. package/src/session-runtime/boot/apis.mjs +42 -4
  322. package/src/session-runtime/boot/begin.mjs +2 -0
  323. package/src/session-runtime/boot/config.mjs +10 -1
  324. package/src/session-runtime/boot/facade.mjs +1 -0
  325. package/src/session-runtime/boot/providers.mjs +70 -3
  326. package/src/session-runtime/boot/session.mjs +2 -0
  327. package/src/session-runtime/boot/tools.mjs +75 -25
  328. package/src/session-runtime/channel-config-api.mjs +1 -0
  329. package/src/session-runtime/config-change-effects.mjs +179 -0
  330. package/src/session-runtime/config-lifecycle/config-writers.mjs +1 -0
  331. package/src/session-runtime/config-lifecycle.mjs +160 -24
  332. package/src/session-runtime/conversation-import/discovery.mjs +86 -7
  333. package/src/session-runtime/conversation-import/service.mjs +3 -2
  334. package/src/session-runtime/goal-facade-api.mjs +49 -3
  335. package/src/session-runtime/internal-tool-executor/ask-user-tool.mjs +5 -57
  336. package/src/session-runtime/internal-tool-executor/bridge-tools.mjs +3 -2
  337. package/src/session-runtime/internal-tool-executor/feature-tools.mjs +3 -11
  338. package/src/session-runtime/internal-tool-executor/workspace-tools.mjs +18 -4
  339. package/src/session-runtime/internal-tool-executor.mjs +12 -19
  340. package/src/session-runtime/lifecycle/cold-heir.mjs +7 -0
  341. package/src/session-runtime/lifecycle/memory-ingest.mjs +3 -3
  342. package/src/session-runtime/lifecycle/session-switch/session-delete.mjs +53 -5
  343. package/src/session-runtime/lifecycle/session-switch.mjs +13 -2
  344. package/src/session-runtime/lifecycle/teardown/session-close.mjs +4 -4
  345. package/src/session-runtime/lifecycle-api.mjs +1 -0
  346. package/src/session-runtime/mcp-glue/server-catalog.mjs +14 -3
  347. package/src/session-runtime/mcp-glue/server-connection.mjs +34 -8
  348. package/src/session-runtime/model-route/route-persist.mjs +12 -4
  349. package/src/session-runtime/model-route/set-route.mjs +40 -7
  350. package/src/session-runtime/native-web-search/routes.mjs +3 -3
  351. package/src/session-runtime/provider-auth/refresh.mjs +6 -3
  352. package/src/session-runtime/provider-auth/setup.mjs +1 -1
  353. package/src/session-runtime/provider-models/row-hydration.mjs +2 -0
  354. package/src/session-runtime/provider-readiness.mjs +53 -4
  355. package/src/session-runtime/resource-api.mjs +1 -1
  356. package/src/session-runtime/resource-extension-sync.mjs +4 -8
  357. package/src/session-runtime/resource-mcp-connector-accounts.mjs +5 -1
  358. package/src/session-runtime/resource-mcp-secrets.mjs +3 -3
  359. package/src/session-runtime/resource-plugins-api.mjs +4 -0
  360. package/src/session-runtime/routine-executor.mjs +152 -0
  361. package/src/session-runtime/routine-home-turn.mjs +46 -5
  362. package/src/session-runtime/routine-owner.mjs +9 -3
  363. package/src/session-runtime/runtime-facade.mjs +5 -0
  364. package/src/session-runtime/runtime-feature-gates.mjs +2 -11
  365. package/src/session-runtime/schedule-session-run.mjs +1 -0
  366. package/src/session-runtime/services/agent-task-status.mjs +29 -1
  367. package/src/session-runtime/services/agent-tool/job-task-reconcile.mjs +6 -1
  368. package/src/session-runtime/services/agent-tool/job-views/session-progress.mjs +10 -0
  369. package/src/session-runtime/services/agent-tool/render.mjs +6 -1
  370. package/src/session-runtime/services/agent-tool/send-flow.mjs +110 -6
  371. package/src/session-runtime/services/agent-tool/spawn-flow/job-start.mjs +12 -0
  372. package/src/session-runtime/services/agent-tool/spawn-flow/spawn-plan.mjs +5 -0
  373. package/src/session-runtime/services/agent-tool/spawn-flow/spawn-run.mjs +24 -6
  374. package/src/session-runtime/services/agent-tool.mjs +51 -1
  375. package/src/session-runtime/services/channel-admin.mjs +62 -3
  376. package/src/session-runtime/services/hook-bus/command-handler.mjs +7 -11
  377. package/src/session-runtime/services/plugin-admin.mjs +50 -7
  378. package/src/session-runtime/services/provider-admin.mjs +5 -0
  379. package/src/session-runtime/services/seeds.mjs +7 -0
  380. package/src/session-runtime/services/usage-stats-model.mjs +32 -11
  381. package/src/session-runtime/session-create/materialize.mjs +4 -2
  382. package/src/session-runtime/session-create/session-options.mjs +2 -0
  383. package/src/session-runtime/settings-builtin-tools-api.mjs +1 -9
  384. package/src/session-runtime/setup-tool/agent-settings-actions.mjs +1 -1
  385. package/src/session-runtime/setup-tool/connector-widen-approval.mjs +1 -1
  386. package/src/session-runtime/setup-tool/executor.mjs +9 -2
  387. package/src/session-runtime/setup-tool/extended-actions.mjs +3 -1
  388. package/src/session-runtime/setup-tool/settings-contract.mjs +30 -2
  389. package/src/session-runtime/setup-tool/tool-defs.mjs +26 -1
  390. package/src/session-runtime/tool-policy/agent-profile-fold.mjs +40 -43
  391. package/src/session-runtime/tool-policy/mode-switch.mjs +1 -1
  392. package/src/session-runtime/tool-policy/policy-stage.mjs +106 -8
  393. package/src/session-runtime/tool-policy/workflow-overlay.mjs +2 -1
  394. package/src/session-runtime/tool-policy-refresh.mjs +182 -5
  395. package/src/session-runtime/tool-surface.mjs +38 -1
  396. package/src/session-runtime/turn/agent-ops.mjs +10 -2
  397. package/src/session-runtime/turn/session-ops.mjs +2 -0
  398. package/src/session-runtime/turn/turn-run/turn-prepare.mjs +5 -0
  399. package/src/session-runtime/turn/turn-run.mjs +1 -1
  400. package/src/session-runtime/usage-stats-api.mjs +117 -1
  401. package/src/session-runtime/webhook-session-run.mjs +2 -0
  402. package/src/session-runtime/workflow-agents-api/agent-connectors.mjs +37 -33
  403. package/src/session-runtime/workflow-agents-api/agent-editor.mjs +183 -23
  404. package/src/session-runtime/workflow-agents-api/agent-route.mjs +3 -10
  405. package/src/session-runtime/workflow-agents-api/instruction-files.mjs +165 -0
  406. package/src/session-runtime/workflow-agents-api/style-and-mode.mjs +5 -4
  407. package/src/session-runtime/workflow-agents-api/workflow-packs.mjs +2 -3
  408. package/src/session-runtime/workflow-agents-api.mjs +2 -0
  409. package/src/session-runtime/workspace/project-branches.mjs +1 -1
  410. package/src/session-runtime/workspace/session-view.mjs +1 -1
  411. package/src/session-runtime/workspace/transitions.mjs +20 -4
  412. package/src/session-runtime/workspace/worktree-maintenance.mjs +126 -6
  413. package/src/session-runtime/workspace/worktree-setup.mjs +13 -1
  414. package/src/session-runtime/workspace/worktree-tool.mjs +16 -0
  415. package/src/standalone/daemon-agent-control.mjs +25 -8
  416. package/src/standalone/daemon-desktop-runtime.mjs +6 -2
  417. package/src/standalone/daemon-lag-profiler.mjs +7 -7
  418. package/src/standalone/daemon.mjs +54 -2
  419. package/src/standalone/local-session-runtime.mjs +16 -0
  420. package/src/standalone/session-client/daemon-unavailable.mjs +1 -1
  421. package/src/standalone/session-protocol.mjs +12 -0
  422. package/src/standalone/session-service/agent-route-follow.mjs +23 -20
  423. package/src/standalone/session-service/agent-tree/agent-turns.mjs +18 -6
  424. package/src/standalone/session-service/quota-resume.mjs +9 -0
  425. package/src/standalone/session-service/retention/busy.mjs +3 -2
  426. package/src/standalone/session-service/session-calls/session-action.mjs +51 -1
  427. package/src/standalone/session-service/session-calls/session-turns.mjs +37 -18
  428. package/src/standalone/session-service/session-calls/turn-gate.mjs +34 -0
  429. package/src/standalone/session-service/session-calls.mjs +2 -1
  430. package/src/tui/App.jsx +8 -0
  431. package/src/tui/app/clipboard.mjs +1 -1
  432. package/src/tui/app/create-app-pickers.mjs +2 -0
  433. package/src/tui/app/doctor.mjs +2 -2
  434. package/src/tui/app/model-picker/model-footer.mjs +1 -1
  435. package/src/tui/app/model-picker/provider-models-list.mjs +7 -3
  436. package/src/tui/app/model-picker/route-selection/fast-parameters.mjs +23 -3
  437. package/src/tui/app/model-picker/route-selection.mjs +1 -0
  438. package/src/tui/app/panel-signature.mjs +1 -1
  439. package/src/tui/app/settings-picker.mjs +53 -8
  440. package/src/tui/app/shell-layout/row-budgets.mjs +2 -2
  441. package/src/tui/app/slash-commands.mjs +1 -1
  442. package/src/tui/app/slash-dispatch/route-commands.mjs +1 -1
  443. package/src/tui/app/slash-dispatch/session-commands.mjs +1 -1
  444. package/src/tui/app/use-prompt-queue-history.mjs +2 -2
  445. package/src/tui/app/use-transcript-activity.mjs +1 -1
  446. package/src/tui/app/use-transcript-window/geometry.mjs +1 -1
  447. package/src/tui/components/prompt-input/escape-policy.d.mts +0 -1
  448. package/src/tui/components/prompt-input/escape-policy.mjs +1 -1
  449. package/src/tui/components/question-panel-model.mjs +4 -4
  450. package/src/tui/components/tool-execution/standard-card.jsx +3 -4
  451. package/src/tui/components/user-message-skills.mjs +1 -1
  452. package/src/tui/dist/index.mjs +350 -37
  453. package/src/tui/markdown/render-ansi.mjs +1 -1
  454. package/src/tui/session/agent-job-feed/notification-router.mjs +10 -0
  455. package/src/tui/session/agent-job-feed.mjs +2 -0
  456. package/src/tui/session/context-state.mjs +3 -0
  457. package/src/tui/session/quota-resume.mjs +1 -1
  458. package/src/tui/session/session-api/integrations.mjs +3 -0
  459. package/src/tui/session/session-api/lifecycle/dispose.mjs +1 -0
  460. package/src/tui/session/session-api/lifecycle/session-reset.mjs +7 -0
  461. package/src/tui/session/session-api/routes-agent-definitions.mjs +5 -0
  462. package/src/tui/session/session-api/worktree.mjs +13 -1
  463. package/src/tui/session/session-flow/drain.mjs +11 -14
  464. package/src/tui/session/tool-approval-settle.mjs +24 -4
  465. package/src/tui/session/tool-approval.mjs +35 -10
  466. package/src/tui/session/tool-card-results/grouped-result.mjs +2 -2
  467. package/src/tui/session/turn-quiet.mjs +1 -1
  468. package/src/tui/session/turn.mjs +3 -0
  469. package/src/tui/session/worktree-setup-notice.mjs +1 -1
  470. package/src/tui/spinner-meta.mjs +3 -3
  471. package/src/tui/spinner-verbs.mjs +2 -2
  472. package/src/defaults/skills/goal-management/SKILL.md +0 -169
  473. package/src/runtime/agent/orchestrator/runtime-core/goal-tasks.mjs +0 -156
  474. package/src/session-runtime/goal-tasks.mjs +0 -1
@@ -1,4 +1,14 @@
1
- import { activeElapsedMs, assertSessionId, normalizeDeadlineWarnedMs, stopActiveClock } from './goal-state.mjs';
1
+ import {
2
+ GOAL_LIVE_HEARTBEAT_MS,
3
+ activeElapsedMs,
4
+ assertSessionId,
5
+ discardSuspendedTime,
6
+ normalizeDeadlineWarnedMs,
7
+ stopActiveClock,
8
+ } from './goal-state.mjs';
9
+
10
+ // Wall time may outrun the monotonic clock by a little without any suspend.
11
+ const MIN_SUSPEND_EVIDENCE_MS = 5_000;
2
12
 
3
13
  function normalizeDeadlineWarningMs(value) {
4
14
  const thresholds = (Array.isArray(value) ? value : [value])
@@ -9,10 +19,52 @@ function normalizeDeadlineWarningMs(value) {
9
19
 
10
20
  // Timers only observe crossings. Every durable transition joins the same
11
21
  // mutation queue as user edits and re-checks the current committed record.
12
- export function createGoalDeadlines({ now, readRecord, withMutation, commit, onStorageError, deadlineWarningMs }) {
22
+ export function createGoalDeadlines({
23
+ now,
24
+ readRecord,
25
+ withMutation,
26
+ commit,
27
+ stampLive,
28
+ onStorageError,
29
+ deadlineWarningMs,
30
+ monotonicNow = null,
31
+ // libuv's clock (Node's performance.now) stops during suspend on Linux and
32
+ // macOS (CLOCK_MONOTONIC, mach_absolute_time) but typically keeps counting
33
+ // on Windows (QueryPerformanceCounter), so there it proves nothing.
34
+ suspendDetectable = process.platform !== 'win32',
35
+ }) {
13
36
  const warningThresholdsMs = normalizeDeadlineWarningMs(deadlineWarningMs);
37
+ // Session -> wall and monotonic readings at the last moment the Goal was
38
+ // known to be running. Wall time that outran the monotonic clock since then
39
+ // is suspend: positive evidence. A stall of an awake process moves both
40
+ // clocks, so it is never dropped; without evidence time is counted, because
41
+ // overcounting is safer than a Goal running past its cap.
42
+ const anchors = new Map();
43
+ // Only a Goal that is still running keeps an anchor: an inactive one has its
44
+ // entry retired by armDeadline, and recording it again would leak.
45
+ const observe = (id, at, goal) => {
46
+ if (goal?.status !== 'active') return;
47
+ const mono = suspendDetectable ? monotonicNow?.() : null;
48
+ if (mono == null) anchors.delete(id);
49
+ else anchors.set(id, { wall: at, mono });
50
+ };
51
+ const suspendedMs = (id, at) => {
52
+ const anchor = anchors.get(id);
53
+ if (!anchor) return 0;
54
+ const mono = monotonicNow?.();
55
+ // No reading now: this interval has no evidence and is counted. The anchor
56
+ // goes too, or a later valid reading would discard time already counted.
57
+ if (mono == null) {
58
+ anchors.delete(id);
59
+ return 0;
60
+ }
61
+ const suspended = at - anchor.wall - (mono - anchor.mono);
62
+ return suspended > MIN_SUSPEND_EVIDENCE_MS ? suspended : 0;
63
+ };
64
+ const dropSuspended = (id, goal, at) => discardSuspendedTime(goal, at, suspendedMs(id, at));
14
65
  const deadlineTimers = new Map();
15
66
  const warningTimers = new Map();
67
+ const heartbeatTimers = new Map();
16
68
  const expiryPending = new Set();
17
69
  const warningPending = new Set();
18
70
  let closed = false;
@@ -30,25 +82,70 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
30
82
  }
31
83
  };
32
84
 
85
+ // The heartbeat has its own lifetime: re-arming the deadline (every snapshot
86
+ // read does) must not restart its interval, or reads under a minute apart
87
+ // would keep it from ever firing.
88
+ const stopHeartbeat = (sessionId) => {
89
+ const heartbeat = heartbeatTimers.get(sessionId);
90
+ if (heartbeat) {
91
+ clearInterval(heartbeat);
92
+ heartbeatTimers.delete(sessionId);
93
+ }
94
+ };
95
+
96
+ // An active Goal's clock runs only while a live runtime holds it. The beat
97
+ // re-stamps the record so a later load can tell how long nothing ran it; a
98
+ // beat that finds a long silence (the PC slept) drops that stretch from the
99
+ // open segment and republishes. The stamp alone is a silent write.
100
+ const beat = (sessionId) => {
101
+ const id = assertSessionId(sessionId);
102
+ void withMutation(id, async () => {
103
+ if (closed) return;
104
+ const goal = readRecord(id).goal;
105
+ if (goal?.status !== 'active' || !goal.lastStartedAt) return;
106
+ const at = now();
107
+ if (dropSuspended(id, goal, at)) await commit(id, goal);
108
+ else {
109
+ goal.liveAt = at;
110
+ await stampLive(id, goal);
111
+ }
112
+ observe(id, at, goal);
113
+ }).catch(onStorageError);
114
+ };
115
+
33
116
  const expiredProjection = (goal, at) => {
34
117
  if (goal?.status !== 'active' || !(goal.timeLimitMs > 0) || activeElapsedMs(goal, at) < goal.timeLimitMs)
35
118
  return false;
36
119
  stopActiveClock(goal, at);
37
120
  goal.status = 'duration_reached';
38
- goal.timeUsedMs = Math.max(goal.timeUsedMs, goal.timeLimitMs);
121
+ // The cap is what was spent; a late observation must not report more.
122
+ goal.timeUsedMs = goal.timeLimitMs;
39
123
  goal.updatedAt = at;
40
124
  return true;
41
125
  };
42
126
 
127
+ // Every path that reads an open segment against the clock (expiry, warnings,
128
+ // the next timer) first drops the suspended stretch, as the heartbeat does;
129
+ // otherwise a read after the PC slept would charge the sleep to the budget.
130
+ // `goal` is a working copy. Returns whether it changed.
131
+ const settleProjection = (id, goal, at) => {
132
+ const dropped = dropSuspended(id, goal, at);
133
+ return expiredProjection(goal, at) || dropped;
134
+ };
135
+
43
136
  const limitIfExpired = (sessionId) => {
44
137
  const id = assertSessionId(sessionId);
45
138
  const goal = readRecord(id).goal;
46
- if (expiredProjection(goal, now()) && !closed && !expiryPending.has(id)) {
139
+ if (settleProjection(id, goal, now()) && !closed && !expiryPending.has(id)) {
47
140
  expiryPending.add(id);
48
141
  void withMutation(id, async () => {
49
142
  if (closed) return;
50
143
  const current = readRecord(id).goal;
51
- if (expiredProjection(current, now())) await commit(id, current);
144
+ const at = now();
145
+ if (settleProjection(id, current, at)) {
146
+ await commit(id, current);
147
+ observe(id, at, current);
148
+ }
52
149
  })
53
150
  .catch(onStorageError)
54
151
  .finally(() => expiryPending.delete(id));
@@ -78,8 +175,9 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
78
175
  return delay;
79
176
  };
80
177
 
81
- const warningState = (goal, at) => {
178
+ const warningState = (id, goal, at) => {
82
179
  if (goal?.status !== 'active' || !goal.lastStartedAt || !(Number(goal.timeLimitMs) > 0)) return null;
180
+ dropSuspended(id, goal, at);
83
181
  const remainingMs = Math.max(0, Number(goal.timeLimitMs) - activeElapsedMs(goal, at));
84
182
  if (remainingMs <= 0) return null;
85
183
  return {
@@ -92,14 +190,14 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
92
190
  const deliverDeadlineWarning = (sessionId, thresholdMs = 0) => {
93
191
  const id = assertSessionId(sessionId);
94
192
  if (closed || warningPending.has(id)) return;
95
- const pending = warningState(readRecord(id).goal, now());
193
+ const pending = warningState(id, readRecord(id).goal, now());
96
194
  const target = thresholdMs || pending?.crossedMs || 0;
97
195
  if (!pending || !target || pending.crossedMs !== target) return;
98
196
  warningPending.add(id);
99
197
  void withMutation(id, async () => {
100
198
  if (closed) return;
101
199
  const current = readRecord(id).goal;
102
- const state = warningState(current, now());
200
+ const state = warningState(id, current, now());
103
201
  if (!state?.crossedMs || state.crossedMs !== target) return;
104
202
  current.deadlineWarnedMs = Math.min(normalizeDeadlineWarnedMs(current.deadlineWarnedMs), target);
105
203
  current.warningRevision = Math.max(0, Math.floor(Number(current.warningRevision) || 0)) + 1;
@@ -123,14 +221,26 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
123
221
  if (closed) return;
124
222
  clearDeadline(sessionId);
125
223
  const goal = readRecord(sessionId).goal;
224
+ if (goal?.status === 'active' && goal.lastStartedAt) {
225
+ if (!anchors.has(sessionId)) observe(sessionId, now(), goal);
226
+ if (!heartbeatTimers.has(sessionId)) {
227
+ const timer = setInterval(() => beat(sessionId), GOAL_LIVE_HEARTBEAT_MS);
228
+ timer.unref?.();
229
+ heartbeatTimers.set(sessionId, timer);
230
+ }
231
+ } else {
232
+ stopHeartbeat(sessionId);
233
+ anchors.delete(sessionId);
234
+ }
126
235
  if (goal?.status !== 'active' || !goal.lastStartedAt || !(Number(goal.timeLimitMs) > 0)) return;
127
236
  const at = now();
237
+ dropSuspended(sessionId, goal, at);
128
238
  const remainingMs = Math.max(0, goal.timeLimitMs - activeElapsedMs(goal, at));
129
239
  if (remainingMs <= 0) {
130
240
  queueMicrotask(() => reportingErrors(() => limitIfExpired(sessionId)));
131
241
  return;
132
242
  }
133
- const warnings = warningState(goal, at);
243
+ const warnings = warningState(sessionId, goal, at);
134
244
  if (warnings?.crossedMs) {
135
245
  const thresholdMs = warnings.crossedMs;
136
246
  queueMicrotask(() => reportingErrors(() => deliverDeadlineWarning(sessionId, thresholdMs)));
@@ -146,7 +256,19 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
146
256
  }
147
257
  const timer = setTimeout(() => {
148
258
  deadlineTimers.delete(sessionId);
149
- reportingErrors(() => limitIfExpired(sessionId));
259
+ // A timer that fires after the PC slept must not expire the Goal on
260
+ // time nobody ran: settle the suspension first, then decide.
261
+ reportingErrors(() => {
262
+ void withMutation(sessionId, async () => {
263
+ if (closed) return;
264
+ const current = readRecord(sessionId).goal;
265
+ const at = now();
266
+ if (current && settleProjection(sessionId, current, at)) {
267
+ await commit(sessionId, current);
268
+ observe(sessionId, at, current);
269
+ }
270
+ }).catch(onStorageError);
271
+ });
150
272
  }, remainingMs);
151
273
  timer.unref?.();
152
274
  deadlineTimers.set(sessionId, timer);
@@ -156,14 +278,23 @@ export function createGoalDeadlines({ now, readRecord, withMutation, commit, onS
156
278
  armDeadline,
157
279
  clearDeadline,
158
280
  limitIfExpired,
281
+ // A write is about to stamp `liveAt`: charge the pending suspend to the
282
+ // working copy first, so the stamp never hides it, and `refreshAnchor`
283
+ // starts the next evidence window once the write has landed.
284
+ settleSuspended: dropSuspended,
285
+ refreshAnchor: observe,
286
+ anchorCount: () => anchors.size,
159
287
  close() {
160
288
  closed = true;
161
289
  for (const timer of deadlineTimers.values()) clearTimeout(timer);
162
290
  deadlineTimers.clear();
163
291
  for (const timer of warningTimers.values()) clearTimeout(timer);
164
292
  warningTimers.clear();
293
+ for (const timer of heartbeatTimers.values()) clearInterval(timer);
294
+ heartbeatTimers.clear();
165
295
  warningPending.clear();
166
296
  expiryPending.clear();
297
+ anchors.clear();
167
298
  },
168
299
  };
169
300
  }
@@ -1,22 +1,18 @@
1
1
  /**
2
2
  * goal-mutations.mjs — the durable Goal state transitions: create, the
3
- * model/user status update (complete / blocked), task edits and abandon.
3
+ * model/user status update (complete / blocked) and abandon.
4
4
  * Each takes the shared runtime record (`ctx`) and commits through its store.
5
5
  */
6
6
  import { randomUUID } from 'node:crypto';
7
7
  import { join } from 'node:path';
8
8
 
9
9
  import { compactSessionTitle } from './session-title.mjs';
10
- import { GOAL_TASK_SETTLED } from './goal-tool-defs.mjs';
11
- import { applyGoalTaskChanges, normalizeGoalTasks } from './goal-tasks.mjs';
12
10
  import {
13
11
  GOAL_FILE_VERSION,
14
12
  NO_DEADLINE_WARNING_MS,
15
- activeElapsedMs,
16
13
  assertSessionId,
17
14
  checkpointActiveClock,
18
15
  clearTurnFailures,
19
- goalTimeMode,
20
16
  parseGoalDuration,
21
17
  publicGoal,
22
18
  stopActiveClock,
@@ -33,6 +29,13 @@ export function goalFinished(goal) {
33
29
  return FINISHED_STATUSES.includes(goal.status);
34
30
  }
35
31
 
32
+ /** A Goal that is neither running nor finished (paused, blocked, usage
33
+ * limited, time budget reached): it waits for the user, who may clear or
34
+ * replace it. */
35
+ export function goalStalled(goal) {
36
+ return Boolean(goal) && goal.status !== 'active' && !goalFinished(goal);
37
+ }
38
+
36
39
  /** Reject a write aimed at a Goal the caller no longer holds. */
37
40
  export function assertExpectedGoal(goal, expectedGoalId, what = 'update') {
38
41
  if (clean(expectedGoalId) && clean(expectedGoalId) !== clean(goal.id)) {
@@ -51,32 +54,18 @@ function initialTimeLimitMs(args, defaultTimeLimitMs) {
51
54
  function newGoalRecord(id, args, at, defaultTimeLimitMs) {
52
55
  const startTurn = args.startInCurrentTurn === true ? 1 : 0;
53
56
  const timeLimitMs = initialTimeLimitMs(args, defaultTimeLimitMs);
54
- const initialTasks = Array.isArray(args.tasks)
55
- ? normalizeGoalTasks(
56
- args.tasks.filter((task) => clean(task?.text)),
57
- [],
58
- { strict: true }
59
- )
60
- : [];
61
57
  return {
62
58
  id: randomUUID(),
63
- revision: 1,
64
- objectiveRevision: 1,
65
- tasksObjectiveRevision: 1,
66
59
  sessionId: id,
67
60
  objective: validateObjective(args.objective),
68
61
  title: compactSessionTitle(args.objective),
62
+ objectiveRevision: 0,
69
63
  status: 'active',
70
- tasks: initialTasks,
71
64
  blocker: '',
72
65
  failureReason: '',
73
66
  failureCount: 0,
74
67
  turnCount: startTurn,
75
- lastDropTurn: initialTasks.some((task) => task.status === 'dropped') ? startTurn : -1,
76
- tasksUpdatedAt: initialTasks.length > 0 ? at : null,
77
68
  timeLimitMs,
78
- // A stated budget commits that time; only an explicit cap permits early completion.
79
- timeMode: goalTimeMode(args.timeMode, timeLimitMs > 0 ? 'duration' : 'max'),
80
69
  timeUsedMs: 0,
81
70
  deadlineWarnedMs: NO_DEADLINE_WARNING_MS,
82
71
  warningRevision: 0,
@@ -88,37 +77,8 @@ function newGoalRecord(id, args, at, defaultTimeLimitMs) {
88
77
  };
89
78
  }
90
79
 
91
- // Evidence gates the MODEL's completion claim, never the user's. A user
92
- // completing their own Goal is an act of authority: without this the only
93
- // user-side exit was deleting the Goal, which threw the record away.
94
- // Unfinished rows stay unfinished so the record stays honest.
95
- function assertCompletionEvidence(goal, at) {
96
- if (goal.tasksObjectiveRevision !== goal.objectiveRevision) {
97
- throw new Error(
98
- 'cannot complete Goal: objective changed; read goal status and reconcile the full task list with set_tasks first'
99
- );
100
- }
101
- const tasks = normalizeGoalTasks(goal.tasks || []);
102
- const incomplete = tasks.filter((task) => !GOAL_TASK_SETTLED.includes(task.status));
103
- if (incomplete.length > 0) {
104
- throw new Error(`cannot complete Goal: ${incomplete.length} durable tasks remain incomplete`);
105
- }
106
- const turnCount = Math.max(0, Math.floor(Number(goal.turnCount) || 0));
107
- if (goal.lastDropTurn >= 0 && goal.lastDropTurn === turnCount) {
108
- throw new Error(
109
- 'cannot complete Goal: a task was dropped this turn; only a user scope change retires ' +
110
- 'requested work, so finish that work or let the user confirm the change first'
111
- );
112
- }
113
- if (goal.timeMode === 'duration' && goal.timeLimitMs > 0 && activeElapsedMs(goal, at) < goal.timeLimitMs) {
114
- throw new Error(
115
- 'cannot complete Goal before the requested duration ends; keep working, or the user may explicitly complete the Goal'
116
- );
117
- }
118
- }
119
-
120
80
  export function createGoalMutations(ctx) {
121
- const { root, now, defaultTimeLimitMs, turnGoalIds, turnStartedAt } = ctx;
81
+ const { root, now, defaultTimeLimitMs, turnGoalIds, turnStartedAt, turnObjectiveRevisions } = ctx;
122
82
 
123
83
  // The Goal owning the current turn keeps its open segment; any other stops.
124
84
  const settleActiveClock = (id, goal, at) => {
@@ -140,13 +100,14 @@ export function createGoalMutations(ctx) {
140
100
  const createGoal = async (sessionId, args = {}) => {
141
101
  const id = assertSessionId(sessionId);
142
102
  const record = ctx.readRecord(id);
143
- if (record.goal && !goalFinished(record.goal)) {
103
+ const replaced = goalStalled(record.goal) && args.replace === true;
104
+ if (record.goal && !goalFinished(record.goal) && !replaced) {
144
105
  // Recovery is part of the message on purpose: without it a stopped Goal
145
106
  // (paused/blocked/limited) permanently blocked every later Goal in the
146
107
  // session, because the model owns no way to retire one.
147
108
  throw new Error(
148
109
  `cannot create a new Goal while an unfinished Goal exists (status ${record.goal.status}); ` +
149
- 'resume and finish it, or abandon it if the user redirected away from that objective'
110
+ 'finish it, or ask the user to stop it from the Goal controls'
150
111
  );
151
112
  }
152
113
  const at = now();
@@ -154,17 +115,25 @@ export function createGoalMutations(ctx) {
154
115
  if (args.startInCurrentTurn === true) {
155
116
  goal.lastStartedAt = record.goal ? at : turnStartedAt.get(id) || at;
156
117
  }
118
+ if (replaced) {
119
+ // The user confirmed: the stalled Goal retires into history as stopped.
120
+ record.goal.status = 'stopped';
121
+ record.goal.stoppedAt = at;
122
+ record.goal.archivedAt = at;
123
+ record.goal.updatedAt = at;
124
+ }
157
125
  if (record.goal) await archiveFinishedGoal(id, record.goal);
158
126
  const created = await ctx.commit(id, goal);
159
127
  if (args.startInCurrentTurn === true) {
160
128
  turnGoalIds.set(id, goal.id);
161
129
  turnStartedAt.set(id, goal.lastStartedAt);
130
+ turnObjectiveRevisions.set(id, goal.objectiveRevision);
162
131
  }
163
132
  ctx.scheduleGoalTitle(id, goal);
164
133
  return created;
165
134
  };
166
135
 
167
- const updateGoal = async (sessionId, args = {}, { user = false, expectedGoalId = '' } = {}) => {
136
+ const updateGoal = async (sessionId, args = {}, { expectedGoalId = '' } = {}) => {
168
137
  const id = assertSessionId(sessionId);
169
138
  const goal = ctx.requireGoal(id);
170
139
  assertExpectedGoal(goal, expectedGoalId, 'update');
@@ -180,7 +149,8 @@ export function createGoalMutations(ctx) {
180
149
  throw new Error('a completed Goal cannot change status; edit it or create a new Goal');
181
150
  }
182
151
  if (status === 'complete') {
183
- if (!user) assertCompletionEvidence(goal, at);
152
+ // Completion is the model's claim after its own evidence audit (or
153
+ // the user's act of authority); the runtime never completes by itself.
184
154
  settleActiveClock(id, goal, at);
185
155
  goal.status = 'complete';
186
156
  goal.completedAt = at;
@@ -197,14 +167,6 @@ export function createGoalMutations(ctx) {
197
167
  return ctx.commit(id, goal);
198
168
  };
199
169
 
200
- const setGoalTasks = async (sessionId, args = {}, { expectedGoalId = '', partial = false } = {}) => {
201
- const id = assertSessionId(sessionId);
202
- const goal = ctx.requireGoal(id);
203
- assertExpectedGoal(goal, expectedGoalId, 'task update');
204
- applyGoalTaskChanges(goal, args, { partial, at: now() });
205
- return ctx.commit(id, goal);
206
- };
207
-
208
170
  // Explicit retirement of a superseded Goal. The create guard stays strict so
209
171
  // parallel Goals stay impossible; this is the one way out of it, and it is
210
172
  // deliberately an act the model has to take rather than a silent overwrite.
@@ -224,8 +186,9 @@ export function createGoalMutations(ctx) {
224
186
  if (archive) goal.archivedAt = goal.stoppedAt;
225
187
  await ctx.commit(id, goal);
226
188
  turnGoalIds.delete(id);
189
+ turnObjectiveRevisions.delete(id);
227
190
  return publicGoal(goal, now());
228
191
  };
229
192
 
230
- return { createGoal, updateGoal, setGoalTasks, abandonGoal };
193
+ return { createGoal, updateGoal, abandonGoal };
231
194
  }
@@ -13,6 +13,11 @@ import { resolvePluginData } from '../../../shared/plugin-paths.mjs';
13
13
  import { readStoredGoalSnapshot } from './goal-runtime.mjs';
14
14
  import { goalStateReminder } from './goal-text.mjs';
15
15
  import { clean } from './session-text.mjs';
16
+ import { todoContextBlock } from './todo-list.mjs';
17
+
18
+ // Stalled states the model is told about when they begin. Time-budget
19
+ // exhaustion has its own one-time closeout notice (deadline-reached).
20
+ const STALL_NOTICE_STATUSES = ['paused', 'blocked', 'usage_limited'];
16
21
 
17
22
  function pendingRevision(session) {
18
23
  return Math.max(0, Number(session?.pendingGoalReminder?.revision) || 0);
@@ -53,18 +58,38 @@ export function snapshotPendingGoalReminder(session, { dataDir = null, readGoal
53
58
  } catch {
54
59
  goal = null;
55
60
  }
61
+ if (goal?.status === 'complete') goal = null;
62
+ const marked = clean(session.pendingGoalReminder?.reason);
63
+ // A Goal that left the stalled states is told afresh if it stalls again.
64
+ if (!goal || goal.status === 'active') delete session.goalStalledNotice;
65
+ // A stalled Goal is told once, when it stalls; compaction does not
66
+ // re-inject it. Only a Goal that keeps running needs its state restored.
67
+ if (marked === 'compaction' && goal && goal.status !== 'active') goal = null;
68
+ // Compaction drops the todo tool results too: the open list rides once.
69
+ const todoBlock =
70
+ revision && marked === 'compaction'
71
+ ? todoContextBlock(session, 'Context was compacted; your todo list (exact wordings):')
72
+ : '';
56
73
  // Nothing left to remind about (no Goal, or it already finished): drop the
57
74
  // marker instead of re-reading the same file on every later turn.
58
- if (!goal || goal.status === 'complete') {
75
+ if (!goal && !todoBlock) {
59
76
  clearPendingGoalReminder(session);
60
77
  return null;
61
78
  }
62
79
  if (!revision) {
63
- if (!['paused', 'blocked'].includes(goal.status)) return null;
80
+ if (!STALL_NOTICE_STATUSES.includes(goal.status)) return null;
81
+ // One notice per stall: a later pause, block or limit of the same Goal
82
+ // (a turn ran in between) is a new stall.
83
+ const stall = `${goal.id}:${goal.status}:${Math.max(0, Number(goal.turnCount) || 0)}`;
84
+ if (session.goalStalledNotice === stall) return null;
85
+ session.goalStalledNotice = stall;
64
86
  revision = markPendingGoalReminder(session, goal.status).revision;
65
87
  }
66
88
  const reason = clean(session.pendingGoalReminder?.reason);
67
- const content = goalStateReminder(goal, { reason });
89
+ const goalContent = goal ? goalStateReminder(goal, { reason }) : '';
90
+ const content = [goalContent, todoBlock ? `<system-reminder>\n${todoBlock}\n</system-reminder>` : '']
91
+ .filter(Boolean)
92
+ .join('\n\n');
68
93
  if (!content) {
69
94
  clearPendingGoalReminder(session);
70
95
  return null;
@@ -29,12 +29,16 @@ export {
29
29
  MAX_GOAL_TIME_LIMIT_MS,
30
30
  parseGoalDuration,
31
31
  };
32
- export { GOAL_STATUS_VALUES } from './goal-state.mjs';
33
32
  export { listStoredActiveGoalSessionIds, readStoredGoalSnapshot } from './goal-storage.mjs';
34
33
 
35
34
  export function createGoalRuntime({
36
35
  dataDir,
37
- now = () => Date.now(),
36
+ now: injectedNow,
37
+ // Suspend evidence needs a monotonic clock paired with the wall clock. An
38
+ // injected `now` has no real pair, so a test supplies its own or none. A test
39
+ // that fakes `Date` must pass `monotonicNow: null` (undefined takes the default).
40
+ monotonicNow = injectedNow ? null : () => performance.now(),
41
+ suspendDetectable,
38
42
  defaultTimeLimitMs = DEFAULT_GOAL_TIME_LIMIT_MS,
39
43
  completedGoalTtlMs = DEFAULT_COMPLETED_GOAL_TTL_MS,
40
44
  deadlineWarningMs = DEFAULT_GOAL_DEADLINE_WARNING_MS,
@@ -42,6 +46,7 @@ export function createGoalRuntime({
42
46
  writeGoalRecord,
43
47
  onStorageError = reportGoalStorageError,
44
48
  } = {}) {
49
+ const now = injectedNow ?? (() => Date.now());
45
50
  const ctx = {
46
51
  dataDir,
47
52
  root: goalsRoot(dataDir),
@@ -55,15 +60,15 @@ export function createGoalRuntime({
55
60
  mutationChains: new Map(),
56
61
  turnGoalIds: new Map(),
57
62
  turnStartedAt: new Map(),
63
+ // Session -> the objective revision the current turn has seen (turn start,
64
+ // a status read, or a refusal that showed it). In memory like the turn.
65
+ turnObjectiveRevisions: new Map(),
58
66
  titleJobs: new Map(),
59
- observedGoals: new Map(),
60
- // Session -> the Goal identity, turn, and revision already answered with
61
- // no progress: the one settled-duration review, or an automatic turn that
62
- // called no tool. In memory on purpose: a restart is a new chance.
67
+ // Session -> the Goal identity and turn an automatic turn answered with no
68
+ // tool call. In memory on purpose: a restart is a new chance.
63
69
  idleReviewTurns: new Map(),
64
- // Session -> { goalId, revision, quietTurns }: which continuation tier this
65
- // context still owes, from the rules and state already delivered into it.
66
- // In memory on purpose: a restart is a fresh context that needs them again.
70
+ // Session -> id of the Goal whose full continuation rules this context
71
+ // already holds. In memory on purpose: a restart is a fresh context.
67
72
  continuationTiers: new Map(),
68
73
  // Session -> Goal id whose turn ended in a stop (failed, cancelled, usage
69
74
  // limit) the record could not save. The record still reads active, so
@@ -74,11 +79,14 @@ export function createGoalRuntime({
74
79
  Object.assign(ctx, createGoalStore(ctx));
75
80
  ctx.deadlines = createGoalDeadlines({
76
81
  now,
77
- readRecord: ctx.readRecord,
82
+ readRecord: ctx.readStoredRecord,
78
83
  withMutation: ctx.withMutation,
79
84
  commit: ctx.commit,
85
+ stampLive: ctx.stampLive,
80
86
  onStorageError,
81
87
  deadlineWarningMs,
88
+ monotonicNow,
89
+ ...(suspendDetectable !== undefined ? { suspendDetectable } : {}),
82
90
  });
83
91
  ctx.scheduleGoalTitle = createGoalTitleScheduler(ctx);
84
92
  Object.assign(ctx, createGoalMutations(ctx));
@@ -109,6 +117,23 @@ export function createGoalRuntime({
109
117
  return withMutation(sessionId, () => ctx.control(sessionId, args));
110
118
  },
111
119
  executeTool: (name, args = {}, context = {}) => executeGoalTool(ctx, name, args, context),
120
+ // Tasks a legacy record still carries for the session's todo list to
121
+ // adopt; [] once adopted (clearLegacyTasks).
122
+ legacyTasks(sessionId) {
123
+ try {
124
+ return ctx.readRecord(sessionId).goal?.legacyTasks || [];
125
+ } catch {
126
+ return [];
127
+ }
128
+ },
129
+ clearLegacyTasks(sessionId) {
130
+ return withMutation(sessionId, async (id) => {
131
+ const goal = ctx.readRecord(id).goal;
132
+ if (!goal?.legacyTasks?.length) return null;
133
+ goal.legacyTasks = [];
134
+ return ctx.commit(id, goal);
135
+ });
136
+ },
112
137
  ...createGoalTurnLifecycle(ctx),
113
138
  close() {
114
139
  ctx.closed = true;
@@ -117,7 +142,7 @@ export function createGoalRuntime({
117
142
  deadlines.close();
118
143
  ctx.turnGoalIds.clear();
119
144
  ctx.turnStartedAt.clear();
120
- ctx.observedGoals.clear();
145
+ ctx.turnObjectiveRevisions.clear();
121
146
  ctx.idleReviewTurns.clear();
122
147
  ctx.continuationTiers.clear();
123
148
  ctx.unsavedStops.clear();