@draht/coding-agent 2026.7.30 → 2026.9.5-1

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 (459) hide show
  1. package/CHANGELOG.md +154 -0
  2. package/README.md +46 -2
  3. package/agents/debugger.md +12 -1
  4. package/agents/git-committer.md +1 -0
  5. package/agents/implementer.md +20 -0
  6. package/agents/investigator.md +75 -0
  7. package/agents/reviewer.md +7 -0
  8. package/agents/spec-reviewer.md +66 -0
  9. package/agents/verifier.md +4 -3
  10. package/bin/draht-tools.cjs +472 -41
  11. package/dist/agents/debugger.md +12 -1
  12. package/dist/agents/git-committer.md +1 -0
  13. package/dist/agents/implementer.md +20 -0
  14. package/dist/agents/investigator.md +75 -0
  15. package/dist/agents/reviewer.md +7 -0
  16. package/dist/agents/spec-reviewer.md +66 -0
  17. package/dist/agents/verifier.md +4 -3
  18. package/dist/cli/args.d.ts +10 -0
  19. package/dist/cli/args.d.ts.map +1 -1
  20. package/dist/cli/args.js +69 -2
  21. package/dist/cli/args.js.map +1 -1
  22. package/dist/cli/attach-mode.d.ts +61 -0
  23. package/dist/cli/attach-mode.d.ts.map +1 -1
  24. package/dist/cli/attach-mode.js +243 -5
  25. package/dist/cli/attach-mode.js.map +1 -1
  26. package/dist/cli/credential-print.d.ts +1 -1
  27. package/dist/cli/credential-print.d.ts.map +1 -1
  28. package/dist/cli/credential-print.js +5 -4
  29. package/dist/cli/credential-print.js.map +1 -1
  30. package/dist/config.d.ts +9 -0
  31. package/dist/config.d.ts.map +1 -1
  32. package/dist/config.js +31 -4
  33. package/dist/config.js.map +1 -1
  34. package/dist/core/agent-session-runtime.d.ts +17 -1
  35. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  36. package/dist/core/agent-session-runtime.js +87 -30
  37. package/dist/core/agent-session-runtime.js.map +1 -1
  38. package/dist/core/agent-session-services.d.ts +1 -1
  39. package/dist/core/agent-session-services.d.ts.map +1 -1
  40. package/dist/core/agent-session-services.js +1 -0
  41. package/dist/core/agent-session-services.js.map +1 -1
  42. package/dist/core/agent-session.d.ts +35 -16
  43. package/dist/core/agent-session.d.ts.map +1 -1
  44. package/dist/core/agent-session.js +149 -64
  45. package/dist/core/agent-session.js.map +1 -1
  46. package/dist/core/auth-storage.d.ts +5 -1
  47. package/dist/core/auth-storage.d.ts.map +1 -1
  48. package/dist/core/auth-storage.js +72 -15
  49. package/dist/core/auth-storage.js.map +1 -1
  50. package/dist/core/builtins/checkpoints.d.ts +20 -0
  51. package/dist/core/builtins/checkpoints.d.ts.map +1 -0
  52. package/dist/core/builtins/checkpoints.js +161 -0
  53. package/dist/core/builtins/checkpoints.js.map +1 -0
  54. package/dist/core/builtins/duet.d.ts +26 -0
  55. package/dist/core/builtins/duet.d.ts.map +1 -0
  56. package/dist/core/builtins/duet.js +660 -0
  57. package/dist/core/builtins/duet.js.map +1 -0
  58. package/dist/core/builtins/index.d.ts.map +1 -1
  59. package/dist/core/builtins/index.js +7 -1
  60. package/dist/core/builtins/index.js.map +1 -1
  61. package/dist/core/builtins/subagent.d.ts +24 -4
  62. package/dist/core/builtins/subagent.d.ts.map +1 -1
  63. package/dist/core/builtins/subagent.js +278 -35
  64. package/dist/core/builtins/subagent.js.map +1 -1
  65. package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
  66. package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
  67. package/dist/core/checkpoints/checkpoint-cli.js +78 -0
  68. package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
  69. package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
  70. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
  71. package/dist/core/checkpoints/checkpoint-manager.js +865 -0
  72. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
  73. package/dist/core/checkpoints/rewind.d.ts +141 -0
  74. package/dist/core/checkpoints/rewind.d.ts.map +1 -0
  75. package/dist/core/checkpoints/rewind.js +246 -0
  76. package/dist/core/checkpoints/rewind.js.map +1 -0
  77. package/dist/core/compaction/branch-summarization.d.ts +1 -1
  78. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  79. package/dist/core/compaction/branch-summarization.js +9 -4
  80. package/dist/core/compaction/branch-summarization.js.map +1 -1
  81. package/dist/core/compaction/compaction.d.ts +5 -0
  82. package/dist/core/compaction/compaction.d.ts.map +1 -1
  83. package/dist/core/compaction/compaction.js +25 -4
  84. package/dist/core/compaction/compaction.js.map +1 -1
  85. package/dist/core/extensions/index.d.ts +1 -1
  86. package/dist/core/extensions/index.d.ts.map +1 -1
  87. package/dist/core/extensions/index.js.map +1 -1
  88. package/dist/core/extensions/loader.d.ts.map +1 -1
  89. package/dist/core/extensions/loader.js +83 -20
  90. package/dist/core/extensions/loader.js.map +1 -1
  91. package/dist/core/extensions/runner.d.ts +13 -2
  92. package/dist/core/extensions/runner.d.ts.map +1 -1
  93. package/dist/core/extensions/runner.js +37 -2
  94. package/dist/core/extensions/runner.js.map +1 -1
  95. package/dist/core/extensions/types.d.ts +189 -6
  96. package/dist/core/extensions/types.d.ts.map +1 -1
  97. package/dist/core/extensions/types.js.map +1 -1
  98. package/dist/core/http-dispatcher.d.ts.map +1 -1
  99. package/dist/core/http-dispatcher.js +7 -0
  100. package/dist/core/http-dispatcher.js.map +1 -1
  101. package/dist/core/index.d.ts +1 -1
  102. package/dist/core/index.d.ts.map +1 -1
  103. package/dist/core/index.js.map +1 -1
  104. package/dist/core/keybindings.d.ts +5 -0
  105. package/dist/core/keybindings.d.ts.map +1 -1
  106. package/dist/core/keybindings.js +1 -0
  107. package/dist/core/keybindings.js.map +1 -1
  108. package/dist/core/model-registry.d.ts +3 -2
  109. package/dist/core/model-registry.d.ts.map +1 -1
  110. package/dist/core/model-registry.js +8 -8
  111. package/dist/core/model-registry.js.map +1 -1
  112. package/dist/core/model-resolver.d.ts.map +1 -1
  113. package/dist/core/model-resolver.js +34 -7
  114. package/dist/core/model-resolver.js.map +1 -1
  115. package/dist/core/model-runtime.d.ts +7 -1
  116. package/dist/core/model-runtime.d.ts.map +1 -1
  117. package/dist/core/model-runtime.js +30 -10
  118. package/dist/core/model-runtime.js.map +1 -1
  119. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  120. package/dist/core/multi-agent/permission-gate.js +4 -3
  121. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  122. package/dist/core/multi-agent/worktree.d.ts +2 -0
  123. package/dist/core/multi-agent/worktree.d.ts.map +1 -1
  124. package/dist/core/multi-agent/worktree.js +2 -2
  125. package/dist/core/multi-agent/worktree.js.map +1 -1
  126. package/dist/core/package-manager.d.ts +7 -1
  127. package/dist/core/package-manager.d.ts.map +1 -1
  128. package/dist/core/package-manager.js +21 -44
  129. package/dist/core/package-manager.js.map +1 -1
  130. package/dist/core/permission-relay/index.d.ts +19 -0
  131. package/dist/core/permission-relay/index.d.ts.map +1 -0
  132. package/dist/core/permission-relay/index.js +49 -0
  133. package/dist/core/permission-relay/index.js.map +1 -0
  134. package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
  135. package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
  136. package/dist/core/permission-relay/relay-ui-context.js +788 -0
  137. package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
  138. package/dist/core/permission-relay/types.d.ts +222 -0
  139. package/dist/core/permission-relay/types.d.ts.map +1 -0
  140. package/dist/core/permission-relay/types.js +15 -0
  141. package/dist/core/permission-relay/types.js.map +1 -0
  142. package/dist/core/pi-manifest.d.ts +14 -0
  143. package/dist/core/pi-manifest.d.ts.map +1 -0
  144. package/dist/core/pi-manifest.js +35 -0
  145. package/dist/core/pi-manifest.js.map +1 -0
  146. package/dist/core/project-trust.js +2 -2
  147. package/dist/core/project-trust.js.map +1 -1
  148. package/dist/core/resource-loader.d.ts +21 -0
  149. package/dist/core/resource-loader.d.ts.map +1 -1
  150. package/dist/core/resource-loader.js +101 -24
  151. package/dist/core/resource-loader.js.map +1 -1
  152. package/dist/core/sandbox/bash-operations.d.ts +149 -0
  153. package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
  154. package/dist/core/sandbox/bash-operations.js +163 -0
  155. package/dist/core/sandbox/bash-operations.js.map +1 -0
  156. package/dist/core/sandbox/env.d.ts +83 -0
  157. package/dist/core/sandbox/env.d.ts.map +1 -0
  158. package/dist/core/sandbox/env.js +123 -0
  159. package/dist/core/sandbox/env.js.map +1 -0
  160. package/dist/core/sandbox/executor.d.ts +104 -0
  161. package/dist/core/sandbox/executor.d.ts.map +1 -0
  162. package/dist/core/sandbox/executor.js +92 -0
  163. package/dist/core/sandbox/executor.js.map +1 -0
  164. package/dist/core/sandbox/index.d.ts +36 -0
  165. package/dist/core/sandbox/index.d.ts.map +1 -0
  166. package/dist/core/sandbox/index.js +36 -0
  167. package/dist/core/sandbox/index.js.map +1 -0
  168. package/dist/core/sandbox/linux.d.ts +121 -0
  169. package/dist/core/sandbox/linux.d.ts.map +1 -0
  170. package/dist/core/sandbox/linux.js +260 -0
  171. package/dist/core/sandbox/linux.js.map +1 -0
  172. package/dist/core/sandbox/policy.d.ts +142 -0
  173. package/dist/core/sandbox/policy.d.ts.map +1 -0
  174. package/dist/core/sandbox/policy.js +297 -0
  175. package/dist/core/sandbox/policy.js.map +1 -0
  176. package/dist/core/sandbox/real-path.d.ts +112 -0
  177. package/dist/core/sandbox/real-path.d.ts.map +1 -0
  178. package/dist/core/sandbox/real-path.js +158 -0
  179. package/dist/core/sandbox/real-path.js.map +1 -0
  180. package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
  181. package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
  182. package/dist/core/sandbox/seatbelt-profile.js +239 -0
  183. package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
  184. package/dist/core/sandbox/seatbelt.d.ts +95 -0
  185. package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
  186. package/dist/core/sandbox/seatbelt.js +154 -0
  187. package/dist/core/sandbox/seatbelt.js.map +1 -0
  188. package/dist/core/sandbox/self-test.d.ts +109 -0
  189. package/dist/core/sandbox/self-test.d.ts.map +1 -0
  190. package/dist/core/sandbox/self-test.js +369 -0
  191. package/dist/core/sandbox/self-test.js.map +1 -0
  192. package/dist/core/sandbox/spawn.d.ts +33 -0
  193. package/dist/core/sandbox/spawn.d.ts.map +1 -0
  194. package/dist/core/sandbox/spawn.js +87 -0
  195. package/dist/core/sandbox/spawn.js.map +1 -0
  196. package/dist/core/sdk.d.ts.map +1 -1
  197. package/dist/core/sdk.js +3 -1
  198. package/dist/core/sdk.js.map +1 -1
  199. package/dist/core/session-manager.d.ts +60 -1
  200. package/dist/core/session-manager.d.ts.map +1 -1
  201. package/dist/core/session-manager.js +53 -6
  202. package/dist/core/session-manager.js.map +1 -1
  203. package/dist/core/settings-manager.d.ts +21 -0
  204. package/dist/core/settings-manager.d.ts.map +1 -1
  205. package/dist/core/settings-manager.js +36 -16
  206. package/dist/core/settings-manager.js.map +1 -1
  207. package/dist/core/skills.d.ts +3 -1
  208. package/dist/core/skills.d.ts.map +1 -1
  209. package/dist/core/skills.js +19 -6
  210. package/dist/core/skills.js.map +1 -1
  211. package/dist/core/slash-commands.d.ts.map +1 -1
  212. package/dist/core/slash-commands.js +1 -0
  213. package/dist/core/slash-commands.js.map +1 -1
  214. package/dist/core/soak/soak-log.d.ts +298 -0
  215. package/dist/core/soak/soak-log.d.ts.map +1 -0
  216. package/dist/core/soak/soak-log.js +660 -0
  217. package/dist/core/soak/soak-log.js.map +1 -0
  218. package/dist/core/soak/soak-reader.d.ts +60 -0
  219. package/dist/core/soak/soak-reader.d.ts.map +1 -0
  220. package/dist/core/soak/soak-reader.js +106 -0
  221. package/dist/core/soak/soak-reader.js.map +1 -0
  222. package/dist/core/socket-server/discovery.d.ts +78 -1
  223. package/dist/core/socket-server/discovery.d.ts.map +1 -1
  224. package/dist/core/socket-server/discovery.js +356 -37
  225. package/dist/core/socket-server/discovery.js.map +1 -1
  226. package/dist/core/socket-server/index.d.ts +10 -4
  227. package/dist/core/socket-server/index.d.ts.map +1 -1
  228. package/dist/core/socket-server/index.js +6 -3
  229. package/dist/core/socket-server/index.js.map +1 -1
  230. package/dist/core/socket-server/permission-delivery.d.ts +125 -0
  231. package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
  232. package/dist/core/socket-server/permission-delivery.js +152 -0
  233. package/dist/core/socket-server/permission-delivery.js.map +1 -0
  234. package/dist/core/socket-server/permission-registry.d.ts +301 -0
  235. package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
  236. package/dist/core/socket-server/permission-registry.js +410 -0
  237. package/dist/core/socket-server/permission-registry.js.map +1 -0
  238. package/dist/core/socket-server/permission-relay.d.ts +81 -0
  239. package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
  240. package/dist/core/socket-server/permission-relay.js +528 -0
  241. package/dist/core/socket-server/permission-relay.js.map +1 -0
  242. package/dist/core/socket-server/safe-text.d.ts +83 -0
  243. package/dist/core/socket-server/safe-text.d.ts.map +1 -0
  244. package/dist/core/socket-server/safe-text.js +277 -0
  245. package/dist/core/socket-server/safe-text.js.map +1 -0
  246. package/dist/core/socket-server/session-integration.d.ts +65 -2
  247. package/dist/core/socket-server/session-integration.d.ts.map +1 -1
  248. package/dist/core/socket-server/session-integration.js +434 -32
  249. package/dist/core/socket-server/session-integration.js.map +1 -1
  250. package/dist/core/socket-server/socket-client.d.ts +21 -2
  251. package/dist/core/socket-server/socket-client.d.ts.map +1 -1
  252. package/dist/core/socket-server/socket-client.js +52 -1
  253. package/dist/core/socket-server/socket-client.js.map +1 -1
  254. package/dist/core/socket-server/socket-server.d.ts +152 -1
  255. package/dist/core/socket-server/socket-server.d.ts.map +1 -1
  256. package/dist/core/socket-server/socket-server.js +775 -26
  257. package/dist/core/socket-server/socket-server.js.map +1 -1
  258. package/dist/core/socket-server/types.d.ts +106 -2
  259. package/dist/core/socket-server/types.d.ts.map +1 -1
  260. package/dist/core/socket-server/types.js +13 -1
  261. package/dist/core/socket-server/types.js.map +1 -1
  262. package/dist/core/system-prompt.d.ts.map +1 -1
  263. package/dist/core/system-prompt.js +8 -9
  264. package/dist/core/system-prompt.js.map +1 -1
  265. package/dist/core/tools/bash.d.ts +1 -1
  266. package/dist/core/tools/bash.d.ts.map +1 -1
  267. package/dist/core/tools/bash.js +5 -2
  268. package/dist/core/tools/bash.js.map +1 -1
  269. package/dist/core/tools/edit.d.ts.map +1 -1
  270. package/dist/core/tools/edit.js +17 -2
  271. package/dist/core/tools/edit.js.map +1 -1
  272. package/dist/core/tools/find.d.ts +3 -0
  273. package/dist/core/tools/find.d.ts.map +1 -1
  274. package/dist/core/tools/find.js +11 -18
  275. package/dist/core/tools/find.js.map +1 -1
  276. package/dist/core/trust-manager.d.ts +6 -4
  277. package/dist/core/trust-manager.d.ts.map +1 -1
  278. package/dist/core/trust-manager.js +55 -21
  279. package/dist/core/trust-manager.js.map +1 -1
  280. package/dist/extensions/index.d.ts.map +1 -1
  281. package/dist/extensions/index.js +5 -1
  282. package/dist/extensions/index.js.map +1 -1
  283. package/dist/extensions/llama/provider.d.ts.map +1 -1
  284. package/dist/extensions/llama/provider.js +5 -1
  285. package/dist/extensions/llama/provider.js.map +1 -1
  286. package/dist/extensions/stub-provider/index.d.ts +9 -0
  287. package/dist/extensions/stub-provider/index.d.ts.map +1 -0
  288. package/dist/extensions/stub-provider/index.js +13 -0
  289. package/dist/extensions/stub-provider/index.js.map +1 -0
  290. package/dist/extensions/stub-provider/provider.d.ts +77 -0
  291. package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
  292. package/dist/extensions/stub-provider/provider.js +193 -0
  293. package/dist/extensions/stub-provider/provider.js.map +1 -0
  294. package/dist/hooks/gsd/draht-quality-gate.js +3 -3
  295. package/dist/index.d.ts +1 -1
  296. package/dist/index.d.ts.map +1 -1
  297. package/dist/index.js.map +1 -1
  298. package/dist/main.d.ts.map +1 -1
  299. package/dist/main.js +242 -45
  300. package/dist/main.js.map +1 -1
  301. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  302. package/dist/modes/interactive/components/config-selector.js +3 -2
  303. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  304. package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
  305. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  306. package/dist/modes/interactive/components/extension-selector.js +202 -5
  307. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  308. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  309. package/dist/modes/interactive/components/session-selector.js +10 -2
  310. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  311. package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
  312. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  313. package/dist/modes/interactive/components/settings-selector.js +10 -0
  314. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  315. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  316. package/dist/modes/interactive/components/tool-execution.js +10 -1
  317. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  318. package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
  319. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  320. package/dist/modes/interactive/components/tree-selector.js +21 -5
  321. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  322. package/dist/modes/interactive/interactive-mode.d.ts +97 -3
  323. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  324. package/dist/modes/interactive/interactive-mode.js +394 -24
  325. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  326. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  327. package/dist/modes/rpc/rpc-mode.js +165 -7
  328. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  329. package/dist/modes/rpc/rpc-types.d.ts +68 -1
  330. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  331. package/dist/modes/rpc/rpc-types.js.map +1 -1
  332. package/dist/prompts/commands/atomic-commit.md +1 -12
  333. package/dist/prompts/commands/brainstorm.md +12 -15
  334. package/dist/prompts/commands/create-verification-skill.md +108 -0
  335. package/dist/prompts/commands/discuss-phase.md +3 -14
  336. package/dist/prompts/commands/execute-phase.md +3 -11
  337. package/dist/prompts/commands/fix.md +41 -18
  338. package/dist/prompts/commands/grill.md +66 -0
  339. package/dist/prompts/commands/init-project.md +5 -15
  340. package/dist/prompts/commands/map-codebase.md +1 -13
  341. package/dist/prompts/commands/new-project.md +5 -15
  342. package/dist/prompts/commands/next-milestone.md +1 -13
  343. package/dist/prompts/commands/orchestrate.md +1 -1
  344. package/dist/prompts/commands/pause-work.md +1 -13
  345. package/dist/prompts/commands/plan-phase.md +2 -11
  346. package/dist/prompts/commands/progress.md +0 -13
  347. package/dist/prompts/commands/quick.md +3 -11
  348. package/dist/prompts/commands/resolve-conflicts.md +71 -0
  349. package/dist/prompts/commands/resume-work.md +0 -13
  350. package/dist/prompts/commands/review.md +4 -13
  351. package/dist/prompts/commands/triage.md +159 -0
  352. package/dist/prompts/commands/verify-work.md +4 -14
  353. package/dist/prompts/commands/why.md +135 -0
  354. package/dist/skills/atomic-reasoning/SKILL.md +115 -0
  355. package/dist/skills/blast-radius/SKILL.md +55 -0
  356. package/dist/skills/epistemics/SKILL.md +99 -0
  357. package/dist/skills/hexagon-animation/SKILL.md +49 -0
  358. package/dist/skills/hexagon-animation/generate.mjs +81 -0
  359. package/dist/skills/hexagon-animation/template.html +361 -0
  360. package/dist/skills/typescript-discipline/SKILL.md +50 -0
  361. package/dist/skills/typescript-discipline/references/patterns.md +294 -0
  362. package/dist/skills/unslop/SKILL.md +101 -0
  363. package/dist/utils/canonical-path.d.ts +28 -0
  364. package/dist/utils/canonical-path.d.ts.map +1 -0
  365. package/dist/utils/canonical-path.js +90 -0
  366. package/dist/utils/canonical-path.js.map +1 -0
  367. package/dist/utils/child-process.d.ts +12 -1
  368. package/dist/utils/child-process.d.ts.map +1 -1
  369. package/dist/utils/child-process.js +25 -8
  370. package/dist/utils/child-process.js.map +1 -1
  371. package/dist/utils/clipboard.d.ts +1 -1
  372. package/dist/utils/clipboard.d.ts.map +1 -1
  373. package/dist/utils/clipboard.js +22 -2
  374. package/dist/utils/clipboard.js.map +1 -1
  375. package/dist/utils/exif-orientation.d.ts.map +1 -1
  376. package/dist/utils/exif-orientation.js +2 -3
  377. package/dist/utils/exif-orientation.js.map +1 -1
  378. package/dist/utils/paths.d.ts +2 -7
  379. package/dist/utils/paths.d.ts.map +1 -1
  380. package/dist/utils/paths.js +13 -15
  381. package/dist/utils/paths.js.map +1 -1
  382. package/dist/utils/shell.d.ts.map +1 -1
  383. package/dist/utils/shell.js +6 -4
  384. package/dist/utils/shell.js.map +1 -1
  385. package/dist/utils/tools-manager.d.ts.map +1 -1
  386. package/dist/utils/tools-manager.js +3 -5
  387. package/dist/utils/tools-manager.js.map +1 -1
  388. package/docs/attachable-sessions.md +79 -0
  389. package/docs/compaction.md +21 -21
  390. package/docs/containerization.md +23 -23
  391. package/docs/custom-provider.md +16 -16
  392. package/docs/development.md +9 -9
  393. package/docs/docs.json +6 -2
  394. package/docs/duet.md +42 -0
  395. package/docs/extensions.md +58 -58
  396. package/docs/index.md +10 -10
  397. package/docs/json.md +7 -7
  398. package/docs/keybindings.md +6 -5
  399. package/docs/llama-cpp.md +6 -6
  400. package/docs/models.md +6 -6
  401. package/docs/packages.md +43 -43
  402. package/docs/prompt-templates.md +4 -4
  403. package/docs/providers.md +12 -12
  404. package/docs/quickstart.md +32 -32
  405. package/docs/rpc.md +83 -12
  406. package/docs/sdk.md +15 -15
  407. package/docs/security.md +18 -18
  408. package/docs/session-format.md +35 -13
  409. package/docs/sessions.md +17 -14
  410. package/docs/settings.md +25 -18
  411. package/docs/shell-aliases.md +2 -2
  412. package/docs/skills.md +12 -11
  413. package/docs/terminal-setup.md +12 -12
  414. package/docs/termux.md +6 -6
  415. package/docs/themes.md +11 -11
  416. package/docs/tmux.md +4 -4
  417. package/docs/tui.md +5 -5
  418. package/docs/usage.md +50 -50
  419. package/docs/windows.md +2 -2
  420. package/examples/extensions/overlay-qa-tests.ts +3 -3
  421. package/hooks/gsd/draht-quality-gate.js +3 -3
  422. package/package.json +11 -10
  423. package/prompts/commands/atomic-commit.md +1 -12
  424. package/prompts/commands/brainstorm.md +12 -15
  425. package/prompts/commands/create-verification-skill.md +108 -0
  426. package/prompts/commands/discuss-phase.md +3 -14
  427. package/prompts/commands/execute-phase.md +3 -11
  428. package/prompts/commands/fix.md +41 -18
  429. package/prompts/commands/grill.md +66 -0
  430. package/prompts/commands/init-project.md +5 -15
  431. package/prompts/commands/map-codebase.md +1 -13
  432. package/prompts/commands/new-project.md +5 -15
  433. package/prompts/commands/next-milestone.md +1 -13
  434. package/prompts/commands/orchestrate.md +1 -1
  435. package/prompts/commands/pause-work.md +1 -13
  436. package/prompts/commands/plan-phase.md +2 -11
  437. package/prompts/commands/progress.md +0 -13
  438. package/prompts/commands/quick.md +3 -11
  439. package/prompts/commands/resolve-conflicts.md +71 -0
  440. package/prompts/commands/resume-work.md +0 -13
  441. package/prompts/commands/review.md +4 -13
  442. package/prompts/commands/triage.md +159 -0
  443. package/prompts/commands/verify-work.md +4 -14
  444. package/prompts/commands/why.md +135 -0
  445. package/skills/atomic-reasoning/SKILL.md +115 -0
  446. package/skills/blast-radius/SKILL.md +55 -0
  447. package/skills/epistemics/SKILL.md +99 -0
  448. package/skills/hexagon-animation/SKILL.md +49 -0
  449. package/skills/hexagon-animation/generate.mjs +81 -0
  450. package/skills/hexagon-animation/template.html +361 -0
  451. package/skills/typescript-discipline/SKILL.md +50 -0
  452. package/skills/typescript-discipline/references/patterns.md +294 -0
  453. package/skills/unslop/SKILL.md +101 -0
  454. package/dist/prompts/agents/build.md +0 -86
  455. package/dist/prompts/agents/plan.md +0 -79
  456. package/dist/prompts/agents/verify.md +0 -69
  457. package/prompts/agents/build.md +0 -86
  458. package/prompts/agents/plan.md +0 -79
  459. package/prompts/agents/verify.md +0 -69
@@ -30,6 +30,7 @@ import { createToolHtmlRenderer } from "./export-html/tool-renderer.js";
30
30
  import { ExtensionRunner, wrapRegisteredTools, } from "./extensions/index.js";
31
31
  import { emitSessionShutdownEvent } from "./extensions/runner.js";
32
32
  import { ModelRegistry } from "./model-registry.js";
33
+ import { createRelayUIContext, noOpRelayBaseUIContext, } from "./permission-relay/index.js";
33
34
  import { expandPromptTemplate } from "./prompt-templates.js";
34
35
  import { CURRENT_SESSION_VERSION, getLatestCompactionEntry } from "./session-manager.js";
35
36
  import { createSyntheticSourceInfo } from "./source-info.js";
@@ -73,6 +74,25 @@ function estimateMessagesTokens(messages) {
73
74
  // ============================================================================
74
75
  /** Standard thinking levels */
75
76
  const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high"];
77
+ /**
78
+ * Which SURFACE a dialog answered locally belongs to, per binding mode.
79
+ *
80
+ * Total over {@link ExtensionMode} on purpose — a `Record`, not a lookup with a fallback — because
81
+ * the fallback is what the defect was: the relay decorator hardcoded `tui`, so an answer typed into
82
+ * the RPC surface, and a SIGTERM that cancelled a pending dialog, were both recorded in the
83
+ * session's durable log as a human sitting at a terminal that does not exist.
84
+ *
85
+ * `json` and `print` bind no UI context at all (see `runPrintMode`), so the decorator wraps the
86
+ * barrel's no-op with `baseIsLive: false` and nothing is ever answered locally in them. `system` is
87
+ * therefore both unreachable and the truthful value: if such a mode somehow ended an ask, no person
88
+ * acted. It is deliberately not `tui`.
89
+ */
90
+ const LOCAL_SURFACE_BY_MODE = Object.freeze({
91
+ tui: "tui",
92
+ rpc: "rpc",
93
+ json: "system",
94
+ print: "system",
95
+ });
76
96
  // ============================================================================
77
97
  // AgentSession Class
78
98
  // ============================================================================
@@ -86,6 +106,8 @@ export class AgentSession {
86
106
  this._followUpMessages = [];
87
107
  /** Messages queued to be included with the next user prompt as context ("asides"). */
88
108
  this._pendingNextTurnMessages = [];
109
+ /** Context-only custom messages queued during a run, flushed once the current turn's tool results are in. */
110
+ this._pendingCustomMessages = [];
89
111
  // Compaction state
90
112
  this._compactionAbortController = undefined;
91
113
  this._autoCompactionAbortController = undefined;
@@ -171,6 +193,14 @@ export class AgentSession {
171
193
  }
172
194
  }
173
195
  }
196
+ // A turn ends after its assistant message and every tool result has been appended,
197
+ // so this is the first point in the run where a context-only custom message can be
198
+ // inserted without landing between a tool call and its result. Flushing after the
199
+ // extension and listener dispatch above also picks up messages that turn_end
200
+ // handlers queued.
201
+ if (event.type === "turn_end") {
202
+ this._flushPendingCustomMessages();
203
+ }
174
204
  };
175
205
  this.agent = config.agent;
176
206
  this.sessionManager = config.sessionManager;
@@ -212,7 +242,9 @@ export class AgentSession {
212
242
  throw error;
213
243
  }
214
244
  if (result && (result.auth.apiKey || result.auth.headers)) {
245
+ const requestModel = result.auth.baseUrl ? { ...model, baseUrl: result.auth.baseUrl } : model;
215
246
  return {
247
+ model: requestModel,
216
248
  apiKey: result.auth.apiKey,
217
249
  headers: withoutDeletedHeaders(result.auth.headers),
218
250
  env: result.env,
@@ -232,12 +264,18 @@ export class AgentSession {
232
264
  }
233
265
  try {
234
266
  const result = await this._modelRuntime.getAuth(model);
235
- return result
236
- ? { apiKey: result.auth.apiKey, headers: withoutDeletedHeaders(result.auth.headers), env: result.env }
237
- : {};
267
+ if (!result)
268
+ return { model };
269
+ const requestModel = result.auth.baseUrl ? { ...model, baseUrl: result.auth.baseUrl } : model;
270
+ return {
271
+ model: requestModel,
272
+ apiKey: result.auth.apiKey,
273
+ headers: withoutDeletedHeaders(result.auth.headers),
274
+ env: result.env,
275
+ };
238
276
  }
239
277
  catch {
240
- return {};
278
+ return { model };
241
279
  }
242
280
  }
243
281
  /**
@@ -502,26 +540,13 @@ export class AgentSession {
502
540
  }
503
541
  };
504
542
  }
505
- /**
506
- * Temporarily disconnect from agent events.
507
- * User listeners are preserved and will receive events again after resubscribe().
508
- * Used internally during operations that need to pause event processing.
509
- */
543
+ /** Disconnect from agent events during disposal. */
510
544
  _disconnectFromAgent() {
511
545
  if (this._unsubscribeAgent) {
512
546
  this._unsubscribeAgent();
513
547
  this._unsubscribeAgent = undefined;
514
548
  }
515
549
  }
516
- /**
517
- * Reconnect to agent events after _disconnectFromAgent().
518
- * Preserves all existing listeners.
519
- */
520
- _reconnectToAgent() {
521
- if (this._unsubscribeAgent)
522
- return; // Already connected
523
- this._unsubscribeAgent = this.agent.subscribe(this._handleAgentEvent);
524
- }
525
550
  /**
526
551
  * Remove all listeners and disconnect from agent.
527
552
  * Call this when completely done with the session.
@@ -725,6 +750,7 @@ export class AgentSession {
725
750
  finally {
726
751
  this._systemPromptOverride = undefined;
727
752
  this._flushPendingBashMessages();
753
+ this._flushPendingCustomMessages();
728
754
  await this._emitAgentSettled();
729
755
  }
730
756
  }
@@ -777,6 +803,9 @@ export class AgentSession {
777
803
  return;
778
804
  }
779
805
  }
806
+ if (this._compactionAbortController !== undefined) {
807
+ throw new Error("Cannot submit a prompt while compaction is in progress. Wait for compaction to finish and retry.");
808
+ }
780
809
  // Emit input event for extension interception (before skill/template expansion)
781
810
  let currentText = text;
782
811
  let currentImages = options?.images;
@@ -811,8 +840,9 @@ export class AgentSession {
811
840
  preflightResult?.(true);
812
841
  return;
813
842
  }
814
- // Flush any pending bash messages before the new prompt
843
+ // Flush any pending bash and custom messages before the new prompt
815
844
  this._flushPendingBashMessages();
845
+ this._flushPendingCustomMessages();
816
846
  // Validate model
817
847
  if (!this.model) {
818
848
  throw new Error(formatNoModelSelectedMessage());
@@ -1026,8 +1056,9 @@ export class AgentSession {
1026
1056
  /**
1027
1057
  * Send a custom message to the session. Creates a CustomMessageEntry.
1028
1058
  *
1029
- * Handles three cases:
1059
+ * Handles four cases:
1030
1060
  * - Streaming: queues message, processed when loop pulls from queue
1061
+ * - Streaming + triggerTurn false: appended to state/session once the current turn ends
1031
1062
  * - Not streaming + triggerTurn: appends to state/session, starts new turn
1032
1063
  * - Not streaming + no trigger: appends to state/session, no turn
1033
1064
  *
@@ -1048,7 +1079,7 @@ export class AgentSession {
1048
1079
  if (options?.deliverAs === "nextTurn") {
1049
1080
  this._pendingNextTurnMessages.push(appMessage);
1050
1081
  }
1051
- else if (this.isStreaming) {
1082
+ else if (this.isStreaming && options?.triggerTurn !== false) {
1052
1083
  if (options?.deliverAs === "followUp") {
1053
1084
  this.agent.followUp(appMessage);
1054
1085
  }
@@ -1059,11 +1090,34 @@ export class AgentSession {
1059
1090
  else if (options?.triggerTurn) {
1060
1091
  await this._runAgentPrompt(appMessage);
1061
1092
  }
1093
+ else if (this.isStreaming) {
1094
+ // Appending now would put the message between an assistant tool call and its
1095
+ // result, which providers that validate message order reject on replay. Defer
1096
+ // to the end of the turn. Nothing is emitted yet: message events must not
1097
+ // describe messages the session tree does not contain.
1098
+ this._pendingCustomMessages.push(appMessage);
1099
+ }
1062
1100
  else {
1063
- this.agent.state.messages.push(appMessage);
1064
- this.sessionManager.appendCustomMessageEntry(message.customType, message.content, message.display, message.details);
1065
- this._emit({ type: "message_start", message: appMessage });
1066
- this._emit({ type: "message_end", message: appMessage });
1101
+ this._appendCustomMessage(appMessage);
1102
+ }
1103
+ }
1104
+ _appendCustomMessage(appMessage) {
1105
+ this.agent.state.messages.push(appMessage);
1106
+ this.sessionManager.appendCustomMessageEntry(appMessage.customType, appMessage.content, appMessage.display, appMessage.details);
1107
+ this._emit({ type: "message_start", message: appMessage });
1108
+ this._emit({ type: "message_end", message: appMessage });
1109
+ }
1110
+ /**
1111
+ * Append custom messages queued while the agent was running.
1112
+ * Called once the current turn's tool results are in agent state and session history.
1113
+ */
1114
+ _flushPendingCustomMessages() {
1115
+ if (this._pendingCustomMessages.length === 0)
1116
+ return;
1117
+ const pending = this._pendingCustomMessages;
1118
+ this._pendingCustomMessages = [];
1119
+ for (const appMessage of pending) {
1120
+ this._appendCustomMessage(appMessage);
1067
1121
  }
1068
1122
  }
1069
1123
  /**
@@ -1161,10 +1215,10 @@ export class AgentSession {
1161
1215
  }
1162
1216
  /**
1163
1217
  * Set model directly.
1164
- * Validates that auth is configured, saves to session and settings.
1218
+ * Validates that auth is configured and saves to the session. Updates settings unless `persistDefault` is false.
1165
1219
  * @throws Error if no auth is configured for the model
1166
1220
  */
1167
- async setModel(model) {
1221
+ async setModel(model, options = {}) {
1168
1222
  if (!(await this._modelRuntime.checkAuth(model.provider))) {
1169
1223
  throw new Error(`No API key for ${model.provider}/${model.id}`);
1170
1224
  }
@@ -1172,9 +1226,11 @@ export class AgentSession {
1172
1226
  const thinkingLevel = this._getThinkingLevelForModelSwitch();
1173
1227
  this.agent.state.model = model;
1174
1228
  this.sessionManager.appendModelChange(model.provider, model.id, model.contextWindow);
1175
- this.settingsManager.setDefaultModelAndProvider(model.provider, model.id);
1229
+ if (options.persistDefault !== false) {
1230
+ this.settingsManager.setDefaultModelAndProvider(model.provider, model.id);
1231
+ }
1176
1232
  // Re-clamp thinking level for new model's capabilities
1177
- this.setThinkingLevel(thinkingLevel);
1233
+ this.setThinkingLevel(thinkingLevel, options);
1178
1234
  await this._emitModelSelect(model, previousModel, "set");
1179
1235
  }
1180
1236
  /**
@@ -1287,9 +1343,9 @@ export class AgentSession {
1287
1343
  /**
1288
1344
  * Set thinking level.
1289
1345
  * Clamps to model capabilities based on available thinking levels.
1290
- * Saves to session and settings only if the level actually changes.
1346
+ * Saves changes to the session and updates settings unless `persistDefault` is false.
1291
1347
  */
1292
- setThinkingLevel(level) {
1348
+ setThinkingLevel(level, options = {}) {
1293
1349
  const availableLevels = this.getAvailableThinkingLevels();
1294
1350
  const effectiveLevel = availableLevels.includes(level) ? level : this._clampThinkingLevel(level, availableLevels);
1295
1351
  // Only persist if actually changing
@@ -1298,7 +1354,7 @@ export class AgentSession {
1298
1354
  this.agent.state.thinkingLevel = effectiveLevel;
1299
1355
  if (isChanging) {
1300
1356
  this.sessionManager.appendThinkingLevelChange(effectiveLevel);
1301
- if (this.supportsThinking() || effectiveLevel !== "off") {
1357
+ if (options.persistDefault !== false && (this.supportsThinking() || effectiveLevel !== "off")) {
1302
1358
  this.settingsManager.setDefaultThinkingLevel(effectiveLevel);
1303
1359
  }
1304
1360
  this._emit({ type: "thinking_level_changed", level: effectiveLevel });
@@ -1382,7 +1438,6 @@ export class AgentSession {
1382
1438
  * @param customInstructions Optional instructions for the compaction summary
1383
1439
  */
1384
1440
  async compact(customInstructions) {
1385
- this._disconnectFromAgent();
1386
1441
  await this.abort();
1387
1442
  this._compactionAbortController = new AbortController();
1388
1443
  this._emit({ type: "compaction_start", reason: "manual" });
@@ -1390,7 +1445,7 @@ export class AgentSession {
1390
1445
  if (!this.model) {
1391
1446
  throw new Error(formatNoModelSelectedMessage());
1392
1447
  }
1393
- const { apiKey, headers, env } = await this._getSummarizationRequestAuth(this.model);
1448
+ const { model: requestModel, apiKey, headers, env } = await this._getSummarizationRequestAuth(this.model);
1394
1449
  const pathEntries = this.sessionManager.getBranch();
1395
1450
  const settings = this.settingsManager.getCompactionSettings();
1396
1451
  const preparation = prepareCompaction(pathEntries, settings);
@@ -1437,7 +1492,7 @@ export class AgentSession {
1437
1492
  }
1438
1493
  else {
1439
1494
  // Generate compaction result
1440
- const result = await compact(preparation, this.model, apiKey, headers, customInstructions, this._compactionAbortController.signal, this.thinkingLevel, this.agent.streamFunction, env, this.settingsManager.getRetrySettings(), this._summarizationRetryCallbacks({ source: "compaction", reason: "manual" }));
1495
+ const result = await compact(preparation, requestModel, apiKey, headers, customInstructions, this._compactionAbortController.signal, this.thinkingLevel, this.agent.streamFunction, env, this.settingsManager.getRetrySettings(), this._summarizationRetryCallbacks({ source: "compaction", reason: "manual" }));
1441
1496
  summary = result.summary;
1442
1497
  firstKeptEntryId = result.firstKeptEntryId;
1443
1498
  tokensBefore = result.tokensBefore;
@@ -1471,6 +1526,8 @@ export class AgentSession {
1471
1526
  usage,
1472
1527
  details,
1473
1528
  };
1529
+ // compaction_end listeners may submit queued prompts, so expose idle state before notifying them.
1530
+ this._compactionAbortController = undefined;
1474
1531
  this._emit({
1475
1532
  type: "compaction_end",
1476
1533
  reason: "manual",
@@ -1483,6 +1540,7 @@ export class AgentSession {
1483
1540
  catch (error) {
1484
1541
  const message = error instanceof Error ? error.message : String(error);
1485
1542
  const aborted = message === "Compaction cancelled" || (error instanceof Error && error.name === "AbortError");
1543
+ this._compactionAbortController = undefined;
1486
1544
  this._emit({
1487
1545
  type: "compaction_end",
1488
1546
  reason: "manual",
@@ -1495,7 +1553,6 @@ export class AgentSession {
1495
1553
  }
1496
1554
  finally {
1497
1555
  this._compactionAbortController = undefined;
1498
- this._reconnectToAgent();
1499
1556
  }
1500
1557
  }
1501
1558
  /**
@@ -1581,16 +1638,18 @@ export class AgentSession {
1581
1638
  if (assistantMessage.stopReason === "error" || directContextTokens === 0) {
1582
1639
  const messages = this.agent.state.messages;
1583
1640
  const estimate = estimateContextTokens(messages);
1584
- if (estimate.lastUsageIndex === null)
1585
- return false; // No usage data at all
1586
- // Verify the usage source is post-compaction. Kept pre-compaction messages
1587
- // have stale usage reflecting the old (larger) context and would falsely
1588
- // trigger compaction right after one just finished.
1589
- const usageMsg = messages[estimate.lastUsageIndex];
1590
- if (compactionEntry &&
1591
- usageMsg.role === "assistant" &&
1592
- usageMsg.timestamp <= new Date(compactionEntry.timestamp).getTime()) {
1593
- return false;
1641
+ // Without provider usage, estimate.tokens is the pure message-size estimate.
1642
+ // Only usage-backed estimates need the stale pre-compaction check.
1643
+ if (estimate.lastUsageIndex !== null) {
1644
+ // Verify the usage source is post-compaction. Kept pre-compaction messages
1645
+ // have stale usage reflecting the old (larger) context and would falsely
1646
+ // trigger compaction right after one just finished.
1647
+ const usageMsg = messages[estimate.lastUsageIndex];
1648
+ if (compactionEntry &&
1649
+ usageMsg.role === "assistant" &&
1650
+ usageMsg.timestamp <= new Date(compactionEntry.timestamp).getTime()) {
1651
+ return false;
1652
+ }
1594
1653
  }
1595
1654
  contextTokens = estimate.tokens;
1596
1655
  }
@@ -1612,15 +1671,7 @@ export class AgentSession {
1612
1671
  if (!this.model) {
1613
1672
  return false;
1614
1673
  }
1615
- let apiKey;
1616
- let headers;
1617
- let env;
1618
- if (this.agent.streamFunction === streamSimple) {
1619
- ({ apiKey, headers, env } = await this._getRequiredRequestAuth(this.model));
1620
- }
1621
- else {
1622
- ({ apiKey, headers, env } = await this._getSummarizationRequestAuth(this.model));
1623
- }
1674
+ const { model: requestModel, apiKey, headers, env } = await this._getSummarizationRequestAuth(this.model);
1624
1675
  const pathEntries = this.sessionManager.getBranch();
1625
1676
  const preparation = prepareCompaction(pathEntries, settings);
1626
1677
  if (!preparation) {
@@ -1671,7 +1722,7 @@ export class AgentSession {
1671
1722
  }
1672
1723
  else {
1673
1724
  // Generate compaction result
1674
- const compactResult = await compact(preparation, this.model, apiKey, headers, undefined, this._autoCompactionAbortController.signal, this.thinkingLevel, this.agent.streamFunction, env, this.settingsManager.getRetrySettings(), this._summarizationRetryCallbacks({ source: "compaction", reason }));
1725
+ const compactResult = await compact(preparation, requestModel, apiKey, headers, undefined, this._autoCompactionAbortController.signal, this.thinkingLevel, this.agent.streamFunction, env, this.settingsManager.getRetrySettings(), this._summarizationRetryCallbacks({ source: "compaction", reason }));
1675
1726
  summary = compactResult.summary;
1676
1727
  firstKeptEntryId = compactResult.firstKeptEntryId;
1677
1728
  tokensBefore = compactResult.tokensBefore;
@@ -1755,6 +1806,17 @@ export class AgentSession {
1755
1806
  get autoCompactionEnabled() {
1756
1807
  return this.settingsManager.getCompactionEnabled();
1757
1808
  }
1809
+ /**
1810
+ * Install (or remove) the permission relay this session's dialogs are mirrored onto.
1811
+ *
1812
+ * Re-applies the extension bindings immediately: the constructor's own apply has already run
1813
+ * by the time any caller can hand a relay over, so without the re-apply the runner would keep
1814
+ * an undecorated context until the next reload.
1815
+ */
1816
+ setPermissionRelay(relay) {
1817
+ this._permissionRelay = relay;
1818
+ this._applyExtensionBindings(this._extensionRunner);
1819
+ }
1758
1820
  async bindExtensions(bindings) {
1759
1821
  if (bindings.uiContext !== undefined) {
1760
1822
  this._extensionUIContext = bindings.uiContext;
@@ -1818,8 +1880,29 @@ export class AgentSession {
1818
1880
  const name = base.replace(/\.(ts|js)$/, "");
1819
1881
  return `extension:${name}`;
1820
1882
  }
1883
+ /**
1884
+ * Wrap the mode's UI context so an attached remote surface can answer the same dialogs.
1885
+ *
1886
+ * Returns the base untouched when no relay is installed. When one is, the decorator is built
1887
+ * here and NOWHERE else: this is the only mode-agnostic seam every session passes through
1888
+ * (bindExtensions for interactive/rpc/print, _buildRuntime for the constructor and reload),
1889
+ * so a wrap installed anywhere else is silently overwritten when a mode binds its own context.
1890
+ */
1891
+ _wrapUIContext(base) {
1892
+ if (this._permissionRelay === undefined) {
1893
+ return base;
1894
+ }
1895
+ return createRelayUIContext(base ?? noOpRelayBaseUIContext, this._permissionRelay, base !== undefined,
1896
+ // The TRUTH about which surface a locally answered dialog came from, and the reason this
1897
+ // seam is the only place the decorator may be built: `_extensionMode` is set by
1898
+ // `bindExtensions` immediately before `_applyExtensionBindings` calls this, so the mode
1899
+ // and the context it wraps are always the same binding. A literal `tui` inside the
1900
+ // decorator recorded an answer typed into the RPC surface as a human at a terminal that
1901
+ // does not exist.
1902
+ LOCAL_SURFACE_BY_MODE[this._extensionMode]);
1903
+ }
1821
1904
  _applyExtensionBindings(runner) {
1822
- runner.setUIContext(this._extensionUIContext, this._extensionMode);
1905
+ runner.setUIContext(this._wrapUIContext(this._extensionUIContext), this._extensionMode);
1823
1906
  runner.bindCommandContext(this._extensionCommandContextActions);
1824
1907
  this._extensionErrorUnsubscriber?.();
1825
1908
  this._extensionErrorUnsubscriber = this._extensionErrorListener
@@ -1899,14 +1982,14 @@ export class AgentSession {
1899
1982
  setActiveTools: (toolNames) => this.setActiveToolsByName(toolNames),
1900
1983
  refreshTools: () => this._refreshToolRegistry(),
1901
1984
  getCommands,
1902
- setModel: async (model) => {
1985
+ setModel: async (model, options) => {
1903
1986
  if (!this._modelRuntime.hasConfiguredAuth(model.provider))
1904
1987
  return false;
1905
- await this.setModel(model);
1988
+ await this.setModel(model, options);
1906
1989
  return true;
1907
1990
  },
1908
1991
  getThinkingLevel: () => this.thinkingLevel,
1909
- setThinkingLevel: (level) => this.setThinkingLevel(level),
1992
+ setThinkingLevel: (level, options) => this.setThinkingLevel(level, options),
1910
1993
  }, {
1911
1994
  getModel: () => this.model,
1912
1995
  getScopedModels: () => this._scopedModels,
@@ -2067,8 +2150,10 @@ export class AgentSession {
2067
2150
  });
2068
2151
  }
2069
2152
  async reload(options) {
2070
- const previousFlagValues = this._extensionRunner.getFlagValues();
2071
- await emitSessionShutdownEvent(this._extensionRunner, { type: "session_shutdown", reason: "reload" });
2153
+ const oldRunner = this._extensionRunner;
2154
+ const previousFlagValues = oldRunner.getFlagValues();
2155
+ await emitSessionShutdownEvent(oldRunner, { type: "session_shutdown", reason: "reload" });
2156
+ oldRunner.invalidate();
2072
2157
  await this.settingsManager.reload();
2073
2158
  this.syncQueueModesFromSettings();
2074
2159
  resetApiProviders();
@@ -2387,10 +2472,10 @@ export class AgentSession {
2387
2472
  let summaryUsage;
2388
2473
  if (options.summarize && entriesToSummarize.length > 0 && !extensionSummary) {
2389
2474
  const model = this.model;
2390
- const { apiKey, headers, env } = await this._getSummarizationRequestAuth(model);
2475
+ const { model: requestModel, apiKey, headers, env } = await this._getSummarizationRequestAuth(model);
2391
2476
  const branchSummarySettings = this.settingsManager.getBranchSummarySettings();
2392
2477
  const result = await generateBranchSummary(entriesToSummarize, {
2393
- model,
2478
+ model: requestModel,
2394
2479
  apiKey,
2395
2480
  headers,
2396
2481
  env,