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
@@ -4,38 +4,21 @@
4
4
  * should continue, and retiring finished work on the next user prompt.
5
5
  */
6
6
  import { continuationPrompt } from './goal-text.mjs';
7
- import { GOAL_TASK_SETTLED } from './goal-tool-defs.mjs';
8
7
  import {
9
8
  assertSessionId,
10
9
  checkpointActiveClock,
11
10
  clearTurnFailures,
12
- publicGoal,
13
11
  resumeGoalState,
14
- runningAgentWork,
15
12
  startActiveClock,
16
13
  stopActiveClock,
17
14
  } from './goal-state.mjs';
18
15
  import { goalFinished } from './goal-mutations.mjs';
19
- import { observeGoal } from './goal-tool-exec.mjs';
16
+ import { awaitingBackgroundWork } from '../../../shared/background-wait.mjs';
20
17
  import { clean } from '../../../shared/clean.mjs';
21
18
 
22
- // Every recorded task is settled while a requested duration still has time.
23
- // Completed rows neither complete the objective nor shorten its duration, so
24
- // this state must not loop the model over an unchanged list.
25
- function settledDurationWait(goal) {
26
- return (
27
- goal?.status === 'active' &&
28
- goal.timeMode === 'duration' &&
29
- goal.remainingMs > 0 &&
30
- !goal.needsTaskReview &&
31
- goal.tasks.length > 0 &&
32
- goal.tasks.every((task) => GOAL_TASK_SETTLED.includes(task.status))
33
- );
34
- }
35
-
36
- // The review is spent per Goal, turn, and actionable revision: a resumed,
37
- // re-scoped, or re-planned Goal earns a fresh one without any extra clearing.
38
- const idleReviewKey = (goal) => `${goal.id}:${goal.turnCount}:${goal.revision}`;
19
+ // The no-progress wait is spent per Goal and turn: the next user turn (or a
20
+ // resume, which starts a new turn) earns a fresh continuation.
21
+ const idleReviewKey = (goal) => `${goal.id}:${goal.turnCount}`;
39
22
 
40
23
  // An automatic turn that called no tool answered its prompt without progress.
41
24
  // Asking again over the same list only repeats that answer every few seconds
@@ -52,16 +35,8 @@ function automaticTurnWithoutActivity(detail, goal) {
52
35
 
53
36
  // Continuation prompts are enqueued as meta user messages, so a delivered rules
54
37
  // block stays in the transcript until the context is compacted or rewound. The
55
- // marker records which Goal's rules are already there: a new session or Goal, a
56
- // reconciliation the rules must frame, or an explicit reset re-sends them.
57
- function needsFullContinuationRules(markedGoalId, goal) {
58
- return markedGoalId !== goal.id || goal.needsTaskReview === true;
59
- }
60
-
61
- // A durable list drifts out of attention after roughly ten quiet turns — the
62
- // staleness cadence task-reminder surfaces settle on across the industry — so
63
- // the state block returns on that count rather than on an arbitrary period.
64
- const GOAL_STATE_REMINDER_QUIET_TURNS = 10;
38
+ // marker records which Goal's rules are already there: a new session or Goal,
39
+ // or an explicit reset (compaction, objective edit) re-sends them.
65
40
 
66
41
  /** Fold a settled turn's outcome (usage limit, cancel, failure, or a clean
67
42
  * finish) into the Goal status and clocks. */
@@ -103,7 +78,7 @@ function applyTurnOutcome(goal, detail, at) {
103
78
  if (goal.timeLimitMs > 0 && goal.timeUsedMs >= goal.timeLimitMs) {
104
79
  stopActiveClock(goal, at);
105
80
  goal.status = 'duration_reached';
106
- goal.timeUsedMs = Math.max(goal.timeUsedMs, goal.timeLimitMs);
81
+ goal.timeUsedMs = goal.timeLimitMs;
107
82
  }
108
83
  }
109
84
 
@@ -112,6 +87,7 @@ export function createGoalTurnLifecycle(ctx) {
112
87
  now,
113
88
  turnGoalIds,
114
89
  turnStartedAt,
90
+ turnObjectiveRevisions,
115
91
  idleReviewTurns,
116
92
  continuationTiers,
117
93
  unsavedStops,
@@ -129,22 +105,19 @@ export function createGoalTurnLifecycle(ctx) {
129
105
  if (!goal || goal.archivedAt) {
130
106
  turnGoalIds.delete(id);
131
107
  turnStartedAt.delete(id);
108
+ turnObjectiveRevisions.delete(id);
132
109
  return null;
133
110
  }
134
111
  const at = now();
135
112
  turnGoalIds.set(id, goal.id);
136
113
  turnStartedAt.set(id, at);
137
- observeGoal(ctx, id, publicGoal(goal, at));
114
+ turnObjectiveRevisions.set(id, goal.objectiveRevision);
138
115
  if (goal.status !== 'active') return visibleSnapshot(id);
139
116
  goal.turnCount = Math.max(0, Math.floor(Number(goal.turnCount) || 0)) + 1;
140
117
  startActiveClock(goal, at);
141
118
  goal.updatedAt = at;
142
- const published = await commit(id, goal);
143
- // A turn that starts from the settled duration wait IS that review, so
144
- // the next continuation waits instead of asking again unchanged.
145
- if (settledDurationWait(published)) idleReviewTurns.set(id, idleReviewKey(published));
146
- else idleReviewTurns.delete(id);
147
- return published;
119
+ idleReviewTurns.delete(id);
120
+ return commit(id, goal);
148
121
  });
149
122
  },
150
123
  settleTurn(sessionId, detail = {}) {
@@ -152,6 +125,7 @@ export function createGoalTurnLifecycle(ctx) {
152
125
  const expectedGoalId = turnGoalIds.get(id) || '';
153
126
  turnGoalIds.delete(id);
154
127
  turnStartedAt.delete(id);
128
+ turnObjectiveRevisions.delete(id);
155
129
  const goal = readRecord(id).goal;
156
130
  // commit() returns the record even when it is archived, so a settled
157
131
  // turn on retired work would republish the capsule the user's prompt
@@ -192,50 +166,21 @@ export function createGoalTurnLifecycle(ctx) {
192
166
  return commit(id, goal, options);
193
167
  });
194
168
  },
195
- continuation(sessionId, { agentStatus = null } = {}) {
169
+ // `todo`: the session's open step list, carried in every continuation.
170
+ continuation(sessionId, { agentStatus = null, todo = '' } = {}) {
196
171
  const goal = visibleSnapshot(sessionId);
197
172
  if (goal?.status !== 'active') return { run: false, reason: goal?.status || 'missing', goal };
198
- if (runningAgentWork(agentStatus)) return { run: false, reason: 'agent-running', goal };
199
173
  const id = assertSessionId(sessionId);
174
+ // The same wait rule as the todo completion check: a running agent or
175
+ // an awaited background shell wakes the session when it ends.
176
+ if (awaitingBackgroundWork({ sessionId: id, agentStatus })) return { run: false, reason: 'awaiting-work', goal };
200
177
  if (unsavedStops.get(id) === goal.id) return { run: false, reason: 'unsaved-stop', goal };
201
- const answered = idleReviewTurns.get(id) === idleReviewKey(goal);
202
- if (settledDurationWait(goal)) {
203
- // The model already answered this exact list with no new work, so the
204
- // deadline timer owns the rest of the wait and delivers closeout;
205
- // task/scope changes still publish and wake newly actionable work.
206
- if (answered) return { run: false, reason: 'duration-wait', goal };
207
- // One turn to spend the remaining duration on new work or to park
208
- // approval-dependent work: idling it away is not the requested wait.
209
- // This turn has to decide the rest of the duration, so it carries the
210
- // full rules that decision is judged against.
211
- continuationTiers.set(id, { goalId: goal.id, revision: goal.revision, quietTurns: 0 });
212
- return { run: true, reason: 'idle-review', goal, prompt: continuationPrompt(goal, { idleReview: true }) };
213
- }
214
- // The same wait for an unfinished list: a task change, a user turn, or
178
+ // An automatic turn already answered with no tool call: a user turn or
215
179
  // the deadline's closeout starts the next Goal turn.
216
- if (answered) return { run: false, reason: 'no-progress-wait', goal };
217
- const entry = continuationTiers.get(id);
218
- if (needsFullContinuationRules(entry?.goalId, goal)) {
219
- continuationTiers.set(id, { goalId: goal.id, revision: goal.revision, quietTurns: 0 });
220
- return { run: true, reason: 'idle', goal, prompt: continuationPrompt(goal) };
221
- }
222
- // A changed revision means the model mutated tasks last turn and holds
223
- // the fresh list in its own tool result; repeating it buys nothing. The
224
- // state block returns only once the list has gone unread long enough to
225
- // drift out of attention.
226
- const quietTurns = entry.revision === goal.revision ? entry.quietTurns + 1 : 0;
227
- const includeState = quietTurns >= GOAL_STATE_REMINDER_QUIET_TURNS;
228
- continuationTiers.set(id, {
229
- goalId: goal.id,
230
- revision: goal.revision,
231
- quietTurns: includeState ? 0 : quietTurns,
232
- });
233
- return {
234
- run: true,
235
- reason: 'idle',
236
- goal,
237
- prompt: continuationPrompt(goal, { includeRules: false, includeState }),
238
- };
180
+ if (idleReviewTurns.get(id) === idleReviewKey(goal)) return { run: false, reason: 'no-progress-wait', goal };
181
+ const includeRules = continuationTiers.get(id) !== goal.id;
182
+ continuationTiers.set(id, goal.id);
183
+ return { run: true, reason: 'idle', goal, prompt: continuationPrompt(goal, { includeRules, todo }) };
239
184
  },
240
185
  resetContinuationRules(sessionId) {
241
186
  continuationTiers.delete(assertSessionId(sessionId));
@@ -1,60 +1,81 @@
1
+ import { readFileSync, statSync } from 'node:fs';
2
+ import { join } from 'node:path';
1
3
  import { normalizeOrchestrationMode } from '../../../shared/orchestration.mjs';
2
-
3
- const BATCHING = {
4
- focused: `Lead executes the main scope directly. Delegate only substantial,
5
- self-contained supporting work, one agent per role; batch related tasks
6
- rather than splitting them for parallelism.`,
7
- balanced: `Delegate independent work by coherent feature or module, one agent per
8
- scope; a scope is one verifiable deliverable. Batch related tasks within the
9
- same change scope rather than splitting every file or step.`,
10
- swarm: `Delegate every independent scope to its own agent; a scope is one
11
- verifiable deliverable, not a bundle of steps. Treat disjoint file or
12
- module sets as independent and merge scopes only on a true output
13
- dependency.`,
14
- };
15
-
16
- const SOLO = `# Orchestration Mode: Solo
17
-
18
- Lead executes all work directly and never delegates on its own judgment.
19
- Only when the user explicitly asks for delegation, load the deferred \`agent\`
20
- tool and brief each agent as the Lead rules describe.`;
4
+ import { mixdogRoot, resolvePluginData } from '../../../shared/plugin-paths.mjs';
5
+ import { decodeInstructionFile } from '../../../../lib/instruction-text.cjs';
21
6
 
22
7
  /** Agent mode's fixed delegation block, in place of the orchestration mode. */
23
8
  export const AGENT_MODE_DELEGATION = `# Delegation
24
9
 
25
- Handle conversation yourself. Delegate specialised work to sub-agents. Hand
26
- substantial coding to a new agent task session (\`session create\`) with
27
- a self-contained brief: start it when already requested, otherwise suggest it. Then relay the
28
- result in your own words. Promise a follow-up only when the session result allows it.`;
10
+ Handle conversation yourself. Do quick lookups and small edits yourself. Hand
11
+ self-contained investigation, writing or implementation to sub-agents
12
+ (\`agent\`); their reports return to this chat. Open a new agent task session
13
+ (\`session create\`) only for a big plan, multi-step work across many files or
14
+ stages that needs its own Lead, with a self-contained brief: start it when
15
+ already requested, otherwise suggest it. Then relay the result in your own
16
+ words. Promise a follow-up only when the session result allows it.`;
29
17
 
30
18
  /** An agent-mode Lead's contact catalog intro: the user's other bots. */
31
19
  export const MIXY_CONTACTS_INTRO = `The user's other bots. Hand one a request with \`session send\` to its chat and a
32
20
  self-contained brief.`;
33
21
 
34
- export function orchestrationInstructions(value) {
22
+ const modeFileName = (mode) => `${normalizeOrchestrationMode(mode)}.md`;
23
+
24
+ /** The shipped mode file (<root>/orchestration/<mode>.md). */
25
+ export const shippedOrchestrationPath = (mode) => join(mixdogRoot(), 'orchestration', modeFileName(mode));
26
+ /** The user's replacement (<data>/orchestration/<mode>.md). */
27
+ export const userOrchestrationPath = (mode) => join(resolvePluginData(), 'orchestration', modeFileName(mode));
28
+
29
+ // A file's text (CRLF → LF, trailing whitespace trimmed), null when it does not
30
+ // exist, or { problem } when it cannot serve as the prompt (instruction-text.cjs).
31
+ // promptRulesRevision reads every mode on each check, so a read is reused while
32
+ // the file's identity (mtime, ctime, inode, size) is unchanged — but only once
33
+ // the file is older than the timestamp granularity: a file written moments ago
34
+ // can change again within the same tick without any of those moving.
35
+ const SETTLED_MS = 2000;
36
+ const fileCache = new Map();
37
+ export function readInstructionFile(file) {
38
+ let stat;
39
+ try {
40
+ stat = statSync(file);
41
+ } catch (error) {
42
+ return error?.code === 'ENOENT' || error?.code === 'ENOTDIR' ? null : { problem: 'unreadable' };
43
+ }
44
+ const key = `${stat.mtimeMs}:${stat.ctimeMs}:${stat.ino}:${stat.size}`;
45
+ const hit = fileCache.get(file);
46
+ if (hit?.key === key && hit.settled) return hit.value;
47
+ let value;
48
+ try {
49
+ if (!stat.isFile()) value = { problem: 'unreadable' };
50
+ else {
51
+ const decoded = decodeInstructionFile(readFileSync(file));
52
+ value = decoded.problem ? decoded : { text: decoded.text.replace(/\r\n/g, '\n').trimEnd() };
53
+ }
54
+ } catch {
55
+ value = { problem: 'unreadable' };
56
+ }
57
+ fileCache.set(file, { key, value, settled: Date.now() - stat.mtimeMs > SETTLED_MS });
58
+ return value;
59
+ }
60
+
61
+ /**
62
+ * Where a mode's text comes from: the user's file when it is usable, else the
63
+ * shipped one. `problem` says why a user file that exists was passed over
64
+ * (empty, too-large, not-text, unreadable); `text` is the prompt text.
65
+ */
66
+ function orchestrationModeSource(value) {
35
67
  const mode = normalizeOrchestrationMode(value);
36
- if (mode === 'none') return SOLO;
37
- // Focused already says Lead executes the main scope directly.
38
- const oneScope =
39
- mode === 'focused' ? '' : '\nIf the plan has only one implementation scope, Lead executes it directly.';
40
- return `# Orchestration Mode: ${mode[0].toUpperCase()}${mode.slice(1)}
41
-
42
- ${BATCHING[mode]}
43
-
44
- The mode sets how work splits; an agent's description sets its role and when
45
- it runs. Splitting applies to every role alike — implementation, review,
46
- investigation, writing — by file, module, commit range or risk area.${oneScope}
47
-
48
- Delegation is for work whose size justifies a brief. When the brief would have
49
- to spell out the edits themselves — a few localized changes whose sites Lead
50
- already holds — Lead makes them directly in every mode; the number of files or
51
- scopes does not change this.
52
-
53
- Dispatch all ready independent scopes in one turn. Only a scope that requires
54
- another's output waits. At most two building or testing scopes run at
55
- once.
56
- A new independent need goes to a new agent. When scopes touch the same file, name one owner for
57
- that file in each brief.
58
- Use only available agents; when none fits a role, Lead does that work itself
59
- and never changes settings to enable one.`;
68
+ const user = readInstructionFile(userOrchestrationPath(mode));
69
+ if (user?.text) return { mode, source: 'user', text: user.text };
70
+ const shipped = readInstructionFile(shippedOrchestrationPath(mode));
71
+ return {
72
+ mode,
73
+ source: 'default',
74
+ text: shipped?.text ?? '',
75
+ ...(user?.problem ? { problem: user.problem } : {}),
76
+ };
77
+ }
78
+
79
+ export function orchestrationInstructions(value) {
80
+ return orchestrationModeSource(value).text;
60
81
  }
@@ -0,0 +1,367 @@
1
+ // The per-owner step list behind the `todo` tool. One list lives on each
2
+ // session record (`session.todo`: the Lead session, and each agent session),
3
+ // so it is saved with the session, survives a daemon restart and compaction,
4
+ // and is never shared between a Lead and its agents.
5
+ //
6
+ // Every mutation replaces `session.todo` with a new object: the published
7
+ // snapshot is memoized by that identity, and change listeners republish it.
8
+ import { emitSessionActivityChange } from '../../../shared/session-activity-signal.mjs';
9
+ import { MAX_TODO_ITEMS, MAX_TODO_TEXT_LENGTH, TODO_OPS, TODO_STATUSES } from './todo-tool-defs.mjs';
10
+
11
+ const DEFAULT_TODO_PHASE = 'Tasks';
12
+ const OPEN_STATUSES = new Set(['pending', 'in_progress']);
13
+ const listeners = new Set();
14
+ const snapshots = new WeakMap();
15
+
16
+ const oneLine = (value) =>
17
+ String(value ?? '')
18
+ .replace(/\s+/g, ' ')
19
+ .trim();
20
+
21
+ function itemText(value, what = 'item') {
22
+ const text = oneLine(value);
23
+ if (!text) throw new Error(`todo: ${what} wording is required`);
24
+ if ([...text].length > MAX_TODO_TEXT_LENGTH) {
25
+ throw new Error(`todo: ${what} exceeds ${MAX_TODO_TEXT_LENGTH} characters`);
26
+ }
27
+ return text;
28
+ }
29
+
30
+ function normalizeTask(raw) {
31
+ if (!raw || typeof raw !== 'object') return null;
32
+ const content = oneLine(raw.content);
33
+ if (!content) return null;
34
+ const status = TODO_STATUSES.includes(raw.status) ? raw.status : 'pending';
35
+ const task = { content, status };
36
+ if (status === 'blocked' && oneLine(raw.blocker)) task.blocker = oneLine(raw.blocker);
37
+ if (oneLine(raw.note)) task.note = oneLine(raw.note);
38
+ return task;
39
+ }
40
+
41
+ /** The session's phases, normalized (stored records are untrusted). */
42
+ export function todoPhases(session) {
43
+ const phases = Array.isArray(session?.todo?.phases) ? session.todo.phases : [];
44
+ return phases
45
+ .map((phase) => ({
46
+ name: oneLine(phase?.name) || DEFAULT_TODO_PHASE,
47
+ tasks: (Array.isArray(phase?.tasks) ? phase.tasks : []).map(normalizeTask).filter(Boolean),
48
+ }))
49
+ .filter((phase) => phase.tasks.length > 0);
50
+ }
51
+
52
+ const allTasks = (phases) => phases.flatMap((phase) => phase.tasks);
53
+
54
+ /** Exactly one in_progress while actionable work exists: several keep the
55
+ * earliest, none starts the earliest pending. Blocked never starts itself. */
56
+ function normalizeTodoPhases(phases) {
57
+ const tasks = allTasks(phases);
58
+ const active = tasks.filter((task) => task.status === 'in_progress');
59
+ for (const task of active.slice(1)) task.status = 'pending';
60
+ if (active.length === 0) {
61
+ const next = tasks.find((task) => task.status === 'pending');
62
+ if (next) next.status = 'in_progress';
63
+ }
64
+ return phases.filter((phase) => phase.tasks.length > 0);
65
+ }
66
+
67
+ function todoCounts(phases) {
68
+ const tasks = allTasks(phases);
69
+ return {
70
+ completed: tasks.filter((task) => task.status === 'completed').length,
71
+ abandoned: tasks.filter((task) => task.status === 'abandoned').length,
72
+ total: tasks.length,
73
+ };
74
+ }
75
+
76
+ /** Pending and in-progress items: the work the completion check asks about. */
77
+ export function openTodoItems(session) {
78
+ return allTasks(todoPhases(session)).filter((task) => OPEN_STATUSES.has(task.status));
79
+ }
80
+
81
+ /** Every item not completed or dropped (blocked included): what an agent
82
+ * leaves undone when it ends. */
83
+ export function unfinishedTodoItems(session) {
84
+ return allTasks(todoPhases(session)).filter((task) => task.status !== 'completed' && task.status !== 'abandoned');
85
+ }
86
+
87
+ /** The published session snapshot; null for an empty list. Identity-stable
88
+ * while the list is unchanged. */
89
+ export function todoSnapshot(session) {
90
+ const record = session?.todo;
91
+ if (!record || typeof record !== 'object') return null;
92
+ if (snapshots.has(record)) return snapshots.get(record);
93
+ const phases = todoPhases(session);
94
+ const snapshot = phases.length ? { phases, ...todoCounts(phases) } : null;
95
+ snapshots.set(record, snapshot);
96
+ return snapshot;
97
+ }
98
+
99
+ /** Agent status rows: `{ completed, total, current? }`, or null. */
100
+ export function todoProgress(session) {
101
+ const snapshot = todoSnapshot(session);
102
+ if (!snapshot) return null;
103
+ const current = allTasks(snapshot.phases).find((task) => task.status === 'in_progress')?.content;
104
+ // Rows show completed/total directly, so dropped items leave the total.
105
+ return {
106
+ completed: snapshot.completed,
107
+ total: snapshot.total - snapshot.abandoned,
108
+ ...(current ? { current } : {}),
109
+ };
110
+ }
111
+
112
+ export function onTodoChange(listener) {
113
+ if (typeof listener !== 'function') return () => {};
114
+ listeners.add(listener);
115
+ return () => listeners.delete(listener);
116
+ }
117
+
118
+ /** A list with items, every one completed or dropped. */
119
+ export function todoAllClosed(session) {
120
+ return todoPhases(session).length > 0 && unfinishedTodoItems(session).length === 0;
121
+ }
122
+
123
+ /** Let go of the session's list. */
124
+ export function clearTodo(session, at = Date.now()) {
125
+ session.todo = null;
126
+ session.updatedAt = at;
127
+ publish(session);
128
+ }
129
+
130
+ function commitPhases(session, phases, at = Date.now()) {
131
+ session.todo = { phases, updatedAt: at };
132
+ session.updatedAt = at;
133
+ publish(session);
134
+ }
135
+
136
+ function publish(session) {
137
+ // The Agents pool shows each agent's progress: it re-reads on this pulse.
138
+ emitSessionActivityChange(session.id || '');
139
+ for (const listener of [...listeners]) {
140
+ try {
141
+ listener({ sessionId: session.id || null, todo: todoSnapshot(session) });
142
+ } catch {
143
+ /* a listener never breaks the tool */
144
+ }
145
+ }
146
+ }
147
+
148
+ const MARKS = { completed: 'x', in_progress: '>', pending: ' ', blocked: '!', abandoned: '-' };
149
+
150
+ function progressLabel(phases) {
151
+ const { completed, abandoned, total } = todoCounts(phases);
152
+ return `${completed}/${total - abandoned}`;
153
+ }
154
+
155
+ /** The whole list as text: init/view replies and context re-injection. */
156
+ function renderTodoList(phases) {
157
+ if (!phases.length) return 'todo: empty';
158
+ const lines = [progressLabel(phases)];
159
+ for (const phase of phases) {
160
+ lines.push(phase.name);
161
+ for (const task of phase.tasks) {
162
+ const detail = task.blocker ? ` — blocked: ${task.blocker}` : task.note ? ` — ${task.note}` : '';
163
+ lines.push(` [${MARKS[task.status]}] ${task.content}${detail}`);
164
+ }
165
+ }
166
+ return lines.join('\n');
167
+ }
168
+
169
+ function summaryLine(phases, op, content) {
170
+ const tasks = allTasks(phases);
171
+ const parts = [progressLabel(phases), `${op}: ${content}`];
172
+ const current = tasks.find((task) => task.status === 'in_progress');
173
+ if (current) parts.push(`next: ${current.content}`);
174
+ else if (tasks.some((task) => task.status === 'blocked')) parts.push('next: none (blocked items wait)');
175
+ else parts.push('all closed');
176
+ return parts.join(' · ');
177
+ }
178
+
179
+ function initPhases(args) {
180
+ let source;
181
+ if (Array.isArray(args.phases) && args.phases.length) source = args.phases;
182
+ else if (Array.isArray(args.items) && args.items.length) {
183
+ source = [{ name: oneLine(args.phase) || DEFAULT_TODO_PHASE, items: args.items }];
184
+ } else throw new Error('todo: init requires items or phases');
185
+ const seen = new Set();
186
+ const phaseNames = new Set();
187
+ const phases = source.map((entry) => {
188
+ const name = itemText(entry?.name, 'phase');
189
+ if (phaseNames.has(name)) throw new Error(`todo: duplicate phase "${name}"`);
190
+ phaseNames.add(name);
191
+ const items = Array.isArray(entry?.items) ? entry.items : [];
192
+ if (!items.length) throw new Error(`todo: phase "${name}" has no items`);
193
+ return {
194
+ name,
195
+ tasks: items.map((raw) => {
196
+ const content = itemText(raw);
197
+ if (seen.has(content)) throw new Error(`todo: duplicate item "${content}"`);
198
+ seen.add(content);
199
+ return { content, status: 'pending' };
200
+ }),
201
+ };
202
+ });
203
+ if (seen.size > MAX_TODO_ITEMS) throw new Error(`todo: at most ${MAX_TODO_ITEMS} items`);
204
+ return phases;
205
+ }
206
+
207
+ function findTask(phases, rawContent) {
208
+ const content = oneLine(rawContent);
209
+ if (!content) throw new Error('todo: item (its exact wording) is required');
210
+ for (const phase of phases) {
211
+ const index = phase.tasks.findIndex((task) => task.content === content);
212
+ if (index >= 0) return { phase, index, task: phase.tasks[index] };
213
+ }
214
+ throw new Error(`todo: no item "${content}"; view the list for exact wordings`);
215
+ }
216
+
217
+ const OPS = {
218
+ start(phases, args) {
219
+ const { task } = findTask(phases, args.item);
220
+ if (task.status === 'completed') throw new Error(`todo: "${task.content}" is completed and stays closed`);
221
+ if (task.status === 'blocked') throw new Error(`todo: "${task.content}" is blocked; unblock it first`);
222
+ for (const other of allTasks(phases)) if (other.status === 'in_progress') other.status = 'pending';
223
+ task.status = 'in_progress';
224
+ return task.content;
225
+ },
226
+ done(phases, args) {
227
+ const { task } = findTask(phases, args.item);
228
+ task.status = 'completed';
229
+ delete task.blocker;
230
+ const note = oneLine(args.note);
231
+ if (note) task.note = note;
232
+ return task.content;
233
+ },
234
+ drop(phases, args) {
235
+ const { task } = findTask(phases, args.item);
236
+ if (task.status === 'completed') throw new Error(`todo: "${task.content}" is completed and stays closed`);
237
+ task.status = 'abandoned';
238
+ delete task.blocker;
239
+ return task.content;
240
+ },
241
+ block(phases, args) {
242
+ const { task } = findTask(phases, args.item);
243
+ if (task.status === 'completed' || task.status === 'abandoned') {
244
+ throw new Error(`todo: "${task.content}" is ${task.status}; only open items can block`);
245
+ }
246
+ task.status = 'blocked';
247
+ task.blocker = itemText(args.reason, 'block reason');
248
+ return task.content;
249
+ },
250
+ unblock(phases, args) {
251
+ const { task } = findTask(phases, args.item);
252
+ if (task.status !== 'blocked') throw new Error(`todo: "${task.content}" is not blocked`);
253
+ task.status = 'pending';
254
+ delete task.blocker;
255
+ return task.content;
256
+ },
257
+ append(phases, args) {
258
+ const items = Array.isArray(args.items) ? args.items.map((raw) => itemText(raw)) : [];
259
+ if (!items.length) throw new Error('todo: append requires items');
260
+ const existing = new Set(allTasks(phases).map((task) => task.content));
261
+ for (const content of items) {
262
+ if (existing.has(content)) throw new Error(`todo: item "${content}" already exists`);
263
+ existing.add(content);
264
+ }
265
+ if (existing.size > MAX_TODO_ITEMS) throw new Error(`todo: at most ${MAX_TODO_ITEMS} items`);
266
+ const name = oneLine(args.phase) || phases.at(-1)?.name || DEFAULT_TODO_PHASE;
267
+ let phase = phases.find((candidate) => candidate.name === name);
268
+ if (!phase) {
269
+ phase = { name, tasks: [] };
270
+ phases.push(phase);
271
+ }
272
+ phase.tasks.push(...items.map((content) => ({ content, status: 'pending' })));
273
+ return items.join(', ');
274
+ },
275
+ rm(phases, args) {
276
+ const { phase, index, task } = findTask(phases, args.item);
277
+ phase.tasks.splice(index, 1);
278
+ return task.content;
279
+ },
280
+ };
281
+
282
+ /** Run one `todo` call against the owner session. Returns the reply text. */
283
+ export function executeTodoTool(session, args = {}) {
284
+ if (!session || typeof session !== 'object') throw new Error('todo: no session owns this call');
285
+ const op = oneLine(args?.op).toLowerCase();
286
+ if (!TODO_OPS.includes(op)) throw new Error(`todo: op must be one of ${TODO_OPS.join(', ')}`);
287
+ if (op === 'view') return renderTodoList(todoPhases(session));
288
+ if (op === 'init') {
289
+ // Replacing a list that still has unfinished work would silently erase it
290
+ // (a follow-up ask re-initing mid-request): make the model close each first.
291
+ const unfinished = unfinishedTodoItems(session);
292
+ if (unfinished.length) {
293
+ const named = unfinished.slice(0, 5).map((task) => `"${task.content}"`);
294
+ if (unfinished.length > named.length) named.push(`${unfinished.length - named.length} more`);
295
+ throw new Error(
296
+ `todo: init would erase unfinished items (${named.join(', ')}); done or drop each first, or append to add asks`
297
+ );
298
+ }
299
+ const phases = normalizeTodoPhases(initPhases(args));
300
+ commitPhases(session, phases);
301
+ return renderTodoList(phases);
302
+ }
303
+ const phases = structuredClone(todoPhases(session));
304
+ if (!phases.length) throw new Error('todo: the list is empty; init it first');
305
+ const content = OPS[op](phases, args);
306
+ const next = normalizeTodoPhases(phases);
307
+ commitPhases(session, next);
308
+ return summaryLine(next, op, content);
309
+ }
310
+
311
+ /** Lines naming what an agent leaves undone, '' when nothing is. */
312
+ export function notDoneReport(session) {
313
+ const unfinished = unfinishedTodoItems(session);
314
+ if (!unfinished.length) return '';
315
+ return [
316
+ 'Not done:',
317
+ ...unfinished.map((task) => `- ${task.content}${task.blocker ? ` (blocked: ${task.blocker})` : ''}`),
318
+ ].join('\n');
319
+ }
320
+
321
+ /** The open list as a hidden reminder (after compaction, or appended to a
322
+ * Goal continuation); '' when nothing is open. */
323
+ export function todoContextBlock(session, lead = 'Open todo items (exact wordings):', { whole = false } = {}) {
324
+ const phases = todoPhases(session);
325
+ if (!phases.length) return '';
326
+ if (!whole && !allTasks(phases).some((task) => task.status !== 'completed' && task.status !== 'abandoned')) {
327
+ return '';
328
+ }
329
+ return ['<todo_state>', lead, renderTodoList(phases), '</todo_state>'].join('\n');
330
+ }
331
+
332
+ // Legacy Goal task statuses as todo statuses.
333
+ const LEGACY_GOAL_TASK_STATUS = {
334
+ pending: 'pending',
335
+ in_progress: 'in_progress',
336
+ completed: 'completed',
337
+ dropped: 'abandoned',
338
+ awaiting_approval: 'blocked',
339
+ };
340
+
341
+ /** Move a legacy Goal record's tasks into the session's list (once; the Goal
342
+ * record drops them afterwards). Items already listed keep their state. */
343
+ export function adoptLegacyGoalTasks(session, legacyTasks) {
344
+ if (!session || !Array.isArray(legacyTasks) || !legacyTasks.length) return false;
345
+ const phases = structuredClone(todoPhases(session));
346
+ const existing = new Set(allTasks(phases).map((task) => task.content));
347
+ const adopted = [];
348
+ for (const raw of legacyTasks) {
349
+ // Migrated wording stays whole (old tasks allowed longer text); the
350
+ // length limit applies only to newly authored items.
351
+ const content = oneLine(raw?.text ?? raw?.content);
352
+ if (!content || existing.has(content)) continue;
353
+ existing.add(content);
354
+ const status = LEGACY_GOAL_TASK_STATUS[oneLine(raw?.status).toLowerCase()] || 'pending';
355
+ adopted.push(status === 'blocked' ? { content, status, blocker: 'awaiting user approval' } : { content, status });
356
+ }
357
+ if (!adopted.length) return false;
358
+ const name = phases.length ? 'Goal' : DEFAULT_TODO_PHASE;
359
+ let phase = phases.find((candidate) => candidate.name === name);
360
+ if (!phase) {
361
+ phase = { name, tasks: [] };
362
+ phases.push(phase);
363
+ }
364
+ phase.tasks.push(...adopted);
365
+ commitPhases(session, normalizeTodoPhases(phases));
366
+ return true;
367
+ }