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
@@ -212,6 +212,11 @@ export const SETUP_EXTENDED_PROPERTIES = Object.freeze({
212
212
  description:
213
213
  "The bot id that owns the schedule or webhook; each run is a turn in that bot's chat, where it replies with the result. The bot must exist (no representative bot yet = refused). New entries default to the bot of the calling thread (the representative bot = lead); on overwrite, omission keeps the owner.",
214
214
  },
215
+ executorAgentId: {
216
+ ...removableText,
217
+ description:
218
+ 'The workflow sub-agent id (Worker, …) that carries out each run first, on its own model; only its final report goes to the owner bot, which relays it in its own words. Must be an enabled workflow sub-agent: never a bot (the representative bot included); unknown or turned-off ids are refused. Set it for recurring work that suits a sub-agent; leave it unset for trivial chat-only routines (the owner bot then does the work itself). null or "" clears it; on overwrite, omission keeps it.',
219
+ },
215
220
  overwrite: { ...boolean, description: 'Explicitly update an existing entry; omitted fields are preserved.' },
216
221
  },
217
222
  ['name']
@@ -238,6 +243,16 @@ export const SETUP_EXTENDED_PROPERTIES = Object.freeze({
238
243
  maximum: 400,
239
244
  description: 'Windows only: notification sound volume percent.',
240
245
  },
246
+ sessionAutoArchiveDays: {
247
+ type: 'integer',
248
+ enum: [0, 1, 7, 14, 30, 90],
249
+ description: 'Days without conversation before a session is archived; 0 = never (default 7).',
250
+ },
251
+ sessionAutoDeleteDays: {
252
+ type: 'integer',
253
+ enum: [0, 7, 30, 90],
254
+ description: 'Days archived before a session is deleted; 0 = never (default 90).',
255
+ },
241
256
  botOverlay: object(
242
257
  {
243
258
  enabled: {
@@ -284,8 +299,8 @@ export const SETUP_EXTENDED_PROPERTIES = Object.freeze({
284
299
  uiScale: {
285
300
  type: 'number',
286
301
  minimum: 0.85,
287
- maximum: 1.2,
288
- description: 'UI size multiplier, 0.85-1.2 in steps of 0.05 (default 1).',
302
+ maximum: 1.5,
303
+ description: 'UI size multiplier, 0.85-1.5 in steps of 0.05 (default 1).',
289
304
  },
290
305
  codeSize: {
291
306
  type: 'integer',
@@ -302,6 +317,17 @@ export const SETUP_EXTENDED_PROPERTIES = Object.freeze({
302
317
  markdownDefaultView: { type: 'string', enum: ['preview', 'rich', 'source'] },
303
318
  linkPreview: boolean,
304
319
  toolActivityExpansion: { type: 'string', enum: ['collapsed', 'commands', 'all'] },
320
+ composerStyle: {
321
+ type: 'string',
322
+ enum: ['simple', 'basic', 'detail'],
323
+ description:
324
+ 'How much the composer shows: simple = the model only; basic (UI label "Normal") = plus usage; detail = plus workflow and delegation (default detail).',
325
+ },
326
+ questionAnswerConfirm: {
327
+ ...boolean,
328
+ description:
329
+ 'On: picking a single-choice question option only selects it until Send/Next; off: the pick answers at once (default off).',
330
+ },
305
331
  uiFont: { ...text, description: 'Installed font family for the UI; "" restores the built-in font.' },
306
332
  codeFont: { ...text, description: 'Installed font family for code; "" restores the built-in font.' },
307
333
  skinTransparency: {
@@ -377,4 +403,6 @@ export const SETUP_HANDOFFS = Object.freeze({
377
403
  notifications: 'Notification permission/subscription requires a user gesture on the device receiving notifications.',
378
404
  pairing: 'Pairing credentials and OS permission approvals remain in the visible UI.',
379
405
  memoryContent: 'Use the memory tool for Core Memory, not setup.',
406
+ instructionTexts:
407
+ 'The Delegation and Output style instruction texts are edited in Settings → Delegation / Output style (revision-checked free text); choose the active output style with set_output_style.',
380
408
  });
@@ -447,13 +447,38 @@ export const SETUP_TOOL_DEFS = Object.freeze([
447
447
  enum: [...WORKTREE_NEW_TASK_DEFAULTS],
448
448
  description: 'branch = new tasks use the current branch (default); worktree = a new worktree.',
449
449
  },
450
- branchPrefix: { type: 'string', description: 'Ref prefix ending with "/"; default "mixdog/".' },
450
+ branchPrefix: {
451
+ type: 'string',
452
+ description:
453
+ 'Optional ref prefix ending with "/", e.g. "mixdog/"; "" (default) names branches after the task alone.',
454
+ },
451
455
  sizeWarnBytes: {
452
456
  type: 'integer',
453
457
  minimum: 0,
454
458
  description: 'Repository size that asks for confirmation first; 0 never asks.',
455
459
  },
456
460
  autoCleanup: { type: 'boolean', description: 'Remove clean, merged worktrees when their task ends.' },
461
+ maxWorktrees: {
462
+ type: 'integer',
463
+ minimum: 0,
464
+ maximum: 1000,
465
+ description:
466
+ 'With autoCleanup: keep at most this many worktrees, least recently used cleaned first; 0 = no limit. Default 15.',
467
+ },
468
+ unusedDays: {
469
+ type: 'integer',
470
+ minimum: 0,
471
+ maximum: 3650,
472
+ description: 'With autoCleanup: clean up worktrees unused this many days; 0 = never. Default 30.',
473
+ },
474
+ cleanupArchived: {
475
+ type: 'boolean',
476
+ description: 'With autoCleanup: archiving a session cleans up its worktrees. Default true.',
477
+ },
478
+ deleteBranch: {
479
+ type: 'boolean',
480
+ description: 'Cleanup also deletes the branch (its tip stays under a recovery ref). Default false.',
481
+ },
457
482
  },
458
483
  description: 'set_worktree_settings: only the given fields change.',
459
484
  },
@@ -13,10 +13,7 @@ import {
13
13
  } from '../../runtime/agent/orchestrator/session/manager/workflow-switch-notice.mjs';
14
14
  import { sessionTailCacheExpired } from '../../runtime/agent/orchestrator/agent-runtime/cache-strategy.mjs';
15
15
  import { mergePendingDeferredToolDelta } from '../../runtime/agent/orchestrator/runtime-core/deferred-tool-delta.mjs';
16
- import {
17
- agentMcpToolPermission,
18
- connectorPolicyAgentOf,
19
- } from '../../runtime/agent/orchestrator/mcp/agent-connectors.mjs';
16
+ import { foldLateDeferredTools } from '../../runtime/agent/orchestrator/runtime-core/tool-catalog.mjs';
20
17
  import { agentListEntries } from '../../runtime/agent/orchestrator/session/manager/prompt-utils.mjs';
21
18
  import { markToolSurfaceMigrated } from '../../runtime/agent/orchestrator/session/loop/tool-exposure-migration.mjs';
22
19
  import { resetBp2StableContext } from '../../runtime/agent/orchestrator/context/collect.mjs';
@@ -92,24 +89,14 @@ function cacheCold(session) {
92
89
  );
93
90
  }
94
91
 
95
- // The connector tools among `names` the session's agent may run now.
96
- function connectorTools(session, names) {
97
- const agent = connectorPolicyAgentOf(session);
98
- return [...names]
99
- .filter((name) => name.startsWith('mcp__') && agentMcpToolPermission(agent, name) !== 'disabled')
100
- .sort();
101
- }
102
-
103
- // A bot thread's tools that changed without its prompt: feature gates that
104
- // opened (or closed) and connectors added or removed. Nothing in the request
105
- // prefix moves. An opened tool joins the deferred catalog — reachable by
92
+ // A bot thread's tools that changed without its prompt: workflow and
93
+ // reaction gates that opened (or closed). Nothing in the request prefix
94
+ // moves. An opened tool joins the late deferred catalog — reachable by
106
95
  // deferred loading, which brings its schema into the conversation — and a
107
96
  // gone one is refused at call time; the next turn's deferred_tools_delta
108
97
  // notice names both. Gate changes are folded into the prompt at the next
109
- // cold point (promptFoldPending). Connectors live in the bot's agent.json,
110
- // so they are compared only when its profile stamp moved (`edited`).
111
- // Returns true when anything changed.
112
- function stageLiveToolChanges({ liveDeniedTools, modelStandaloneTools }, session, workflow, { edited = false } = {}) {
98
+ // cold point (promptFoldPending). Returns true when anything changed.
99
+ function stageLiveToolChanges({ liveDeniedTools, modelStandaloneTools }, session, workflow) {
113
100
  const added = [];
114
101
  const removed = [];
115
102
  const known = new Map(schemaTools(session).map((tool) => [toolName(tool), tool]));
@@ -121,24 +108,17 @@ function stageLiveToolChanges({ liveDeniedTools, modelStandaloneTools }, session
121
108
  const fresh = modelStandaloneTools().filter(
122
109
  (tool) => opened.includes(toolName(tool)) && !known.has(toolName(tool))
123
110
  );
124
- if (fresh.length) session.deferredToolCatalog = [...(session.deferredToolCatalog || []), ...fresh];
111
+ // The late pool, never the boot catalog a native request keeps byte-stable.
112
+ if (fresh.length) session.deferredLateToolCatalog = [...(session.deferredLateToolCatalog || []), ...fresh];
125
113
  for (const tool of fresh) known.set(toolName(tool), tool);
126
114
  session.disallowedTools = [...live];
127
115
  added.push(...opened.filter((name) => known.has(name)));
128
116
  removed.push(...closed);
129
117
  session.promptFoldPending = true;
130
118
  }
131
- // Connectors gate MCP tools at call time only (pre-dispatch-deny.mjs).
132
- const previous = session.agentConnectorTools;
133
- const permitted = edited || !Array.isArray(previous) ? connectorTools(session, known.keys()) : previous;
134
- session.agentConnectorTools = permitted;
135
- if (edited && Array.isArray(previous)) {
136
- added.push(...permitted.filter((name) => !previous.includes(name)));
137
- removed.push(...previous.filter((name) => !permitted.includes(name)));
138
- }
139
- if (!added.length && !removed.length) {
140
- return opened.length + closed.length > 0 || !Array.isArray(previous);
141
- }
119
+ // Connector moves are staged at every turn start, for every session kind
120
+ // (tool-availability.mjs stageConnectorAvailability).
121
+ if (!added.length && !removed.length) return opened.length + closed.length > 0;
142
122
  mergePendingDeferredToolDelta(session, {
143
123
  added: added.map((name) => ({ name, description: known.get(name)?.description || '' })),
144
124
  removed,
@@ -162,7 +142,8 @@ function liftAgentDenial({ liveDeniedTools, modelStandaloneTools }, session) {
162
142
  if (!known.has('agent')) {
163
143
  const fresh = modelStandaloneTools().filter((tool) => toolName(tool) === 'agent');
164
144
  if (!fresh.length) return false;
165
- session.deferredToolCatalog = [...(session.deferredToolCatalog || []), ...fresh];
145
+ // The late pool, never the boot catalog a native request keeps byte-stable.
146
+ session.deferredLateToolCatalog = [...(session.deferredLateToolCatalog || []), ...fresh];
166
147
  known.set('agent', fresh[0]);
167
148
  }
168
149
  session.disallowedTools = disallowed.filter((name) => name !== 'agent');
@@ -185,6 +166,7 @@ export function createAgentProfileFold({
185
166
  liveDeniedTools,
186
167
  stagePolicy,
187
168
  applyPolicy,
169
+ presentPromptSettings = () => {},
188
170
  turnInFlight,
189
171
  }) {
190
172
  // An agent profile edit that met a running turn: the next turn applies it.
@@ -206,7 +188,13 @@ export function createAgentProfileFold({
206
188
  // re-appends its deferred manifest.
207
189
  if (typeof staged.stableContext === 'string') resetBp2StableContext(session, staged.stableContext);
208
190
  applyPolicy(session, staged);
191
+ // Late tools join the rebuilt manifest (MCP instructions return with the
192
+ // server's next tool load): no notice.
193
+ foldLateDeferredTools(session);
209
194
  rewriteConversationBp3Core(session, staged.core);
195
+ // Every prompt setting as it stands — style, profile, language, core
196
+ // memory, instruction files — so no part of the prompt contradicts another.
197
+ presentPromptSettings(session, staged);
210
198
  if (session.agentProfileRevision !== undefined) {
211
199
  session.agentProfileRevision = agentProfileRevision(identity.agent, { mixy: agentMode });
212
200
  const { leadPromptParts } = activeWorkflowContext(config, getDataDir());
@@ -231,7 +219,9 @@ export function createAgentProfileFold({
231
219
  // prompt they were created with; they are task-scoped, and their skill
232
220
  // bodies are still restored from current sources at Compact.
233
221
  if (!session?.id || !session.promptIdentity || isAgentOwner(session)) return false;
234
- const compacted = COLD_INTENTS.has(session.pendingCacheBreakIntent);
222
+ // A compaction is a cold point: the prompt is rebuilt instead of the
223
+ // dropped notices being sent again (pre-send compaction marks it).
224
+ const compacted = COLD_INTENTS.has(session.pendingCacheBreakIntent) || session.compactionFoldPending === true;
235
225
  if (!compacted && !(foldPending(session) && cacheCold(session))) return false;
236
226
  return foldPrompt(session, PROMPT_FOLD_INTENT);
237
227
  }
@@ -256,7 +246,7 @@ export function createAgentProfileFold({
256
246
  * release changed wait silently; both are folded in at the next cold point
257
247
  * (foldPromptIfCold). Returns true when the session changed (save it).
258
248
  */
259
- async function refreshAgentProfile({ trigger = 'save' } = {}) {
249
+ async function refreshAgentProfile({ trigger = 'save', onlyIfEdited = false } = {}) {
260
250
  const session = getSession?.();
261
251
  const identity = session?.promptIdentity;
262
252
  const agent = identity?.agent;
@@ -276,15 +266,14 @@ export function createAgentProfileFold({
276
266
  const edited =
277
267
  recoverMode || session.agentProfileRevision !== revision || (agentMode && session.agentRosterRevision !== roster);
278
268
  // At a turn's start its own turn is the one counted; nothing runs yet.
269
+ if (onlyIfEdited && !edited) return false;
279
270
  const busy = () => getSession?.() !== session || (trigger !== 'turn' && turnInFlight(session));
280
271
  if (busy()) {
281
272
  agentProfilePending = true;
282
273
  return false;
283
274
  }
284
275
  const toolsChanged = agentMode
285
- ? stageLiveToolChanges({ liveDeniedTools, modelStandaloneTools }, session, workflow, {
286
- edited: session.agentProfileRevision !== revision,
287
- })
276
+ ? stageLiveToolChanges({ liveDeniedTools, modelStandaloneTools }, session, workflow)
288
277
  : trigger === 'resume' && syncAgentListing(session);
289
278
  if (!edited) return (trigger === 'resume' && (await foldPromptIfCold())) || toolsChanged;
290
279
  // A coding session from before profile stamps keeps its prompt when it
@@ -315,14 +304,22 @@ export function createAgentProfileFold({
315
304
  * fold pending prompt changes if the cache is cold anyway. */
316
305
  async function applyPendingAgentProfile() {
317
306
  let changed = false;
318
- // A bot thread's connector baseline, before any edit can be compared to it.
319
307
  const session = getSession?.();
320
- if (session?.id && sessionModeOf(session) === AGENT_MODE && !Array.isArray(session.agentConnectorTools)) {
321
- session.agentConnectorTools = connectorTools(session, schemaTools(session).map(toolName));
322
- }
323
- if (agentProfilePending || orchestrationRecoveryNeeded(session)) {
308
+ // A bot thread compares its profile and roster stamps every turn, so hand
309
+ // edits and other processes' saves of AGENT.md, PERSONA.md and the roster
310
+ // reach it too.
311
+ // A thread from before profile stamps keeps its prompt until a save.
312
+ const botThread = Boolean(
313
+ session?.id &&
314
+ session.promptIdentity?.agent &&
315
+ sessionModeOf(session) === AGENT_MODE &&
316
+ session.agentProfileRevision !== undefined
317
+ );
318
+ const pending = agentProfilePending || orchestrationRecoveryNeeded(session);
319
+ if (pending || botThread) {
324
320
  agentProfilePending = false;
325
- changed = await refreshAgentProfile({ trigger: 'turn' });
321
+ // A turn with nothing pending acts only on moved stamps.
322
+ changed = await refreshAgentProfile({ trigger: 'turn', onlyIfEdited: !pending });
326
323
  }
327
324
  changed = (await foldPromptIfCold()) || changed;
328
325
  return syncAgentListing(session) || changed;
@@ -17,7 +17,7 @@ function modeLoadableTools(session, mode) {
17
17
  ...toolNames(session.deferredCallableTools),
18
18
  ...toolNames(session.deferredDiscoveredTools),
19
19
  ]);
20
- const deferred = new Set(toolNames(session.deferredToolCatalog));
20
+ const deferred = new Set([...toolNames(session.deferredToolCatalog), ...toolNames(session.deferredLateToolCatalog)]);
21
21
  const denied = new Set(
22
22
  [...(session.disallowedTools || []), ...(session.workflowOverlay?.deniedTools || [])].map(String)
23
23
  );
@@ -17,9 +17,19 @@ import {
17
17
  } from '../../runtime/agent/orchestrator/context/collect.mjs';
18
18
  import {
19
19
  _buildBaseRules,
20
+ _buildLeadLanguage,
21
+ _buildLeadLanguageContext,
20
22
  _buildLeadMetaContext,
21
23
  } from '../../runtime/agent/orchestrator/session/manager/rules-cache.mjs';
22
- import { sessionRolePromptFields } from '../../runtime/agent/orchestrator/session/manager/session-prompt-composition.mjs';
24
+ import {
25
+ notePromptSettingsPresented,
26
+ promptConfigSlice,
27
+ } from '../../runtime/agent/orchestrator/session/manager/prompt-settings.mjs';
28
+ import { normalizeInstructionFilesMode } from '../../runtime/shared/instruction-files-mode.mjs';
29
+ import {
30
+ buildWorkspacePromptContext,
31
+ sessionRolePromptFields,
32
+ } from '../../runtime/agent/orchestrator/session/manager/session-prompt-composition.mjs';
23
33
  import {
24
34
  delegationDisabled,
25
35
  honoredSchemaAllowlist,
@@ -32,14 +42,19 @@ import { AGENT_MODE, sessionModeOf } from '../../runtime/agent/orchestrator/sess
32
42
  import { unusedModelEditToolName } from '../../runtime/shared/edit-tool-dialect.mjs';
33
43
  import {
34
44
  presentedAgentCatalogSlice,
45
+ refreshSessionBp3Environment,
46
+ replaceLanguageBlock,
47
+ replaceWorkspaceCoreSlices,
48
+ replaceWorkspaceEnvironment,
35
49
  withPresentedWorkspaceSlices,
36
50
  } from '../../runtime/agent/orchestrator/session/manager/prompt-utils.mjs';
37
- import { leadPartsFor, rewriteSystemHeading, toolNames } from './surface-helpers.mjs';
51
+ import { leadPartsFor, rewriteConversationBp3Core, rewriteSystemHeading, toolNames } from './surface-helpers.mjs';
38
52
 
39
53
  export function createPolicyStage({
40
54
  getRoute,
41
55
  getMode,
42
56
  getDataDir,
57
+ getConfig,
43
58
  modelStandaloneTools,
44
59
  featureDisallowedTools,
45
60
  loadCoreMemoryContext,
@@ -96,17 +111,58 @@ export function createPolicyStage({
96
111
  }
97
112
  }
98
113
 
114
+ // The prompt-shaping settings sections `session` renders from `config` (the
115
+ // runtime's in-memory config) and `coreMemoryContext`, as session creation
116
+ // composes them (session-prompt-composition.mjs composeSessionSystem).
117
+ // `language` is the response language block closing the environment.
118
+ function promptSettingsSections(session, identity, config, coreMemoryContext) {
119
+ const ownerIsAgent = isAgentOwner(session);
120
+ const schemaAllowedTools = honoredSchemaAllowlist(session.schemaAllowedTools, {
121
+ ownerIsAgent,
122
+ agent: identity.agent,
123
+ });
124
+ const toolFreeRole = ownerIsAgent && schemaAllowedTools?.length === 0;
125
+ const agentMode = sessionModeOf(session) === AGENT_MODE;
126
+ const lead = !identity.skipAgentRules && !toolFreeRole && !ownerIsAgent;
127
+ const slice = promptConfigSlice(config);
128
+ const skip = identity.profileSkip || {};
129
+ const skills = schemaAllowedTools?.length === 0 ? [] : collectPromptSkillsCached(session.cwd, config);
130
+ const { packContext, summary, leadPromptParts, orchestrationMode } = activeWorkflowContext(config, getDataDir());
131
+ // A coding Lead's mode text, as session creation records it.
132
+ const codingLead = !ownerIsAgent && !agentMode;
133
+ return {
134
+ meta: lead ? _buildLeadMetaContext({ includeOutputStyle: !agentMode, config: slice }) : '',
135
+ // The workflow pack and the skill listing BP2 carries.
136
+ workflow: String(packContext || ''),
137
+ workflowName: summary?.name || summary?.id || null,
138
+ orchestration: codingLead ? String(leadPartsFor(session, leadPromptParts).orchestrationContext || '') : '',
139
+ orchestrationMode: codingLead ? orchestrationMode || '' : '',
140
+ skills: buildSkillManifest(skills),
141
+ instructionFilesMode: normalizeInstructionFilesMode(slice?.instructionFiles),
142
+ language: lead ? _buildLeadLanguageContext({ includeOutputStyle: !agentMode, config: slice }) : '',
143
+ instructionFiles:
144
+ toolFreeRole || agentMode || skip.claudemd ? '' : String(loadInstructionFilesContext?.(session) || ''),
145
+ coreMemory: skip.memory ? '' : String(coreMemoryContext || ''),
146
+ // Not a section: the language per-request rules match (tail-reminder-rules.mjs).
147
+ responseLanguage: lead ? _buildLeadLanguage({ config: slice }) || null : null,
148
+ };
149
+ }
150
+
99
151
  // The policy `config` gives `session`, computed without touching the
100
152
  // session, so a turn that starts during the async rebuild cannot lose tools
101
153
  // to it. `conversation`: the rebuilt BP3 core keeps the instruction files
102
154
  // and core memory the prompt presents now (withPresentedWorkspaceSlices).
103
- async function stagePolicy(session, identity, config, { conversation = false } = {}) {
155
+ // `settings`: the prompt settings sections as they stand (a fold or an
156
+ // empty rebuild presents them); `coreMemoryContext` a snapshot already read.
157
+ async function stagePolicy(session, identity, config, { conversation = false, coreMemoryContext: memory } = {}) {
104
158
  const ownerIsAgent = isAgentOwner(session);
105
159
  const schemaAllowedTools = honoredSchemaAllowlist(session.schemaAllowedTools, {
106
160
  ownerIsAgent,
107
161
  agent: identity.agent,
108
162
  });
109
163
  const toolFreeRole = ownerIsAgent && schemaAllowedTools?.length === 0;
164
+ const freshMemory = memory ?? (await leadCoreMemoryContext());
165
+ const settings = promptSettingsSections(session, identity, config, freshMemory);
110
166
 
111
167
  const {
112
168
  summary: workflow,
@@ -139,12 +195,11 @@ export function createPolicyStage({
139
195
  provider: getRoute()?.provider,
140
196
  model: getRoute()?.model,
141
197
  });
142
- const coreMemoryContext = conversation ? '' : await leadCoreMemoryContext();
198
+ const coreMemoryContext = conversation ? '' : freshMemory;
143
199
  // BP2's stable part as session creation composes it
144
200
  // (session-prompt-composition.mjs): the Lead meta context and the skill
145
201
  // manifest of the skills in scope now.
146
202
  const skipRules = identity.skipAgentRules || toolFreeRole;
147
- const skills = schemaAllowedTools?.length === 0 ? [] : collectPromptSkillsCached(session.cwd);
148
203
  const { sessionMarkerCore, stableSystemContext } = composeSystemPrompt({
149
204
  ...sessionRolePromptFields(identity, {
150
205
  ownerIsAgent,
@@ -160,8 +215,8 @@ export function createPolicyStage({
160
215
  // setting; agent mode carries none.
161
216
  instructionFilesContext:
162
217
  conversation || toolFreeRole || agentMode ? null : loadInstructionFilesContext?.(session) || null,
163
- metaContext: skipRules || ownerIsAgent ? undefined : _buildLeadMetaContext({ includeOutputStyle: !agentMode }),
164
- skillManifest: buildSkillManifest(skills),
218
+ metaContext: settings.meta || undefined,
219
+ skillManifest: settings.skills,
165
220
  });
166
221
  return {
167
222
  workflow,
@@ -174,9 +229,44 @@ export function createPolicyStage({
174
229
  core: conversation ? withPresentedWorkspaceSlices(session, sessionMarkerCore) : sessionMarkerCore,
175
230
  // Without BP1 the BP2 block cannot be located: null leaves it as it is.
176
231
  stableContext: skipRules ? null : stableSystemContext,
232
+ settings,
177
233
  };
178
234
  }
179
235
 
236
+ /**
237
+ * Make the prompt present `staged.settings` (an empty session's rebuild, a
238
+ * fold): the BP3 core's instruction files and core memory and the language
239
+ * block closing the environment; the caller has written BP2 and the core.
240
+ * A staged workspace re-root keeps the slices it will replace itself.
241
+ */
242
+ function presentPromptSettings(session, staged) {
243
+ const { settings } = staged;
244
+ if (!session.workspaceReroot) {
245
+ rewriteConversationBp3Core(
246
+ session,
247
+ replaceWorkspaceCoreSlices(staged.core, {
248
+ coreMemoryContext: settings.coreMemory,
249
+ instructionFilesContext: settings.instructionFiles,
250
+ })
251
+ );
252
+ }
253
+ if (typeof session.bp3EnvironmentContext === 'string') {
254
+ session.bp3EnvironmentContext = replaceLanguageBlock(session.bp3EnvironmentContext, settings.language);
255
+ refreshSessionBp3Environment(session, session.cwd);
256
+ }
257
+ notePromptSettingsPresented(session, settings);
258
+ }
259
+
260
+ /** An empty session's rebuild: the shell, git and listing facts as they stand. */
261
+ function refreshEnvironmentFacts(session) {
262
+ if (typeof session.bp3EnvironmentContext !== 'string' || !session.cwd || session.workspaceReroot) return;
263
+ const { environmentContext } = buildWorkspacePromptContext(session, session.cwd, {
264
+ instructionFilesMode: promptConfigSlice(getConfig?.())?.instructionFiles,
265
+ });
266
+ session.bp3EnvironmentContext = replaceWorkspaceEnvironment(session.bp3EnvironmentContext, environmentContext);
267
+ refreshSessionBp3Environment(session, session.cwd);
268
+ }
269
+
180
270
  // Apply a staged policy synchronously; the BP3 core is the caller's. The
181
271
  // prompt then carries the session's workflow and tools as they stand.
182
272
  function applyPolicy(session, staged) {
@@ -184,6 +274,7 @@ export function createPolicyStage({
184
274
  delete session.orchestrationModeOverlay;
185
275
  delete session.workflowOpenedTools;
186
276
  delete session.promptFoldPending;
277
+ delete session.compactionFoldPending;
187
278
  session.workflow = toSessionWorkflowMeta(staged.workflow);
188
279
  session.orchestrationMode = staged.orchestrationMode;
189
280
  session.sessionMode = staged.sessionMode;
@@ -197,5 +288,12 @@ export function createPolicyStage({
197
288
  session.updatedAt = Date.now();
198
289
  }
199
290
 
200
- return { liveDeniedTools, stagePolicy, applyPolicy };
291
+ return {
292
+ liveDeniedTools,
293
+ stagePolicy,
294
+ applyPolicy,
295
+ promptSettingsSections,
296
+ presentPromptSettings,
297
+ refreshEnvironmentFacts,
298
+ };
201
299
  }
@@ -78,7 +78,8 @@ export function createWorkflowOverlay({ liveDeniedTools, modelStandaloneTools })
78
78
  if (!loadableTools.length) return;
79
79
  const opened = session.workflowOpenedTools || [];
80
80
  session.workflowOpenedTools = [...new Set([...opened, ...loadableTools])];
81
- if (fresh.length) session.deferredToolCatalog = [...(session.deferredToolCatalog || []), ...fresh];
81
+ // The late pool, never the boot catalog a native request keeps byte-stable.
82
+ if (fresh.length) session.deferredLateToolCatalog = [...(session.deferredLateToolCatalog || []), ...fresh];
82
83
  session.disallowedTools = (session.disallowedTools || []).filter((name) => !loadableTools.includes(String(name)));
83
84
  const byName = new Map(schemaTools(session).map((tool) => [toolName(tool), tool]));
84
85
  // Announced on every switch that opens them: a pending removal (a switch