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
@@ -33,7 +33,7 @@ const MD_SYNTAX_RE = /[#*`|[>\-_~]|\n\n|(?:^|\n)\d+[.)] |(?:^|\n)\+ |(?:^|\n)={2
33
33
 
34
34
  // GFM strikethrough, pair-only. marked's default `del` also accepts a SINGLE
35
35
  // tilde, which turns approximation prose ("~100", "1~2개") into struck text —
36
- // the reason this tokenizer used to be disabled outright. Requiring `~~` keeps
36
+ // so the default tokenizer cannot be used as is. Requiring `~~` keeps
37
37
  // real strikethrough working and lockstep with the desktop pipeline
38
38
  // (remark-gfm singleTilde:false).
39
39
  const DEL_RE = /^~~(?=[^\s~])([\s\S]*?[^\s~])~~(?!~)/;
@@ -2,6 +2,10 @@ import { parseAgentJob } from '../agent-envelope.mjs';
2
2
  import { notificationQueueKey, resolveTuiRuntimeNotificationDelivery } from '../notification-plan.mjs';
3
3
  import { isTerminalExecutionStatus } from './agent-status-refresh.mjs';
4
4
 
5
+ // The runtime's setup-changed action after an empty session's settings
6
+ // reconcile (session-runtime/boot/tools.mjs CONTEXT_STATUS_REFRESHED_ACTION).
7
+ const CONTEXT_STATUS_REFRESHED = 'context_status_refreshed';
8
+
5
9
  // Routes one runtime notification by its delivery plan: UI-only kinds patch
6
10
  // the store or raise a notice, execution envelopes go through the execution
7
11
  // delivery, everything else becomes a model-visible task notification.
@@ -13,6 +17,7 @@ export function createNotificationRouter({
13
17
  statusRefresh,
14
18
  executionDelivery,
15
19
  modelNotification,
20
+ refreshContextStats = null,
16
21
  getAdmission = () => 'open',
17
22
  }) {
18
23
  let uiOpenSeq = 0;
@@ -20,6 +25,11 @@ export function createNotificationRouter({
20
25
  const uiActions = {
21
26
  'setup-ui': (delivery) => set({ setupUiRequest: { id: delivery.id, at: Date.now() } }),
22
27
  'setup-changed': (delivery) => {
28
+ // An empty session took moved settings: the context gauge re-reads.
29
+ if (delivery.setupAction === CONTEXT_STATUS_REFRESHED) {
30
+ refreshContextStats?.();
31
+ return;
32
+ }
23
33
  // Monotonic like ui-open: consecutive changes by the same action must
24
34
  // each refresh the attached surfaces.
25
35
  setupChangeSeq += 1;
@@ -37,6 +37,7 @@ export function createAgentJobFeed({
37
37
  displayedExecutionNotificationKeys,
38
38
  itemIndexById,
39
39
  pushNotice,
40
+ refreshContextStats = null,
40
41
  now = () => Date.now(),
41
42
  executionResumeTombstoneTtlMs = 30_000,
42
43
  executionResumeTombstoneLimit = 128,
@@ -79,6 +80,7 @@ export function createAgentJobFeed({
79
80
  statusRefresh,
80
81
  executionDelivery,
81
82
  modelNotification,
83
+ refreshContextStats,
82
84
  getAdmission,
83
85
  });
84
86
 
@@ -7,6 +7,7 @@
7
7
  */
8
8
  import { contextMeasurementStats } from '../../runtime/shared/context-measurement.mjs';
9
9
  import { goalStateSnapshot } from '../../runtime/agent/orchestrator/runtime-core/goal-state.mjs';
10
+ import { todoSnapshot } from '../../runtime/agent/orchestrator/runtime-core/todo-list.mjs';
10
11
 
11
12
  export function createContextState({
12
13
  runtime,
@@ -92,6 +93,8 @@ export function createContextState({
92
93
  // The daemon-queued quota resume of this session id (identity-stable while
93
94
  // unchanged), so a resume or session switch republishes it with the route.
94
95
  quotaResume: typeof getQuotaResume === 'function' ? getQuotaResume() : null,
96
+ // The session's own step list (identity-stable while unchanged); null when empty.
97
+ todo: todoSnapshot(runtime.session),
95
98
  });
96
99
 
97
100
  const routeState = () => {
@@ -57,7 +57,7 @@ export function latestQuotaFailure(items) {
57
57
 
58
58
  /** The turn key of the failed turndone that ends the transcript, when no
59
59
  * later turn has begun; '' otherwise. */
60
- export function latestFailedTurnKey(items) {
60
+ function latestFailedTurnKey(items) {
61
61
  const transcript = Array.isArray(items) ? items : [];
62
62
  for (let index = transcript.length - 1; index >= 0; index -= 1) {
63
63
  const item = transcript[index];
@@ -35,6 +35,9 @@ export function createSessionIntegrationsApi(bag, { oauthFlows }) {
35
35
  getUsageStats: async (options = {}) => {
36
36
  return await runtime.getUsageStats?.(options);
37
37
  },
38
+ getUsageRequests: async (options = {}) => {
39
+ return await runtime.getUsageRequests?.(options);
40
+ },
38
41
  getQuotaHistory: async (options = {}) => {
39
42
  return await runtime.getQuotaHistory?.(options);
40
43
  },
@@ -34,6 +34,7 @@ export function createDisposeAction(bag, { oauthFlows }) {
34
34
  'unsubscribeCompletionWakeGate',
35
35
  'unsubscribeGitHeadWatch',
36
36
  'unsubscribeWorktreeSetup',
37
+ 'unsubscribeTodo',
37
38
  ]) {
38
39
  try {
39
40
  lifecycle[key]?.();
@@ -122,6 +122,13 @@ export function createSessionResetActions(bag) {
122
122
  throw error;
123
123
  }
124
124
  }),
125
+ // The desktop's auto-delete (session-delete.mjs deleteSessionIfIdle): never
126
+ // the current session, so no reset of this one's view.
127
+ deleteSessionIfIdle: async (id, expected, guards) => {
128
+ const result = await runtime.deleteSessionIfIdle(id, expected, guards);
129
+ if (result?.deleted === true) bag.supersedeQuotaResume?.(id);
130
+ return result;
131
+ },
125
132
  switchContext: (options) =>
126
133
  withResetLock(async () => {
127
134
  const rollbackSnapshot = beginTuiReset();
@@ -27,6 +27,11 @@ export function createAgentDefinitionApi(runtime) {
27
27
  createWorkflow: async (payload) => runtime.createWorkflow?.(payload) ?? null,
28
28
  deleteWorkflow: async (workflowId) => runtime.deleteWorkflow?.(workflowId) ?? null,
29
29
  getAgentDefinition: (agentId) => runtime.getAgentDefinition?.(agentId) ?? null,
30
+ listInstructionFiles: () => runtime.listInstructionFiles?.() ?? [],
31
+ getInstructionFile: (group, id) => runtime.getInstructionFile?.(group, id) ?? null,
32
+ saveInstructionFile: async (payload) => runtime.saveInstructionFile?.(payload) ?? null,
33
+ resetInstructionFile: async (group, id, expectedRevision) =>
34
+ runtime.resetInstructionFile?.(group, id, expectedRevision) ?? null,
30
35
  getAgentAvatarImage: (agentId) => runtime.getAgentAvatarImage?.(agentId) ?? null,
31
36
  getAgentConnectors: (agentId) => runtime.getAgentConnectors?.(agentId) ?? [],
32
37
  listConnectors: () => runtime.listConnectors?.() ?? [],
@@ -23,7 +23,15 @@
23
23
  * (expectedRevision: WORKTREE_REVISION_CONFLICT when the session moved on)
24
24
  * (WORKTREE_REMOVAL_INCOMPLETE: partly removed; call again to finish)
25
25
  * listWorktrees() → every managed worktree with its retention
26
- * pruneWorktrees() → reconcile report (never a retained worktree) */
26
+ * pruneWorktrees() → reconcile report (with autoCleanup on, also the
27
+ * count/age limits and archive rules of the automatic cleanup)
28
+ * previewWorktreeCleanup({ repoCommonDir? }) → { hasCandidates } (whether pruneWorktrees could act on
29
+ * anything; read-only, no git verification)
30
+ * deleteWorktree({ entryId, force? }) → { removed, entryId, path } (Settings → Worktrees;
31
+ * refuses one in use, dirty or unmerged work unless `force`)
32
+ * getSessionWorktreeWork({ sessionIds }) → { sessionIds } owning a worktree removal would refuse
33
+ * setArchivedSessionWorktrees({ sessionIds, archived }) → { changed } (autoCleanup on: archived
34
+ * sessions' worktrees become disposable for the startup reconcile / prune; a restore unmarks) */
27
35
  import { worktreeError } from '../../../runtime/shared/worktrees/contract.mjs';
28
36
 
29
37
  /** Session actions of the Lead worktree feature (settings live in settings.mjs). */
@@ -40,6 +48,10 @@ export const SESSION_WORKTREE_ACTIONS = Object.freeze([
40
48
  'removeWorktree',
41
49
  'listWorktrees',
42
50
  'pruneWorktrees',
51
+ 'previewWorktreeCleanup',
52
+ 'deleteWorktree',
53
+ 'getSessionWorktreeWork',
54
+ 'setArchivedSessionWorktrees',
43
55
  ]);
44
56
 
45
57
  export function createSessionWorktreeApi({ runtime, set, routeState } = {}) {
@@ -29,16 +29,13 @@ function earliestSubmittedAt(batch) {
29
29
 
30
30
  function renderBatchItems(batch, pushUserOrSyntheticItem) {
31
31
  for (const entry of batch) {
32
- // Async-completion twins (queued model-visible wrapper) used to be
33
- // display-skipped here on the assumption the live notification push
34
- // already rendered a card. That push is event-ephemeral and can be
35
- // missed (listener race, dedupe state from another surface, daemon
36
- // restart), which left completions with NO transcript card at all
37
- // (2026-08-17 field report: bench shell output never appeared).
38
- // Render the wrapper through the synthetic path instead — the
39
- // task_id upsert in upsertSyntheticToolItem patches an
40
- // already-rendered card, so the double-delivery case stays
41
- // duplicate-free. Non-wrapper entries keep the old skip.
32
+ // Async-completion twins (queued model-visible wrapper) are rendered
33
+ // through the synthetic path rather than display-skipped: the live
34
+ // notification push is event-ephemeral and can be missed (listener race,
35
+ // dedupe state from another surface, daemon restart), which would leave
36
+ // the completion with NO transcript card at all. The task_id upsert in
37
+ // upsertSyntheticToolItem patches an already-rendered card, so the
38
+ // double-delivery case stays duplicate-free. Non-wrapper entries are skipped.
42
39
  if (entry.mode === 'pending-resume' || entry.suppressDisplay) {
43
40
  const twin = typeof entry.content === 'string' ? entry.content : String(entry.text || '');
44
41
  if (parseModelVisibleCompletionWrapper(twin)) {
@@ -145,10 +142,10 @@ export function turnOptionsForBatch(batch, steering) {
145
142
  Array.isArray(entry?.resumeCompletionKeys) ? entry.resumeCompletionKeys : []
146
143
  ),
147
144
  transcriptMeta: completionWakeTranscriptMeta(batch),
148
- // Only a routine turn names its selection text (never its payload).
149
- ...(batch[0]?.mode === 'routine' && typeof batch[0].skillSelection === 'string'
150
- ? { skillSelection: batch[0].skillSelection }
151
- : {}),
145
+ // Only host code names a selection text (queue/entry-shape.mjs): a
146
+ // routine turn, or a routine's executor sub-agent turn — its trusted
147
+ // instructions, never a payload.
148
+ ...(typeof batch[0]?.skillSelection === 'string' ? { skillSelection: batch[0].skillSelection } : {}),
152
149
  context:
153
150
  batch
154
151
  .map((entry) => String(entry.context || '').trim())
@@ -5,11 +5,22 @@
5
5
  */
6
6
  import { normalizeHumanResponse } from '../../runtime/agent/orchestrator/session/human-gate/requests.mjs';
7
7
  import { withdrawDelegatedApproval } from '../../runtime/shared/delegated-approval-host.mjs';
8
+ import { askUserResultText } from '../../runtime/agent/orchestrator/runtime-core/ask-user-result.mjs';
8
9
 
9
10
  // Settle one entry: drop its timeout, then hand the waiter its answer. The
10
11
  // resolve stays guarded — a waiter whose caller already went away must never
11
- // take the rest of the queue down with it.
12
- export function settleToolApproval(entry, approved, reason, answers, reply, extra, device = '') {
12
+ // take the rest of the queue down with it. `interrupted`: Stop/turn abort or
13
+ // close ended it, nobody answered.
14
+ export function settleToolApproval(
15
+ entry,
16
+ approved,
17
+ reason,
18
+ answers,
19
+ reply,
20
+ extra,
21
+ device = '',
22
+ { interrupted = false } = {}
23
+ ) {
13
24
  if (entry?.timer) clearTimeout(entry.timer);
14
25
  const result = { approved, reason };
15
26
  if (answers !== undefined) result.answers = answers;
@@ -20,9 +31,18 @@ export function settleToolApproval(entry, approved, reason, answers, reply, extr
20
31
  if (device) result.device = device;
21
32
  }
22
33
  if (extra?.timedOut === true) result.timedOut = true;
23
- // Settled here: its copy in the top-level chat goes away.
34
+ // Settled here: its copy in the top-level chat goes away. An answered or
35
+ // timed-out question leaves the record its call returns (ask-user-result.mjs),
36
+ // so a hand-off copy settles into the card the asking session keeps.
24
37
  if (entry?.delegated) {
25
- withdrawDelegatedApproval(entry.id, { approved, device, ...(extra?.timedOut === true ? { expired: true } : {}) });
38
+ const questions = entry.request?.kind === 'question' ? entry.request.args?.questions : null;
39
+ const record = Array.isArray(questions) && !interrupted ? askUserResultText(questions, result) : '';
40
+ withdrawDelegatedApproval(entry.id, {
41
+ approved,
42
+ device,
43
+ ...(extra?.timedOut === true ? { expired: true } : {}),
44
+ ...(record ? { record } : {}),
45
+ });
26
46
  }
27
47
  try {
28
48
  entry.resolve(result);
@@ -42,7 +42,17 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
42
42
  // queue so they never hold this chat's own requests back and several show
43
43
  // at once. Answered here, the answer goes to the asking session's queue.
44
44
  const handoffQuestions = [];
45
- const publishHandoffQuestions = () => set({ handoffQuestions: handoffQuestions.map((entry) => entry.request) });
45
+ // The last settled copy per asking session, its request with `record` (the
46
+ // result its ask_user call returned): the card stays answered beside the
47
+ // hand-off line, as the asking session's transcript keeps it, until that
48
+ // session asks again. Never answered here.
49
+ const handoffRecords = [];
50
+ const publishHandoffQuestions = () =>
51
+ set({ handoffQuestions: [...handoffRecords, ...handoffQuestions].map((entry) => entry.request) });
52
+ const dropHandoffRecordOf = (sessionId) => {
53
+ const at = handoffRecords.findIndex((entry) => String(entry.request.sessionId || '') === sessionId);
54
+ if (at >= 0) handoffRecords.splice(at, 1);
55
+ };
46
56
  const ownSessionId = () => String(getState()?.sessionId || '');
47
57
  const { delegationSurface, handsOff, offerToHandoffs } = createApprovalDelegation({ surfaceOf, ownSessionId });
48
58
  const unregister =
@@ -72,6 +82,7 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
72
82
  if (getDisposed() || delegated.sessionId !== ownSessionId()) return;
73
83
  if (delegated.request?.kind === 'question') {
74
84
  if (handoffQuestions.some((entry) => entry.id === delegated.id)) return;
85
+ dropHandoffRecordOf(String(delegated.request.sessionId || ''));
75
86
  handoffQuestions.push({ id: delegated.id, request: delegated.request, mirror: delegated });
76
87
  publishHandoffQuestions();
77
88
  return;
@@ -83,8 +94,13 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
83
94
  function withdrawDelegatedCopy(id, result) {
84
95
  const question = handoffQuestions.findIndex((entry) => entry.id === id);
85
96
  if (question >= 0) {
86
- handoffQuestions.splice(question, 1);
87
- if (!getDisposed()) publishHandoffQuestions();
97
+ const [entry] = handoffQuestions.splice(question, 1);
98
+ if (getDisposed()) return;
99
+ if (typeof result?.record === 'string') {
100
+ dropHandoffRecordOf(String(entry.request.sessionId || ''));
101
+ handoffRecords.push({ id, request: { ...entry.request, record: result.record } });
102
+ }
103
+ publishHandoffQuestions();
88
104
  return;
89
105
  }
90
106
  if (activeToolApproval?.mirror && activeToolApproval.id === id) {
@@ -154,11 +170,18 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
154
170
  settleToolApproval(entry, approved === true, String(reason || ''), answers, reply, extra, String(device || ''));
155
171
  return true;
156
172
  }
157
- const question = handoffQuestions.findIndex((entry) => entry.id === targetId);
158
- if (question >= 0) {
159
- const [entry] = handoffQuestions.splice(question, 1);
160
- publishHandoffQuestions();
161
- return forwardToOwner(entry, approved, reason, device, answers, reply, extra);
173
+ const question = handoffQuestions.find((entry) => entry.id === targetId);
174
+ if (question) {
175
+ // The owner's settle withdraws this copy (withdrawDelegatedCopy), which
176
+ // keeps it as the answered record; a copy the owner had already settled
177
+ // only leaves.
178
+ const accepted = forwardToOwner(question, approved, reason, device, answers, reply, extra);
179
+ const left = handoffQuestions.indexOf(question);
180
+ if (left >= 0) {
181
+ handoffQuestions.splice(left, 1);
182
+ publishHandoffQuestions();
183
+ }
184
+ return accepted;
162
185
  }
163
186
  return false;
164
187
  }
@@ -171,12 +194,14 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
171
194
  unregister();
172
195
  // Dropped unanswered with this runtime: the next one adopts them again.
173
196
  handoffQuestions.length = 0;
197
+ handoffRecords.length = 0;
174
198
  }
199
+ const interrupted = { interrupted: true };
175
200
  if (activeToolApproval && !(activeToolApproval.mirror && !closing)) {
176
201
  const entry = activeToolApproval;
177
202
  activeToolApproval = null;
178
203
  if (!entry.mirror) {
179
- settleToolApproval(entry, false, reason);
204
+ settleToolApproval(entry, false, reason, undefined, undefined, undefined, '', interrupted);
180
205
  // Stop/turn abort ended it: not a timeout, nobody answered.
181
206
  set({ toolApprovalResult: { id: entry.id, approved: false, device: '', interrupted: true, at: Date.now() } });
182
207
  }
@@ -184,7 +209,7 @@ export function createToolApproval({ getState, set, nextId, getDisposed, timeout
184
209
  const kept = [];
185
210
  while (toolApprovalQueue.length > 0) {
186
211
  const entry = toolApprovalQueue.shift();
187
- if (!entry.mirror) settleToolApproval(entry, false, reason);
212
+ if (!entry.mirror) settleToolApproval(entry, false, reason, undefined, undefined, undefined, '', interrupted);
188
213
  else if (!closing) kept.push(entry);
189
214
  }
190
215
  toolApprovalQueue.push(...kept);
@@ -49,8 +49,8 @@ function applyAgentJobFields(ctx, patch, { itemId, group, text, rawText, isError
49
49
  const body = String(text || rawText || '').trim();
50
50
  if (body) patch.rawResult = text || rawText;
51
51
  if (parseAgentJob(rawText)) ctx.set(ctx.agentStatusState({ force: true }));
52
- // The two calls previously wrote the same card back-to-back with different
53
- // result/text strings, producing the visible L1/L2 flash. The agent fields
52
+ // Writing the same card back-to-back with different result/text strings
53
+ // produces a visible L1/L2 flash, so a single patch is written. The agent fields
54
54
  // win (final display) while patch keeps the completion metadata
55
55
  // (count/completedCount/completedAt/rawResult) for expand.
56
56
  Object.assign(patch, ctx.buildAgentJobCardPatch(itemId, rawText, isError));
@@ -9,7 +9,7 @@ import { resolveAgentStallThresholds } from '../../runtime/agent/orchestrator/st
9
9
  const QUIET_POLL_MS = 1_000;
10
10
 
11
11
  /** The lead's stall-watchdog warn point, in ms. */
12
- export function leadStallWarnMs() {
12
+ function leadStallWarnMs() {
13
13
  return resolveAgentStallThresholds('lead').warn * 1000;
14
14
  }
15
15
 
@@ -549,6 +549,8 @@ export function failTurn(ctx, error) {
549
549
  if (record.quota) turn.quota = record.quota;
550
550
  turn.failureDetail = record.detail;
551
551
  turn.failureDiagnostic = record.errorDetails;
552
+ // Answers the turn went on past before it failed (turn-report.mjs).
553
+ if (typeof error?.carriedReport === 'string') turn.carriedReport = error.carriedReport;
552
554
  pushNotice(turn.failureDetail, 'error', { owner: 'transcript' });
553
555
  }
554
556
 
@@ -661,6 +663,7 @@ async function settleTurn(ctx) {
661
663
  session: runtime.session || null,
662
664
  error: turn.failureDetail || null,
663
665
  errorKind: turn.failed ? turn.errorKind || null : null,
666
+ ...(turn.failed && turn.carriedReport ? { carriedReport: turn.carriedReport } : {}),
664
667
  };
665
668
  // Publish termination before optional Goal work can delay the caller.
666
669
  bag.settleSteeredSubmissions?.(turn.epoch, detail);
@@ -12,7 +12,7 @@ const ENDINGS = {
12
12
  const INCOMPLETE = 'Some worktree dependencies were not installed; the agent has the details.';
13
13
 
14
14
  /** Notice text and tone for one install progress event. */
15
- export function worktreeSetupNotice(event) {
15
+ function worktreeSetupNotice(event) {
16
16
  if (event.final) {
17
17
  const text = ENDINGS[event.status] ?? INCOMPLETE;
18
18
  return { text, tone: event.status === 'completed' ? 'info' : 'warn' };
@@ -17,7 +17,7 @@ const compactNumberFormatter = new Intl.NumberFormat('en-US', {
17
17
  minimumFractionDigits: 0,
18
18
  });
19
19
 
20
- export function formatSpinnerTokens(value) {
20
+ function formatSpinnerTokens(value) {
21
21
  const tokens = Math.max(0, Number(value || 0));
22
22
  if (tokens >= 1000) return compactNumberFormatter.format(tokens).toLowerCase();
23
23
  return String(Math.round(tokens));
@@ -84,8 +84,8 @@ export function buildSpinnerMeta({
84
84
  thinkingParts,
85
85
  tokensText: tokens > 0 ? `${formatSpinnerTokens(tokens)} tokens` : '',
86
86
  // The count appears with the FIRST token (user: 30초가 아니라 바로).
87
- // Elapsed was never gated, so the byline used to grow a second field
88
- // mid-turn for no reason the reader could see; now both arrive together.
87
+ // Elapsed is never gated, so showing tokens with the first token keeps the
88
+ // byline from growing a second field mid-turn; both arrive together.
89
89
  showTokens: tokens > 0,
90
90
  thinkingText,
91
91
  thinkingActive: Boolean(thinking || Number(thinkingSince) > 0),
@@ -199,13 +199,13 @@ export const SPINNER_VERBS = [
199
199
  ];
200
200
 
201
201
  /** How long one phrase holds before the pool advances. */
202
- export const SPINNER_VERB_ROTATE_MS = 30_000;
202
+ const SPINNER_VERB_ROTATE_MS = 30_000;
203
203
 
204
204
  /** Odds that a 30s boundary actually swaps the phrase (user: 바꿀지 말지만
205
205
  * 랜덤 돌리면 되잖아). Below 1 the window stretches: ~half the boundaries
206
206
  * hold, so a phrase lives 30s, 60s, 90s… and the rhythm stops being a
207
207
  * metronome. */
208
- export const SPINNER_VERB_CHANGE_ODDS = 0.5;
208
+ const SPINNER_VERB_CHANGE_ODDS = 0.5;
209
209
 
210
210
  /**
211
211
  * Deterministic coin for ONE (turn, boundary) pair.
@@ -1,169 +0,0 @@
1
- ---
2
- name: goal-management
3
- description: Manage the task list of approved work carried across turns, its progress, approvals, and completion.
4
- when_to_use: 'Goal requests or approved multi-turn work in progress; not one-turn tasks or recurring schedules.'
5
- dependencies:
6
- tools:
7
- - type: tool
8
- value: goal
9
- ---
10
-
11
- # Goal management
12
-
13
- Use `goal` to maintain durable tasks and their idle reminders. The tool schema
14
- owns arguments and limits; this guide owns the lifecycle and completion policy.
15
-
16
- ## Admission and current state
17
-
18
- Create a Goal for an explicit user or system/developer Goal request, or for
19
- user delegation or approval of work that runs past a single turn: a staged
20
- refactor or migration, repeated improvement passes, a partition list or
21
- candidate inventory carried between turns, or an open-ended objective that
22
- must be finished. A time budget is optional, and the user need not name Goal —
23
- approval of an assistant-proposed scope also qualifies. Resolve a short
24
- approval against the preceding proposal and retain any user constraints.
25
-
26
- Create the Goal so that scope and state survive the turn boundary instead of
27
- being rebuilt or dropped. A single-turn task, planning, estimates, and
28
- deadlines alone do not qualify, and neither does an unaccepted assistant
29
- proposal.
30
-
31
- If work needs approval, obtain it first; then create the
32
- Goal, or reconcile an existing one, before starting the approved work,
33
- including execution-stage exploration. An existing Goal does not authorize
34
- new scope.
35
-
36
- For creation, use the requested or approved budget for `time_limit_minutes`;
37
- omit it when no budget was agreed — an untimed Goal runs on its objective
38
- alone. A stated budget commits that time: "a 5-hour Goal", "improvement
39
- rounds for 3 hours", or polishing for a period use `time_mode: duration`, the
40
- default when a budget is given. Use `time_mode: max` only when the user frames
41
- the budget as an upper bound ("at most", "within", "최대", "안에").
42
-
43
- Use the latest returned state and revision. If unknown or stale, read `status`
44
- and reconcile before mutating. Never replay a stale mutation blindly.
45
- For multi-step work, record the approved milestones and keep them durable.
46
- One-step work does not need a ceremonial plan or a separate verification row.
47
-
48
- ## Additional rounds
49
-
50
- An approved request to continue for another period changes the work commitment,
51
- not just the conversation. Reconcile the Goal before research or execution:
52
-
53
- - For the same unfinished objective, use `resume` with the approved remaining
54
- budget in `time_limit_minutes` and new tasks or task updates in one call.
55
- This also covers a paused Goal or exhausted budget with all old rows done.
56
- Preserve completed rows and unfinished requirements; record the new round's
57
- work rather than leaving the old completed checklist unchanged.
58
- - The resume budget runs from now and retains elapsed work. Omit it for a
59
- plain continuation with no approved time change. Preserve `time_mode`
60
- unless the new request explicitly changes the time commitment.
61
- - If the prior Goal is complete or stopped, create a new Goal for the approved
62
- round; the runtime archives the prior record. Do not falsely complete or
63
- abandon unfinished work merely to get a fresh clock.
64
- - Proceed only after the returned state has the intended active status,
65
- remaining budget, and tasks. A statement that work will continue is not a
66
- substitute for the mutation. Reconcile a rejected update before continuing.
67
-
68
- ## Maintain progress
69
-
70
- - Update tasks at meaningful milestones and scope changes. Preserve unfinished
71
- requirements; drop a task only after the user changes its scope.
72
- - Prefer `update_tasks` for changed items; `set_tasks` replaces the full list.
73
- Serialize mutations to the same Goal. `resume` accepts updates and additions
74
- atomically. `resume` a blocked Goal when the user's reply supplies what it
75
- was waiting for or asks to continue, and a cancelled-turn pause when the next
76
- instruction carries the objective forward; a user-initiated pause resumes
77
- only when the user asks. Bookkeeping alone does not authorize execution.
78
- - Batch related task changes and independent work. Creation, status, and resume return full state; other
79
- successful replies are brief and need no confirmation read.
80
-
81
- ## Approval and waiting
82
-
83
- Finish every approved step and decide choices within the objective yourself,
84
- including any option you would recommend; state those decisions in the report
85
- instead of asking. Park as `awaiting_approval` only work that needs the user's
86
- own action (a sign-in, a device check) or scope outside the objective,
87
- including a commit, push, release, deployment, or payment the user has not
88
- requested, together with anything its answer could invalidate. Record additions
89
- immediately and continue unaffected approved work.
90
-
91
- Foreground app or window control, local and test-environment runs and the test
92
- resources they consume, reversible changes, and time or cost belong to in-scope
93
- work, not approval gates. Wanting confirmation for in-scope work is never a
94
- reason to stop.
95
-
96
- Never pause on your own initiative: `pause` is only for the user's explicit
97
- request to pause this Goal. When no approved work can proceed without the user,
98
- ask the parked questions together and report that impasse with `block`.
99
- Respect a user-initiated pause until the user asks to continue; routine errors
100
- and retries are not reasons to stop.
101
-
102
- A cancelled turn pauses the Goal with `pauseReason: cancelled`. The user stopped
103
- that turn, not the objective, and only the stop control retires a Goal. Judge the
104
- next instruction: resume and continue the work when it carries this objective
105
- forward or redirects it, and leave the Goal paused when it is unrelated or asks
106
- you to stay stopped.
107
-
108
- Each continuation should do concrete work or wait on a verified live handle.
109
- Evidence that changes the next action is progress; repeated reports and plan
110
- updates alone are not. Reassess a no-progress turn and take the next safe action.
111
- Observation timeouts do not terminate the observed work or justify restarting it.
112
- An automatic continuation that ends without a tool call stops automatic turns
113
- until the task list changes, the user acts, or the time boundary arrives; end a
114
- turn that way only when no safe action remains, not to idle out the clock.
115
-
116
- ## Completion and recovery
117
-
118
- Distinguish a turn boundary, objective completion, and a budget stop. A Goal
119
- can stay active across turn-ending progress reports; never present such a
120
- report as completion of the whole objective.
121
-
122
- Complete only after auditing every user condition against evidence. Reuse valid
123
- checks; a separate verification task is optional, verification itself is not.
124
- A maximum time budget allows verified early completion. A full-period
125
- commitment does not. Preserve an existing Goal's time mode; never extend its
126
- budget or change its meaning on your own.
127
- Do not end a Goal merely because a partial result is available.
128
-
129
- For an achieved objective, reconcile the task records, call `complete`, and
130
- check the returned status before claiming Goal completion. A tool call or a
131
- plausible final response is not itself confirmation.
132
-
133
- ### Time-budget extension
134
-
135
- Elapsed-time budgets are a Mixdog extension to the persistent Goal lifecycle.
136
- Keep `max` upper bounds distinct from explicitly requested `duration` periods.
137
- An advance deadline warning does not stop the Goal or request an early final
138
- report; prioritize bounded approved work and needed verification. Under a
139
- `max` budget, do not invent unfinished tasks merely to fill remaining clock
140
- time. Under a `duration` commitment, when the recorded rows are done, find the
141
- next round's real improvements within the objective and record them as new
142
- tasks instead of idling or reporting completion.
143
-
144
- At the boundary, the runtime first records `duration_reached`, disables
145
- automatic Goal work, and delivers closeout without cancelling the current
146
- turn. Finish or safely park only in-flight work, then report once. The elapsed
147
- period proves only that the time condition ended: call `complete` only if the
148
- whole objective is verified; otherwise retain unfinished tasks and the limited
149
- status. Do not resume or extend the Goal without the user's approval.
150
-
151
- ### Blocked and redirected work
152
-
153
- `block` stops the Goal immediately, with a stable description of an impasse
154
- that only external state or the user can clear. Do not block the first time a
155
- blocker appears: block only after the same condition has repeated for three
156
- consecutive Goal turns, counting the user-triggered turn and automatic
157
- continuations; after a resume, count only turns since that resume. Until then,
158
- continue any available work and re-check the blocker against current state with
159
- a tool each turn rather than restating it. When current state verifies an
160
- impasse that only the user can clear (their action, approval, credentials, or a
161
- resource they control), block on that turn. Once the threshold is met, block
162
- instead of reporting the same blocker again. Treat equivalent blockers as the
163
- same condition even when their wording or stated next step changes. Never block for difficulty, slowness,
164
- uncertainty, a choice you can make, confirmation for in-scope work, or
165
- clarification that would only help. Use `abandon` only when the user redirects away from
166
- the objective; it preserves a stopped record rather than declaring success.
167
-
168
- Done when the returned Goal state accurately represents completed work,
169
- remaining approved work, or the justified waiting/terminal condition.