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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mixdog",
3
- "version": "1.4.2",
3
+ "version": "1.4.4",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Open-source coding agent that matches Codex on Terminal-Bench 2.1 with 63% fewer tokens.",
@@ -144,7 +144,7 @@
144
144
  "arm64"
145
145
  ],
146
146
  "dependencies": {
147
- "@anthropic-ai/sdk": "^0.135.0",
147
+ "@anthropic-ai/sdk": "^0.137.0",
148
148
  "@formulajs/formulajs": "^4.6.1",
149
149
  "@google/generative-ai": "^0.24.1",
150
150
  "@huggingface/transformers": "^4.3.1",
@@ -92,11 +92,19 @@ function parseTree(body) {
92
92
  const treeCache = new Map();
93
93
  const blobCache = new Map();
94
94
  const treeOf = async (sha) => {
95
- if (!treeCache.has(sha)) treeCache.set(sha, read(sha).then(({ body }) => parseTree(body)));
95
+ if (!treeCache.has(sha))
96
+ treeCache.set(
97
+ sha,
98
+ read(sha).then(({ body }) => parseTree(body))
99
+ );
96
100
  return treeCache.get(sha);
97
101
  };
98
102
  const blobOf = async (sha) => {
99
- if (!blobCache.has(sha)) blobCache.set(sha, read(sha).then(({ body }) => body));
103
+ if (!blobCache.has(sha))
104
+ blobCache.set(
105
+ sha,
106
+ read(sha).then(({ body }) => body)
107
+ );
100
108
  return blobCache.get(sha);
101
109
  };
102
110
 
@@ -163,9 +171,10 @@ async function packHistory(dir, entry) {
163
171
  return out;
164
172
  }
165
173
 
166
- async function outputStyleHistory() {
174
+ // Single-file definitions (output styles, orchestration modes): file name -> hashes.
175
+ async function fileHistory(prefix) {
167
176
  const out = {};
168
- for (const [name, versions] of await everVersions('src/output-styles')) {
177
+ for (const [name, versions] of await everVersions(prefix)) {
169
178
  const hashes = [];
170
179
  for (const files of versions) hashes.push(hashText(await blobOf([...files.values()][0])));
171
180
  if (hashes.length) out[name] = unique(hashes);
@@ -188,7 +197,8 @@ async function skillHistory() {
188
197
  const history = {
189
198
  agents: await packHistory('src/agents', 'AGENT.md'),
190
199
  workflows: await packHistory('src/workflows', 'WORKFLOW.md'),
191
- outputStyles: await outputStyleHistory(),
200
+ outputStyles: await fileHistory('src/output-styles'),
201
+ orchestration: await fileHistory('src/orchestration'),
192
202
  skills: await skillHistory(),
193
203
  };
194
204
  catFile.stdin.end();
@@ -36,7 +36,9 @@ import {
36
36
  runPool,
37
37
  saveTimingHistory,
38
38
  } from './lib/gate-scheduler.mjs';
39
+ import { FULL_LOG_LABEL } from './lib/run-node-tests.mjs';
39
40
  import { pruneStaleTempDirs, removeTempDirSync } from './lib/stale-temp.mjs';
41
+ import { SUMMARY_TAG } from './lib/test-failure-summary.mjs';
40
42
 
41
43
  const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
42
44
  const started = Date.now();
@@ -81,8 +83,7 @@ const commonDir = spawnSync('git', ['rev-parse', '--path-format=absolute', '--gi
81
83
  cwd: root,
82
84
  encoding: 'utf8',
83
85
  });
84
- const historyPath =
85
- commonDir.status === 0 ? path.join(commonDir.stdout.trim(), 'mixdog-gate-timings.json') : null;
86
+ const historyPath = commonDir.status === 0 ? path.join(commonDir.stdout.trim(), 'mixdog-gate-timings.json') : null;
86
87
  if (!historyPath) console.warn(`[gate:local] warning: no git common dir, timings not kept: ${commonDir.stderr}`);
87
88
  const history = historyPath ? readTimingHistory(historyPath) : {};
88
89
  const measured = {};
@@ -99,7 +100,8 @@ const testLanes = [
99
100
  const dir = path.join(root, lane.pkg);
100
101
  const command = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')).scripts[lane.script];
101
102
  const [program, ...args] = command.split(/\s+/);
102
- if (program !== 'node') throw new Error(`${lane.pkg}/package.json "${lane.script}" must be a node command: ${command}`);
103
+ if (program !== 'node')
104
+ throw new Error(`${lane.pkg}/package.json "${lane.script}" must be a node command: ${command}`);
103
105
  const list = spawnSync(process.execPath, [...args, '--list'], { cwd: dir, encoding: 'utf8' });
104
106
  if (list.status !== 0) throw new Error(`${command} --list failed: ${list.stderr}`);
105
107
  const files = list.stdout
@@ -107,7 +109,14 @@ const testLanes = [
107
109
  .filter(Boolean)
108
110
  .map((line) => line.replace(/^\S+\s+/, ''));
109
111
  const key = (file) => path.posix.join(lane.pkg, file);
110
- return { ...lane, dir, args, files, key, estimateOf: (file) => history[key(file)] ?? DEFAULT_ESTIMATE_MS[lane.speed] };
112
+ return {
113
+ ...lane,
114
+ dir,
115
+ args,
116
+ files,
117
+ key,
118
+ estimateOf: (file) => history[key(file)] ?? DEFAULT_ESTIMATE_MS[lane.speed],
119
+ };
111
120
  });
112
121
  const lanesByName = new Map(testLanes.map((lane) => [lane.name, lane]));
113
122
  const commandUnits = [
@@ -136,11 +145,37 @@ function run(command, args, options, fd) {
136
145
  const child = spawn(command, args, { ...options, env, windowsHide: true, stdio: ['ignore', fd, fd] });
137
146
  child.on('error', (error) => {
138
147
  fs.writeSync(fd, `${error.stack}\n`);
139
- resolve(1);
148
+ resolve({ code: 1, signal: null });
140
149
  });
141
- child.on('close', (code) => resolve(code ?? 1));
150
+ child.on('close', (code, signal) => resolve({ code, signal }));
142
151
  });
143
152
  }
153
+ const passed = (exit) => exit.code === 0;
154
+ const ending = (exit) => (exit.signal ? `signal ${exit.signal}` : `exit code ${exit.code}`);
155
+
156
+ // A shard's runner ends every run with its failure summary
157
+ // (scripts/lib/run-node-tests.mjs). One killed from outside (TerminateProcess,
158
+ // SIGKILL) or crashed prints nothing more, and Windows ends its node --test
159
+ // batch and test processes with it, so no reporter flushes either: name how it
160
+ // ended and what its full test log last recorded.
161
+ const DEAD_TAIL_LINES = 12;
162
+ function deadShardReport(unit, exit, output) {
163
+ if (passed(exit) || output.includes(SUMMARY_TAG)) return '';
164
+ const fullLog = output
165
+ .split(/\r?\n/)
166
+ .find((line) => line.startsWith(FULL_LOG_LABEL))
167
+ ?.slice(FULL_LOG_LABEL.length);
168
+ const tail =
169
+ fullLog && fs.existsSync(fullLog)
170
+ ? fs.readFileSync(fullLog, 'utf8').trimEnd().split(/\r?\n/).slice(-DEAD_TAIL_LINES)
171
+ : [];
172
+ return [
173
+ `${SUMMARY_TAG} RUN FAILED: ${unit.id} runner ended by ${ending(exit)} before its failure summary (killed from outside or crashed)`,
174
+ `${SUMMARY_TAG} last ${tail.length} line(s) of ${fullLog ?? 'its full test log (never named)'}:`,
175
+ ...tail.map((line) => ` ${line}`),
176
+ '',
177
+ ].join('\n');
178
+ }
144
179
 
145
180
  const TIMING_REPORTER = new URL('./lib/gate-timing-reporter.mjs', import.meta.url).href;
146
181
  async function runShard(unit, fd) {
@@ -148,7 +183,7 @@ async function runShard(unit, fd) {
148
183
  const timings = path.join(logDir, `${unit.id}.timings.jsonl`);
149
184
  const args = [...lane.args, `--test-reporter=${TIMING_REPORTER}`, `--test-reporter-destination=${timings}`];
150
185
  fs.writeSync(fd, `\n$ (${lane.pkg}) node ${[...args, ...unit.files].join(' ')}\n`);
151
- const code = await run(process.execPath, [...args, ...unit.files], { cwd: lane.dir }, fd);
186
+ const exit = await run(process.execPath, [...args, ...unit.files], { cwd: lane.dir }, fd);
152
187
  const reported = Object.fromEntries(
153
188
  (fs.existsSync(timings) ? fs.readFileSync(timings, 'utf8') : '')
154
189
  .split('\n')
@@ -162,20 +197,19 @@ async function runShard(unit, fd) {
162
197
  for (const [file, ms] of Object.entries(measuredFileTimes(unit.files, reported, Date.now() - unit.start))) {
163
198
  measured[lane.key(file)] = Math.round(ms);
164
199
  }
165
- return code === 0;
200
+ return exit;
166
201
  }
167
202
 
203
+ // The exit of the first command that failed, else of the last one.
168
204
  async function runCommands(unit, fd) {
169
- let ok = true;
205
+ let exit = { code: 0, signal: null };
170
206
  for (const cmd of unit.cmds) {
171
207
  fs.writeSync(fd, `\n$ ${cmd}\n`);
172
- if ((await run(cmd, [], { cwd: root, shell: true }, fd)) !== 0) {
173
- ok = false;
174
- break;
175
- }
208
+ exit = await run(cmd, [], { cwd: root, shell: true }, fd);
209
+ if (!passed(exit)) break;
176
210
  }
177
211
  measured[unit.key] = Date.now() - unit.start;
178
- return ok;
212
+ return exit;
179
213
  }
180
214
 
181
215
  let finished = 0;
@@ -183,18 +217,25 @@ async function runUnit(unit) {
183
217
  const part = path.join(logDir, `${unit.id}.part.log`);
184
218
  const fd = fs.openSync(part, 'w');
185
219
  unit.start = Date.now();
186
- let ok = false;
220
+ let exit = { code: 1, signal: null };
221
+ let dead = '';
187
222
  try {
188
- ok = await (unit.files ? runShard(unit, fd) : runCommands(unit, fd));
223
+ exit = await (unit.files ? runShard(unit, fd) : runCommands(unit, fd));
224
+ if (unit.files) {
225
+ dead = deadShardReport(unit, exit, fs.readFileSync(part, 'utf8'));
226
+ if (dead) fs.writeSync(fd, `\n${dead}`);
227
+ }
189
228
  } finally {
190
229
  fs.closeSync(fd);
191
230
  unit.end = Date.now();
192
231
  fs.appendFileSync(laneLog(unit.lane), fs.readFileSync(part));
193
232
  fs.rmSync(part);
194
233
  }
234
+ const ok = passed(exit);
195
235
  console.log(
196
- `[gate:local] ${ok ? 'ok ' : 'FAIL'} ${unit.id} ${((unit.end - unit.start) / 1000).toFixed(1)}s (${++finished}/${units.length})`
236
+ `[gate:local] ${ok ? 'ok ' : 'FAIL'} ${unit.id} ${((unit.end - unit.start) / 1000).toFixed(1)}s (${++finished}/${units.length})${ok ? '' : ` ${ending(exit)}`}`
197
237
  );
238
+ if (dead) process.stdout.write(dead);
198
239
  return ok;
199
240
  }
200
241
 
@@ -209,7 +250,9 @@ try {
209
250
  // The next run plans from these; work this run did not reach keeps its old time.
210
251
  const keys = [...testLanes.flatMap((lane) => lane.files.map(lane.key)), ...commandUnits.map((unit) => unit.key)];
211
252
  const next = Object.fromEntries(
212
- keys.filter((key) => (measured[key] ?? history[key]) !== undefined).map((key) => [key, measured[key] ?? history[key]])
253
+ keys
254
+ .filter((key) => (measured[key] ?? history[key]) !== undefined)
255
+ .map((key) => [key, measured[key] ?? history[key]])
213
256
  );
214
257
  const saveError = historyPath && saveTimingHistory(historyPath, next);
215
258
  if (saveError) console.warn(`[gate:local] warning: timings not saved (${saveError.message})`);
@@ -232,7 +275,10 @@ for (const name of laneNames) {
232
275
  .filter((l) => /\[failure-summary\] (?:RUN FAILED|HUNG|FAILED|FLAKY)/.test(l));
233
276
  for (const l of lines) console.log(` ${l}`);
234
277
  }
235
- if (notStarted.length) console.log(`Stopped after a failed ${units.find((u) => u.stopOnFail && u.ok === false).lane} check: ${notStarted.length} unit(s) not run`);
278
+ if (notStarted.length)
279
+ console.log(
280
+ `Stopped after a failed ${units.find((u) => u.stopOnFail && u.ok === false).lane} check: ${notStarted.length} unit(s) not run`
281
+ );
236
282
  console.log(
237
283
  'Not covered locally: runtime-macos, computer-backend, desktop-tests computer lane (Windows-only), relay, graph, patch, browser-import, mobile-scripts'
238
284
  );
@@ -6,6 +6,7 @@ import { readFileSync, writeFileSync } from 'node:fs';
6
6
  import { resolve } from 'node:path';
7
7
  import { performance } from 'node:perf_hooks';
8
8
  import { pathToFileURL } from 'node:url';
9
+ import { spawnTreeKill } from '../src/runtime/agent/orchestrator/mcp/child-tree.mjs';
9
10
  import { median, sortedFinite } from './lib/trace-stats.mjs';
10
11
 
11
12
  const USAGE = `usage: node scripts/graph-parity.mjs --old <binary> --new <binary> [--root <dir>] [--files <rel>...] [--json <out>] [--kind-map <path.json>] [--tokens] [--allow-new-languages <ids>] [--max-symbol-loss N] [--max-import-diff N] [--max-token-loss N] [--max-time-ratio 1.10] [--runs 3]
@@ -925,15 +926,19 @@ function reusedMetaLine(rec) {
925
926
  });
926
927
  }
927
928
 
929
+ // Windows: the shared, bounded creation-checked tree kill finds the
930
+ // descendants while the root still runs; the root, owned and alive, is then
931
+ // killed directly once that pass ends or runs out of time (spawnTreeKill).
928
932
  function killProcessTree(proc) {
933
+ if (process.platform === 'win32' && proc.pid && proc.exitCode === null && proc.signalCode === null) {
934
+ spawnTreeKill([proc.pid], { root: proc });
935
+ return;
936
+ }
929
937
  try {
930
938
  proc.kill();
931
939
  } catch {
932
940
  /* ignore */
933
941
  }
934
- if (process.platform === 'win32' && proc.pid) {
935
- spawn('taskkill', ['/pid', String(proc.pid), '/t', '/f'], { windowsHide: true, stdio: 'ignore' });
936
- }
937
942
  }
938
943
 
939
944
  export function runProcess(bin, args, { stdinText = null, timeoutMs = SPAWN_TIMEOUT_MS } = {}) {
@@ -31,7 +31,8 @@ export function gateTestBudget(argv = [], env = process.env, parallelism = avail
31
31
  if (index >= 0) explicit = argv[index].includes('=') ? argv[index].split('=')[1] : (argv[index + 1] ?? '');
32
32
  if (explicit === undefined) return Math.max(1, Math.min(DEFAULT_MAX_WORKERS, Math.floor(parallelism / 2)));
33
33
  const budget = Number(explicit);
34
- if (!Number.isInteger(budget) || budget < 1) throw new Error(`gate test budget must be a positive integer (got "${explicit}")`);
34
+ if (!Number.isInteger(budget) || budget < 1)
35
+ throw new Error(`gate test budget must be a positive integer (got "${explicit}")`);
35
36
  return budget;
36
37
  }
37
38
 
@@ -29,6 +29,8 @@ const TEST_LOG_PREFIX = 'mixdog-test-output-';
29
29
  const TEST_FAILURES_PREFIX = 'mixdog-test-failures-';
30
30
  const TEST_SCRATCH_PREFIX = 'mixdog-test-scratch-';
31
31
  export const RUNNER_TEMP_PREFIXES = [TEST_LOG_PREFIX, TEST_FAILURES_PREFIX, TEST_SCRATCH_PREFIX];
32
+ // Printed first by every run; the local gate finds a dead unit's log by it.
33
+ export const FULL_LOG_LABEL = 'Full test log: ';
32
34
 
33
35
  // Batches keep the file order Node was given; a single path larger than the
34
36
  // budget still gets its own batch rather than being dropped. An empty list
@@ -142,11 +144,19 @@ function capture(command, args) {
142
144
  });
143
145
  }
144
146
 
145
- // Kills a process and every descendant still linked to it. On POSIX a batch
146
- // leads its own process group (spawned detached), so the group goes with it.
147
+ // Kills a live batch and every descendant still linked to it (on Windows the
148
+ // shared creation-checked tree kill). On POSIX a batch leads its own process
149
+ // group (spawned detached), so the group goes with it.
150
+ // Loaded only when a Windows kill runs, so importers that need just this
151
+ // module's constants (the local gate) do not pull in the runtime.
152
+ async function loadKillProcessTrees() {
153
+ const { killProcessTrees } = await import('../../src/runtime/agent/orchestrator/mcp/child-tree.mjs');
154
+ return killProcessTrees;
155
+ }
156
+
147
157
  async function killTree(pid) {
148
158
  if (process.platform === 'win32') {
149
- await capture('taskkill', ['/T', '/F', '/PID', String(pid)]);
159
+ await (await loadKillProcessTrees())([pid]);
150
160
  return;
151
161
  }
152
162
  for (const target of [-pid, pid]) {
@@ -284,12 +294,14 @@ async function reapLeftovers(child, { batch, ledger, scratchDir }) {
284
294
  }
285
295
 
286
296
  async function killOwned(anchors, { scratchDir }) {
297
+ // Every owned process ran when the snapshot was taken.
298
+ const snapshotAt = Date.now();
287
299
  const leftovers = ownedProcesses(await processSnapshot(), anchors, { scratchDir });
288
300
  if (leftovers.length === 0) return;
289
301
  const pids = leftovers.map((entry) => entry.pid);
290
302
  console.error(`Killing ${pids.length} process(es) a test left running: ${pids.join(' ')}`);
291
303
  if (process.platform === 'win32') {
292
- await capture('taskkill', ['/T', '/F', ...pids.flatMap((pid) => ['/PID', String(pid)])]);
304
+ await (await loadKillProcessTrees())(pids, { aliveAt: snapshotAt });
293
305
  return;
294
306
  }
295
307
  for (const pid of pids) {
@@ -387,7 +399,7 @@ export async function runNodeTests(nodeArgs, fileArgs, options = {}) {
387
399
  pruneStaleTempDirs(RUNNER_TEMP_PREFIXES);
388
400
  const outputDir = await mkdtemp(join(tmpdir(), TEST_LOG_PREFIX));
389
401
  const logPath = join(outputDir, 'full.log');
390
- console.error(`Full test log: ${logPath}`);
402
+ console.error(`${FULL_LOG_LABEL}${logPath}`);
391
403
  // Failure records live outside the log directory: the log directory holds
392
404
  // exactly one merged log, and these records are an internal artifact.
393
405
  const failureDir = await mkdtemp(join(tmpdir(), TEST_FAILURES_PREFIX));
@@ -50,14 +50,7 @@ export function policyLine(rerunFailed) {
50
50
  // never "0 failed". `pids` names the node --test processes that exited
51
51
  // non-zero, so a kill can be matched to the "Killing ... <pid>" line of
52
52
  // whatever killed them.
53
- export function formatFailureSummary({
54
- failed = [],
55
- flaky = [],
56
- rerunFailed = 0,
57
- hung = [],
58
- exitCode = 0,
59
- pids = [],
60
- }) {
53
+ export function formatFailureSummary({ failed = [], flaky = [], rerunFailed = 0, hung = [], exitCode = 0, pids = [] }) {
61
54
  const hungCount = hung.length > 0 ? `, ${hung.length} hung batch(es)` : '';
62
55
  const unexplained = exitCode !== 0 && failed.length === 0 && hung.length === 0;
63
56
  const runner = pids.length > 0 ? `node --test pid ${pids.join(' ')}: ` : '';
@@ -5,8 +5,10 @@
5
5
  // nothing.
6
6
  import { ChildProcess } from 'node:child_process';
7
7
  import { appendFileSync, readFileSync } from 'node:fs';
8
+ import { constants } from 'node:os';
8
9
  import { dirname, join } from 'node:path';
9
10
  import { pathToFileURL } from 'node:url';
11
+ import { getSystemErrorMap } from 'node:util';
10
12
  import { FAILURE_RECORDS_ENV, spawnLedgerPath } from './test-failure-records.mjs';
11
13
 
12
14
  // --test-force-exit ends a test file's process once every test registered so
@@ -60,14 +62,43 @@ if (ledger) {
60
62
  // comes before the child's handle is closed, so the pid is still this
61
63
  // child's when the exit is written: from then on another process may hold it.
62
64
  const spawn = ChildProcess.prototype.spawn;
65
+ const exited = new Set();
63
66
  ChildProcess.prototype.spawn = function recordedSpawn(...args) {
64
67
  const before = Date.now();
65
68
  const result = spawn.apply(this, args);
66
69
  if (this.pid) {
67
- const spawned = `${this.pid} ${before} ${Date.now()}`;
70
+ const { pid } = this;
71
+ exited.delete(pid);
72
+ const spawned = `${pid} ${before} ${Date.now()}`;
68
73
  appendFileSync(ledger, `${spawned}\n`);
69
- this.once('exit', () => appendFileSync(ledger, `${spawned} ${Date.now()}\n`));
74
+ this.once('exit', () => {
75
+ exited.add(pid);
76
+ appendFileSync(ledger, `${spawned} ${Date.now()}\n`);
77
+ });
70
78
  }
71
79
  return result;
72
80
  };
81
+ // Once a child's exit is seen its pid is free, and Windows hands it to the
82
+ // next process started within moments — on a loaded gate often a parallel
83
+ // unit's test runner, node --test batch or test file process. A cleanup that
84
+ // signals every pid it recorded (e.g. `after(() => process.kill(pid))`, or a
85
+ // kill(pid, 0) liveness poll) then terminates that process instead, and the
86
+ // whole unit dies without output. Such a signal fails ESRCH here, as for a
87
+ // gone process, and never reaches whatever holds the pid now. Arguments Node
88
+ // rejects (a non-integer pid, an unknown signal) still go to Node, which
89
+ // throws before any signal is sent; this rejects only what it would send.
90
+ const kill = process.kill;
91
+ const [ESRCH] = [...getSystemErrorMap()].find(([, [name]]) => name === 'ESRCH');
92
+ const sendable = (signal) => signal === (signal | 0) || Boolean(constants.signals[signal || 'SIGTERM']);
93
+ process.kill = function killLiveChildOnly(pid, signal) {
94
+ // Only a primitive pid is checked: coercing an object would run its
95
+ // valueOf before Node's own coercion does. Number(pid) === (pid | 0) is
96
+ // Node's `pid == (pid | 0)` integer check.
97
+ const primitive = typeof pid === 'number' || typeof pid === 'string';
98
+ if (primitive && Number(pid) === (pid | 0) && exited.has(pid | 0) && sendable(signal)) {
99
+ // The shape of Node's own failed kill (an ErrnoException).
100
+ throw Object.assign(new Error('kill ESRCH'), { errno: ESRCH, code: 'ESRCH', syscall: 'kill' });
101
+ }
102
+ return kill.call(process, pid, signal);
103
+ };
73
104
  }
@@ -87,9 +87,12 @@ export async function checkFeed({ text, label, version, assets, hashAsset, requi
87
87
  for (const name of requiredFiles) {
88
88
  if (!byUrl.has(name)) problems.push(`${label}: files[] does not list ${name}`);
89
89
  }
90
+ // Every listed asset downloads at once; the problems keep files[] order.
91
+ const fileAssets = feed.files.map((file) => assets.find((candidate) => candidate.name === file.url));
92
+ const digests = await Promise.all(fileAssets.map((asset) => (asset ? hashAsset(asset) : null)));
90
93
  const hashes = new Map();
91
- for (const file of feed.files) {
92
- const asset = assets.find((candidate) => candidate.name === file.url);
94
+ for (const [index, file] of feed.files.entries()) {
95
+ const asset = fileAssets[index];
93
96
  if (!asset) {
94
97
  problems.push(`${label}: ${file.url} is not an uploaded asset`);
95
98
  continue;
@@ -99,7 +102,7 @@ export async function checkFeed({ text, label, version, assets, hashAsset, requi
99
102
  problems.push(`${label}: ${file.url} size ${size} != uploaded ${asset.size}`);
100
103
  }
101
104
  const sha512 = field(file, 'sha512');
102
- const actual = await hashAsset(asset);
105
+ const actual = digests[index];
103
106
  hashes.set(file.url, actual);
104
107
  if (sha512 !== actual) problems.push(`${label}: ${file.url} sha512 does not match the uploaded asset`);
105
108
  }
@@ -233,6 +236,25 @@ export async function detectPublished({ fetchRelease, sleep = defaultSleep, atte
233
236
  }
234
237
  }
235
238
 
239
+ /**
240
+ * Run independent `[name, run]` sections concurrently. Results keep the
241
+ * section order; a thrown section becomes a "check failed" problem.
242
+ */
243
+ export function runSections(sections) {
244
+ return Promise.all(
245
+ sections.map(async ([name, run]) => {
246
+ try {
247
+ const outcome = await run();
248
+ return Array.isArray(outcome)
249
+ ? { name, problems: outcome, warnings: [] }
250
+ : { name, problems: outcome.problems, warnings: outcome.warnings };
251
+ } catch (error) {
252
+ return { name, problems: [`check failed: ${error.message}`], warnings: [] };
253
+ }
254
+ })
255
+ );
256
+ }
257
+
236
258
  async function sha512Base64(url) {
237
259
  const response = await fetch(url, { redirect: 'follow' });
238
260
  if (!response.ok) throw new Error(`download ${url} answered ${response.status}`);
@@ -290,19 +312,7 @@ async function main() {
290
312
  ],
291
313
  ['npm', () => waitForNpm({ name: 'mixdog', version })],
292
314
  ];
293
- const results = [];
294
- for (const [name, run] of sections) {
295
- try {
296
- const outcome = await run();
297
- results.push(
298
- Array.isArray(outcome)
299
- ? { name, problems: outcome, warnings: [] }
300
- : { name, problems: outcome.problems, warnings: outcome.warnings }
301
- );
302
- } catch (error) {
303
- results.push({ name, problems: [`check failed: ${error.message}`], warnings: [] });
304
- }
305
- }
315
+ const results = await runSections(sections);
306
316
 
307
317
  const lines = [`## Post-release check for ${tag}`, ''];
308
318
  for (const { name, problems, warnings } of results) {
@@ -10,7 +10,7 @@
10
10
  // stores. Only the API-key secrets (`secrets/agent.<provider>.apiKey.dpapi`) and the
11
11
  // `agent` section of mixdog-config.json are copied in. OAuth providers (`*-oauth`, whose
12
12
  // refresh tokens could be rotated) are skipped unless `--real-data` is passed, which
13
- // restores the old behaviour of running against the real data dir. The isolated dir is
13
+ // runs against the real data dir instead. The isolated dir is
14
14
  // deleted at the end, after stopping only processes whose executable lives inside it.
15
15
  // Usage: node scripts/provider-pingpong-live.mjs [--suite extended] [--real-data] [case-name ...]
16
16
  import fs from 'node:fs';
@@ -118,7 +118,9 @@ export async function pruneEmbeddingRuntime(packageRoot, options = {}) {
118
118
  }
119
119
  }
120
120
  }
121
- await removeChildrenExcept(ortRoot, new Set(['package.json', 'dist', 'bin', 'node_modules']));
121
+ // npm runs onnxruntime-node's own postinstall (node ./script/install)
122
+ // concurrently with ours, so its script/ helpers must survive the prune.
123
+ await removeChildrenExcept(ortRoot, new Set(['package.json', 'dist', 'bin', 'node_modules', 'script']));
122
124
 
123
125
  // The Node bundle marks onnxruntime-web as an ignored webpack external. Keep
124
126
  // only its manifest so npm's dependency inventory remains coherent.
@@ -51,7 +51,13 @@ const PATCH_GATE_FILES = [
51
51
  // workflow, output-style and bundled-skill trees (scripts/build-shipped-history.mjs)
52
52
  // and committed under src/defaults/. Release re-checks it, so the gate checks
53
53
  // it first instead of letting a stale file fail the deploy late.
54
- const HISTORY_GATE_PREFIXES = ['src/agents/', 'src/workflows/', 'src/output-styles/', 'src/defaults/'];
54
+ const HISTORY_GATE_PREFIXES = [
55
+ 'src/agents/',
56
+ 'src/workflows/',
57
+ 'src/output-styles/',
58
+ 'src/orchestration/',
59
+ 'src/defaults/',
60
+ ];
55
61
  const HISTORY_GATE_FILES = [
56
62
  'scripts/build-shipped-history.mjs',
57
63
  'src/runtime/shared/shipped-definitions.mjs',
@@ -179,6 +179,20 @@
179
179
  "d5f205f3b57c0b9541b8acc237069287"
180
180
  ]
181
181
  },
182
+ "orchestration": {
183
+ "balanced.md": [
184
+ "ad1683ff1626ebabd4e027abe03fe29a"
185
+ ],
186
+ "focused.md": [
187
+ "e73b0d71f544900611b2d06f963472d4"
188
+ ],
189
+ "none.md": [
190
+ "9be4bf61f9ba91c4caf53296adff2e8a"
191
+ ],
192
+ "swarm.md": [
193
+ "7fa3e68e0c53d16203384f5ca645765d"
194
+ ]
195
+ },
182
196
  "skills": {
183
197
  "browser-use": [
184
198
  "00085086a7649ec6631f5cf0a3bbbf60",
@@ -233,6 +247,7 @@
233
247
  "27135bd0ba3468258d3b43c752501929",
234
248
  "398b50b687206544149feeb0a5b02c09",
235
249
  "3f8b7b4cd798dba866eccd7d09c76248",
250
+ "45534843b3a94a6ab2c6bb5f141c5133",
236
251
  "733d30c3ca6745c96a69f7e237f3d8c0",
237
252
  "75bdf20949f1e125f82b51ebca6a2ab4",
238
253
  "7b9ce58540ed4609f290dc981a7e1719",
@@ -250,6 +265,7 @@
250
265
  "e10367dd4291a0b3d8ee8e8dd60eae36",
251
266
  "e1f2526aaf123fb77072aa8975f890de",
252
267
  "e67f30ec5bbdd36d7feaabd35b7504b3",
268
+ "e84164eff9dc833fc52f24bd33ecd699",
253
269
  "edc3519cf07e37702a5793bb23e0643c",
254
270
  "f0798c546c172a742e3384d82322ede4"
255
271
  ],
@@ -312,6 +328,7 @@
312
328
  "1533630b81ebace2bc9ece6fda02bb11",
313
329
  "261a34fce0fb0f73abfd1b1e2add3602",
314
330
  "356bf57f7087fe2c40c5dcd99622c3e9",
331
+ "427128f8cd113299422ccd395194b272",
315
332
  "a8ffffd02f438cdd6005e09cfe6cf42f",
316
333
  "aad47f68614152e4b338cf3684f72304"
317
334
  ],
@@ -368,6 +385,7 @@
368
385
  ],
369
386
  "setup": [
370
387
  "0357c6d475ced8ba2446e6bda21899b4",
388
+ "0bb692f16b03c66f23af06cea06de51f",
371
389
  "0be31b379e919420e5b8f74926bdf6e5",
372
390
  "0d5c8c6e2349addf71d2ed2b4c1ccb1f",
373
391
  "0d6926aaca2890da9347f15a826546e3",
@@ -378,7 +396,9 @@
378
396
  "242f11864abdef90fa0cc9cb4599a579",
379
397
  "29a347c4d3a2f773fa92c627260301ba",
380
398
  "336ced846a9e4f774cbb109417856c3b",
399
+ "34c5f8fcb6292b8cc5239667d2119e83",
381
400
  "3716b2d2c2d973ae022694ed5cb756ad",
401
+ "398958b6f815bf8ad3f96dd288844333",
382
402
  "3dc990c29cdce1aca4b112d735ad5917",
383
403
  "3f72247651ad9d777b6754bfd46732aa",
384
404
  "50bdf35d06913236855080fdea6b50dc",
@@ -397,10 +417,12 @@
397
417
  "8b829db6b0675b62a71a1432dbd25490",
398
418
  "99d76213e70c6900d6af48ffa4045886",
399
419
  "9a2188ce201e4394bc18182131b7a3e1",
420
+ "9b10b59b27497a126b212df083ace020",
400
421
  "9f90d3872b1ecd312977ce661b770b31",
401
422
  "ade615dd0f6ae6ed1601023e5b9cb692",
402
423
  "b21681ecfeb523c0d7dd89a299ec05a9",
403
424
  "b4f9c79dcb08151e6275b5ee35c2bca4",
425
+ "b96f637e5a5acc2406fb1922f7004291",
404
426
  "bca9732a1cecd2ce3a26e905b57d3b25",
405
427
  "c6db973f51166fc42814808ae0001797",
406
428
  "c82197acd9111f4a6dcda24baccffb86",
@@ -417,9 +439,11 @@
417
439
  "ff18ac1a9f5961925aec27ffb870bae0"
418
440
  ],
419
441
  "setup-guide": [
442
+ "0968139f1aa26f48f03cfea2e94f45e8",
420
443
  "633e15b84dbe22f2b578b67cc35853d4",
421
444
  "72e474711ecd18cfcae6c8365e08286e",
422
445
  "920d5b29ccfe6c88f623cf0892b29285",
446
+ "dbe3d22991ad4dff6e3906f9101c9b5f",
423
447
  "ec88a82ab5e511c0afb1738162150648",
424
448
  "fa355d4ea5f1823e4b75219ab842c34a"
425
449
  ],
@@ -70,6 +70,9 @@ GNOME with Mixdog's own shell extension, which the app sets up); prefer accessib
70
70
  decorates the real pointer. Visual feedback is not proof of action success.
71
71
  A background semantic action may queue behind foreground work to protect
72
72
  focus; waiting for that guard never switches its delivery mode.
73
+ On Chromium and Electron targets a background semantic action can briefly
74
+ bring the target forward; one guarded attempt then tries to put the user's
75
+ window back, and it is skipped when the user has acted meanwhile.
73
76
  - **Foreground (explicit):** use when the target/gesture requires real pointer
74
77
  or keyboard focus, background is known unsupported, or the user requests a
75
78
  visible demonstration. A click or drag is not automatically foreground:
@@ -204,13 +207,21 @@ refs still work.
204
207
 
205
208
  ## Waiting and verification
206
209
 
207
- - `wait` inside `act` is only a short settle (5 s each, 10 s total).
210
+ - Every `act` already settles and re-observes, so add no trailing `wait`.
211
+ Use `wait` inside `act` only for a known async delay (5 s each, 10 s total):
212
+ it is a fixed pause. `quiet:true` ends it early once the window set,
213
+ foreground, title and bounds stop changing; use it when waiting for a window
214
+ or dialog to open, close or move. It does not see content changes inside a
215
+ window (canvas, text): a real condition is a `verify`.
208
216
  - `wait_for_user` waits for control to return, without holding the input queue.
209
217
  Read its status: a successful tool response alone does not mean it resumed.
210
218
  - For anything longer use `verify`: AND-combined predicates (`present`,
211
219
  `absent`, `title_contains`, `window_exists`) with `timeout_ms` and
212
220
  `stable_samples`. It reads state only, so prior refs stay valid.
213
221
  - Never loop on `capture` to poll; `verify` is the bounded wait.
222
+ - `verify` stops early with `unknown` and an `unknown_reason` when the window's
223
+ tree is cached unusable or its reads keep timing out; do not rerun it
224
+ unchanged.
214
225
  - `unknown` means the observation could not prove the condition. In particular,
215
226
  empty, truncated, or failed accessibility reads do not prove text is absent.
216
227
 
@@ -256,8 +267,8 @@ surface `computer`); one-time codes, passkeys, security keys and app approvals
256
267
  are the user's step (`handoff_user` kind `takeover`). Never type a password or
257
268
  code with `type`/`set_value`, even one shown on screen.
258
269
 
259
- **Keyboard-driven navigation** — `act` with `key` steps such as `ctrl+s`
260
- and a trailing short `wait`; verify with `verify` rather than another capture.
270
+ **Keyboard-driven navigation** — `act` with `key` steps such as `ctrl+s`;
271
+ the act settles itself. Verify with `verify` rather than another capture.
261
272
  `alt+f4` is blocked in every delivery mode. To close a window, obtain the
262
273
  user's go-ahead and use `window` with the `close` operation.
263
274