@draht/coding-agent 2026.7.30 → 2026.10.4-2

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 (1229) hide show
  1. package/CHANGELOG.md +606 -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/bun/cli.d.ts +1 -1
  19. package/dist/bun/cli.d.ts.map +1 -1
  20. package/dist/bun/cli.js +6 -3
  21. package/dist/bun/cli.js.map +1 -1
  22. package/dist/bun/sandbox-env-setup.d.ts +2 -0
  23. package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
  24. package/dist/bun/sandbox-env-setup.js +4 -0
  25. package/dist/bun/sandbox-env-setup.js.map +1 -0
  26. package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +6 -0
  27. package/dist/bundle/chunks/anthropic.js +75 -0
  28. package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +2 -0
  29. package/dist/bundle/chunks/bedrock-converse-stream.js +79 -0
  30. package/dist/bundle/chunks/chunk-2E5VODES.js +2 -0
  31. package/dist/bundle/chunks/chunk-2FBJKY7F.js +2 -0
  32. package/dist/bundle/chunks/chunk-2N4I6WXC.js +2 -0
  33. package/dist/bundle/chunks/chunk-5VZWYVZB.js +82 -0
  34. package/dist/bundle/chunks/chunk-63BK6WK2.js +2 -0
  35. package/dist/bundle/chunks/chunk-6MSE6LZ3.js +6 -0
  36. package/dist/bundle/chunks/chunk-6ZJKIMU7.js +2 -0
  37. package/dist/bundle/chunks/chunk-736QBNUZ.js +12 -0
  38. package/dist/bundle/chunks/chunk-BXSHCX3G.js +11 -0
  39. package/dist/bundle/chunks/chunk-CEJJ5XF2.js +170 -0
  40. package/dist/bundle/chunks/chunk-COF5JT7R.js +4 -0
  41. package/dist/bundle/chunks/chunk-D6TMD5Q2.js +44 -0
  42. package/dist/bundle/chunks/chunk-DPE4ALPU.js +146 -0
  43. package/dist/bundle/chunks/chunk-EBVYI75P.js +2 -0
  44. package/dist/bundle/chunks/chunk-GVXA72ZA.js +2 -0
  45. package/dist/bundle/chunks/chunk-H6FT43VC.js +137 -0
  46. package/dist/bundle/chunks/chunk-HJ72RANT.js +2 -0
  47. package/dist/bundle/chunks/chunk-HTJ3L72O.js +2 -0
  48. package/dist/bundle/chunks/chunk-HZ2UHMBT.js +2 -0
  49. package/dist/bundle/chunks/chunk-I5OKY6RH.js +11 -0
  50. package/dist/bundle/chunks/chunk-IWTUBX6V.js +4 -0
  51. package/dist/bundle/chunks/chunk-KPO5375S.js +2 -0
  52. package/dist/bundle/chunks/chunk-KVH4HR57.js +31 -0
  53. package/dist/bundle/chunks/chunk-LDAOC5RB.js +18 -0
  54. package/dist/bundle/chunks/chunk-ON6XU6AG.js +2 -0
  55. package/dist/bundle/chunks/chunk-QMN7OD6G.js +2 -0
  56. package/dist/bundle/chunks/chunk-RZKPFWMH.js +42 -0
  57. package/dist/bundle/chunks/chunk-SDRCE6OP.js +2 -0
  58. package/dist/bundle/chunks/chunk-SVNWI7EV.js +8 -0
  59. package/dist/bundle/chunks/chunk-TIA2T6EO.js +3 -0
  60. package/dist/bundle/chunks/chunk-VOFPZOUQ.js +1472 -0
  61. package/dist/bundle/chunks/chunk-XBUEMKIY.js +2 -0
  62. package/dist/bundle/chunks/chunk-XOGEYN4Q.js +2 -0
  63. package/dist/bundle/chunks/chunk-ZZD35WKM.js +2 -0
  64. package/dist/bundle/chunks/cli-SR5QBZH4.js +51 -0
  65. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +2 -0
  66. package/dist/bundle/chunks/codemode-worker.js +315 -0
  67. package/dist/bundle/chunks/execute-VCYDHEYA.js +328 -0
  68. package/dist/bundle/chunks/github-copilot.js +2 -0
  69. package/dist/bundle/chunks/google-antigravity.js +75 -0
  70. package/dist/bundle/chunks/google-gemini-cli.js +75 -0
  71. package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +2 -0
  72. package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +2 -0
  73. package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +13 -0
  74. package/dist/bundle/chunks/image-resize-worker.js +2 -0
  75. package/dist/bundle/chunks/jiti-loader-RKXLMQV2.js +2 -0
  76. package/dist/bundle/chunks/kimi-coding.js +2 -0
  77. package/dist/bundle/chunks/lib-XOG5PI3Y.js +9 -0
  78. package/dist/bundle/chunks/llama-cpp-classify-EJ5XMSQL.js +22 -0
  79. package/dist/bundle/chunks/meta.js +2 -0
  80. package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +5 -0
  81. package/dist/bundle/chunks/multipart-parser-AZP5BX2W.js +3 -0
  82. package/dist/bundle/chunks/node-C2JGH2OB.js +2 -0
  83. package/dist/bundle/chunks/node-LQ52KV6B.js +16 -0
  84. package/dist/bundle/chunks/openai-chatgpt.js +75 -0
  85. package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +10 -0
  86. package/dist/bundle/chunks/openai-codex.js +75 -0
  87. package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +7 -0
  88. package/dist/bundle/chunks/openai-responses-6IXV53T3.js +3 -0
  89. package/dist/bundle/chunks/opencode-go.js +2 -0
  90. package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +2 -0
  91. package/dist/bundle/chunks/openrouter.js +75 -0
  92. package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +8 -0
  93. package/dist/bundle/chunks/radius.js +75 -0
  94. package/dist/bundle/chunks/runtime-6YJPGSP7.js +2 -0
  95. package/dist/bundle/chunks/settings-manager-D2EG7WDO.js +2 -0
  96. package/dist/bundle/chunks/src-TIBHS42X.js +4 -0
  97. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +2 -0
  98. package/dist/bundle/chunks/virtual-modules-CBOAFAFT.js +2 -0
  99. package/dist/bundle/chunks/xai.js +75 -0
  100. package/dist/bundle/cli-runtime.js +3 -0
  101. package/dist/bundle/cli.js +5 -0
  102. package/dist/bundle/index.js +2 -0
  103. package/dist/bundle/rpc-entry.js +3 -0
  104. package/dist/cli/args.d.ts +14 -0
  105. package/dist/cli/args.d.ts.map +1 -1
  106. package/dist/cli/args.js +140 -22
  107. package/dist/cli/args.js.map +1 -1
  108. package/dist/cli/attach-mode.d.ts +61 -0
  109. package/dist/cli/attach-mode.d.ts.map +1 -1
  110. package/dist/cli/attach-mode.js +243 -5
  111. package/dist/cli/attach-mode.js.map +1 -1
  112. package/dist/cli/auth-check.d.ts +19 -0
  113. package/dist/cli/auth-check.d.ts.map +1 -0
  114. package/dist/cli/auth-check.js +50 -0
  115. package/dist/cli/auth-check.js.map +1 -0
  116. package/dist/cli/auth-command.d.ts +24 -0
  117. package/dist/cli/auth-command.d.ts.map +1 -0
  118. package/dist/cli/auth-command.js +103 -0
  119. package/dist/cli/auth-command.js.map +1 -0
  120. package/dist/cli/config-selector.d.ts.map +1 -1
  121. package/dist/cli/config-selector.js +3 -2
  122. package/dist/cli/config-selector.js.map +1 -1
  123. package/dist/cli/credential-print.d.ts +6 -4
  124. package/dist/cli/credential-print.d.ts.map +1 -1
  125. package/dist/cli/credential-print.js +47 -34
  126. package/dist/cli/credential-print.js.map +1 -1
  127. package/dist/cli/file-processor.d.ts +1 -1
  128. package/dist/cli/file-processor.d.ts.map +1 -1
  129. package/dist/cli/file-processor.js +2 -1
  130. package/dist/cli/file-processor.js.map +1 -1
  131. package/dist/cli/list-models.d.ts +1 -1
  132. package/dist/cli/list-models.d.ts.map +1 -1
  133. package/dist/cli/list-models.js +2 -2
  134. package/dist/cli/list-models.js.map +1 -1
  135. package/dist/cli/session-picker.d.ts +1 -1
  136. package/dist/cli/session-picker.d.ts.map +1 -1
  137. package/dist/cli/session-picker.js.map +1 -1
  138. package/dist/cli/setup.d.ts +2 -0
  139. package/dist/cli/setup.d.ts.map +1 -0
  140. package/dist/cli/setup.js +12 -0
  141. package/dist/cli/setup.js.map +1 -0
  142. package/dist/cli/startup-ui.d.ts +2 -2
  143. package/dist/cli/startup-ui.d.ts.map +1 -1
  144. package/dist/cli/startup-ui.js +42 -33
  145. package/dist/cli/startup-ui.js.map +1 -1
  146. package/dist/cli.js +3 -12
  147. package/dist/cli.js.map +1 -1
  148. package/dist/config.d.ts +29 -4
  149. package/dist/config.d.ts.map +1 -1
  150. package/dist/config.js +73 -10
  151. package/dist/config.js.map +1 -1
  152. package/dist/core/agent-session-runtime.d.ts +17 -1
  153. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  154. package/dist/core/agent-session-runtime.js +98 -32
  155. package/dist/core/agent-session-runtime.js.map +1 -1
  156. package/dist/core/agent-session-services.d.ts +2 -1
  157. package/dist/core/agent-session-services.d.ts.map +1 -1
  158. package/dist/core/agent-session-services.js +15 -0
  159. package/dist/core/agent-session-services.js.map +1 -1
  160. package/dist/core/agent-session.d.ts +266 -49
  161. package/dist/core/agent-session.d.ts.map +1 -1
  162. package/dist/core/agent-session.js +1503 -597
  163. package/dist/core/agent-session.js.map +1 -1
  164. package/dist/core/auth-storage.d.ts +25 -9
  165. package/dist/core/auth-storage.d.ts.map +1 -1
  166. package/dist/core/auth-storage.js +245 -45
  167. package/dist/core/auth-storage.js.map +1 -1
  168. package/dist/core/bug-report-upload.d.ts +11 -0
  169. package/dist/core/bug-report-upload.d.ts.map +1 -0
  170. package/dist/core/bug-report-upload.js +20 -0
  171. package/dist/core/bug-report-upload.js.map +1 -0
  172. package/dist/core/bug-report.d.ts +176 -0
  173. package/dist/core/bug-report.d.ts.map +1 -0
  174. package/dist/core/bug-report.js +292 -0
  175. package/dist/core/bug-report.js.map +1 -0
  176. package/dist/core/builtins/checkpoints.d.ts +20 -0
  177. package/dist/core/builtins/checkpoints.d.ts.map +1 -0
  178. package/dist/core/builtins/checkpoints.js +161 -0
  179. package/dist/core/builtins/checkpoints.js.map +1 -0
  180. package/dist/core/builtins/duet.d.ts +26 -0
  181. package/dist/core/builtins/duet.d.ts.map +1 -0
  182. package/dist/core/builtins/duet.js +660 -0
  183. package/dist/core/builtins/duet.js.map +1 -0
  184. package/dist/core/builtins/index.d.ts.map +1 -1
  185. package/dist/core/builtins/index.js +7 -1
  186. package/dist/core/builtins/index.js.map +1 -1
  187. package/dist/core/builtins/subagent.d.ts +24 -4
  188. package/dist/core/builtins/subagent.d.ts.map +1 -1
  189. package/dist/core/builtins/subagent.js +278 -35
  190. package/dist/core/builtins/subagent.js.map +1 -1
  191. package/dist/core/cache-stats.d.ts.map +1 -1
  192. package/dist/core/cache-stats.js +12 -1
  193. package/dist/core/cache-stats.js.map +1 -1
  194. package/dist/core/cache-warmer.d.ts +103 -0
  195. package/dist/core/cache-warmer.d.ts.map +1 -0
  196. package/dist/core/cache-warmer.js +356 -0
  197. package/dist/core/cache-warmer.js.map +1 -0
  198. package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
  199. package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
  200. package/dist/core/checkpoints/checkpoint-cli.js +78 -0
  201. package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
  202. package/dist/core/checkpoints/checkpoint-manager.d.ts +298 -0
  203. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
  204. package/dist/core/checkpoints/checkpoint-manager.js +901 -0
  205. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
  206. package/dist/core/checkpoints/rewind.d.ts +143 -0
  207. package/dist/core/checkpoints/rewind.d.ts.map +1 -0
  208. package/dist/core/checkpoints/rewind.js +247 -0
  209. package/dist/core/checkpoints/rewind.js.map +1 -0
  210. package/dist/core/compaction/branch-summarization.d.ts +1 -1
  211. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  212. package/dist/core/compaction/branch-summarization.js +11 -6
  213. package/dist/core/compaction/branch-summarization.js.map +1 -1
  214. package/dist/core/compaction/compaction.d.ts +14 -6
  215. package/dist/core/compaction/compaction.d.ts.map +1 -1
  216. package/dist/core/compaction/compaction.js +221 -122
  217. package/dist/core/compaction/compaction.js.map +1 -1
  218. package/dist/core/compaction/utils.d.ts +2 -1
  219. package/dist/core/compaction/utils.d.ts.map +1 -1
  220. package/dist/core/compaction/utils.js +25 -18
  221. package/dist/core/compaction/utils.js.map +1 -1
  222. package/dist/core/crash-log.d.ts +27 -0
  223. package/dist/core/crash-log.d.ts.map +1 -0
  224. package/dist/core/crash-log.js +140 -0
  225. package/dist/core/crash-log.js.map +1 -0
  226. package/dist/core/defaults.d.ts +1 -0
  227. package/dist/core/defaults.d.ts.map +1 -1
  228. package/dist/core/defaults.js +9 -0
  229. package/dist/core/defaults.js.map +1 -1
  230. package/dist/core/experimental.js +1 -1
  231. package/dist/core/experimental.js.map +1 -1
  232. package/dist/core/export-html/template.css +10 -0
  233. package/dist/core/export-html/template.js +72 -18
  234. package/dist/core/extensions/index.d.ts +2 -2
  235. package/dist/core/extensions/index.d.ts.map +1 -1
  236. package/dist/core/extensions/index.js +1 -1
  237. package/dist/core/extensions/index.js.map +1 -1
  238. package/dist/core/extensions/jiti-loader.d.ts +2 -0
  239. package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
  240. package/dist/core/extensions/jiti-loader.js +5 -0
  241. package/dist/core/extensions/jiti-loader.js.map +1 -0
  242. package/dist/core/extensions/loader.d.ts.map +1 -1
  243. package/dist/core/extensions/loader.js +298 -96
  244. package/dist/core/extensions/loader.js.map +1 -1
  245. package/dist/core/extensions/runner.d.ts +59 -9
  246. package/dist/core/extensions/runner.d.ts.map +1 -1
  247. package/dist/core/extensions/runner.js +410 -103
  248. package/dist/core/extensions/runner.js.map +1 -1
  249. package/dist/core/extensions/types.d.ts +701 -85
  250. package/dist/core/extensions/types.d.ts.map +1 -1
  251. package/dist/core/extensions/types.js +3 -0
  252. package/dist/core/extensions/types.js.map +1 -1
  253. package/dist/core/extensions/virtual-modules.d.ts +3 -0
  254. package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
  255. package/dist/core/extensions/virtual-modules.js +37 -0
  256. package/dist/core/extensions/virtual-modules.js.map +1 -0
  257. package/dist/core/extensions/wrapper.d.ts +2 -2
  258. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  259. package/dist/core/extensions/wrapper.js +3 -22
  260. package/dist/core/extensions/wrapper.js.map +1 -1
  261. package/dist/core/footer-data-provider.d.ts +1 -1
  262. package/dist/core/footer-data-provider.js +19 -18
  263. package/dist/core/footer-data-provider.js.map +1 -1
  264. package/dist/core/http-dispatcher.d.ts.map +1 -1
  265. package/dist/core/http-dispatcher.js +7 -0
  266. package/dist/core/http-dispatcher.js.map +1 -1
  267. package/dist/core/index.d.ts +2 -1
  268. package/dist/core/index.d.ts.map +1 -1
  269. package/dist/core/index.js.map +1 -1
  270. package/dist/core/keybindings.d.ts +88 -13
  271. package/dist/core/keybindings.d.ts.map +1 -1
  272. package/dist/core/keybindings.js +34 -7
  273. package/dist/core/keybindings.js.map +1 -1
  274. package/dist/core/mcp-servers.d.ts +119 -0
  275. package/dist/core/mcp-servers.d.ts.map +1 -0
  276. package/dist/core/mcp-servers.js +191 -0
  277. package/dist/core/mcp-servers.js.map +1 -0
  278. package/dist/core/messages.d.ts +1 -1
  279. package/dist/core/messages.d.ts.map +1 -1
  280. package/dist/core/messages.js +1 -0
  281. package/dist/core/messages.js.map +1 -1
  282. package/dist/core/model-config.d.ts +202 -20
  283. package/dist/core/model-config.d.ts.map +1 -1
  284. package/dist/core/model-config.js +53 -18
  285. package/dist/core/model-config.js.map +1 -1
  286. package/dist/core/model-registry.d.ts +21 -3
  287. package/dist/core/model-registry.d.ts.map +1 -1
  288. package/dist/core/model-registry.js +47 -10
  289. package/dist/core/model-registry.js.map +1 -1
  290. package/dist/core/model-resolver.d.ts +7 -5
  291. package/dist/core/model-resolver.d.ts.map +1 -1
  292. package/dist/core/model-resolver.js +62 -23
  293. package/dist/core/model-resolver.js.map +1 -1
  294. package/dist/core/model-runtime.d.ts +80 -15
  295. package/dist/core/model-runtime.d.ts.map +1 -1
  296. package/dist/core/model-runtime.js +466 -120
  297. package/dist/core/model-runtime.js.map +1 -1
  298. package/dist/core/models-store.d.ts +12 -7
  299. package/dist/core/models-store.d.ts.map +1 -1
  300. package/dist/core/models-store.js +87 -18
  301. package/dist/core/models-store.js.map +1 -1
  302. package/dist/core/multi-agent/fsm.js +8 -3
  303. package/dist/core/multi-agent/fsm.js.map +1 -1
  304. package/dist/core/multi-agent/mailbox.js +1 -3
  305. package/dist/core/multi-agent/mailbox.js.map +1 -1
  306. package/dist/core/multi-agent/permission-gate.d.ts +5 -2
  307. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  308. package/dist/core/multi-agent/permission-gate.js +601 -37
  309. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  310. package/dist/core/multi-agent/task-board.js +2 -4
  311. package/dist/core/multi-agent/task-board.js.map +1 -1
  312. package/dist/core/multi-agent/worktree.d.ts +2 -0
  313. package/dist/core/multi-agent/worktree.d.ts.map +1 -1
  314. package/dist/core/multi-agent/worktree.js +3 -5
  315. package/dist/core/multi-agent/worktree.js.map +1 -1
  316. package/dist/core/nested-tool-calls.d.ts +102 -0
  317. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  318. package/dist/core/nested-tool-calls.js +178 -0
  319. package/dist/core/nested-tool-calls.js.map +1 -0
  320. package/dist/core/package-manager.d.ts +16 -0
  321. package/dist/core/package-manager.d.ts.map +1 -1
  322. package/dist/core/package-manager.js +162 -69
  323. package/dist/core/package-manager.js.map +1 -1
  324. package/dist/core/permission-relay/index.d.ts +19 -0
  325. package/dist/core/permission-relay/index.d.ts.map +1 -0
  326. package/dist/core/permission-relay/index.js +49 -0
  327. package/dist/core/permission-relay/index.js.map +1 -0
  328. package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
  329. package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
  330. package/dist/core/permission-relay/relay-ui-context.js +788 -0
  331. package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
  332. package/dist/core/permission-relay/types.d.ts +222 -0
  333. package/dist/core/permission-relay/types.d.ts.map +1 -0
  334. package/dist/core/permission-relay/types.js +15 -0
  335. package/dist/core/permission-relay/types.js.map +1 -0
  336. package/dist/core/pi-manifest.d.ts +14 -0
  337. package/dist/core/pi-manifest.d.ts.map +1 -0
  338. package/dist/core/pi-manifest.js +36 -0
  339. package/dist/core/pi-manifest.js.map +1 -0
  340. package/dist/core/project-trust.js +2 -2
  341. package/dist/core/project-trust.js.map +1 -1
  342. package/dist/core/prompt-templates.d.ts +6 -1
  343. package/dist/core/prompt-templates.d.ts.map +1 -1
  344. package/dist/core/prompt-templates.js +63 -37
  345. package/dist/core/prompt-templates.js.map +1 -1
  346. package/dist/core/provider-attribution.js +5 -5
  347. package/dist/core/provider-attribution.js.map +1 -1
  348. package/dist/core/provider-composer.d.ts +44 -20
  349. package/dist/core/provider-composer.d.ts.map +1 -1
  350. package/dist/core/provider-composer.js +151 -51
  351. package/dist/core/provider-composer.js.map +1 -1
  352. package/dist/core/radius.d.ts +13 -0
  353. package/dist/core/radius.d.ts.map +1 -1
  354. package/dist/core/radius.js +19 -0
  355. package/dist/core/radius.js.map +1 -1
  356. package/dist/core/remote-catalog-provider.d.ts +10 -3
  357. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  358. package/dist/core/remote-catalog-provider.js +105 -81
  359. package/dist/core/remote-catalog-provider.js.map +1 -1
  360. package/dist/core/resource-loader.d.ts +28 -1
  361. package/dist/core/resource-loader.d.ts.map +1 -1
  362. package/dist/core/resource-loader.js +319 -65
  363. package/dist/core/resource-loader.js.map +1 -1
  364. package/dist/core/runtime-credentials.d.ts +5 -5
  365. package/dist/core/runtime-credentials.d.ts.map +1 -1
  366. package/dist/core/runtime-credentials.js +13 -9
  367. package/dist/core/runtime-credentials.js.map +1 -1
  368. package/dist/core/sandbox/bash-operations.d.ts +149 -0
  369. package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
  370. package/dist/core/sandbox/bash-operations.js +163 -0
  371. package/dist/core/sandbox/bash-operations.js.map +1 -0
  372. package/dist/core/sandbox/env.d.ts +83 -0
  373. package/dist/core/sandbox/env.d.ts.map +1 -0
  374. package/dist/core/sandbox/env.js +123 -0
  375. package/dist/core/sandbox/env.js.map +1 -0
  376. package/dist/core/sandbox/executor.d.ts +104 -0
  377. package/dist/core/sandbox/executor.d.ts.map +1 -0
  378. package/dist/core/sandbox/executor.js +93 -0
  379. package/dist/core/sandbox/executor.js.map +1 -0
  380. package/dist/core/sandbox/index.d.ts +36 -0
  381. package/dist/core/sandbox/index.d.ts.map +1 -0
  382. package/dist/core/sandbox/index.js +36 -0
  383. package/dist/core/sandbox/index.js.map +1 -0
  384. package/dist/core/sandbox/linux.d.ts +121 -0
  385. package/dist/core/sandbox/linux.d.ts.map +1 -0
  386. package/dist/core/sandbox/linux.js +260 -0
  387. package/dist/core/sandbox/linux.js.map +1 -0
  388. package/dist/core/sandbox/policy.d.ts +142 -0
  389. package/dist/core/sandbox/policy.d.ts.map +1 -0
  390. package/dist/core/sandbox/policy.js +297 -0
  391. package/dist/core/sandbox/policy.js.map +1 -0
  392. package/dist/core/sandbox/real-path.d.ts +112 -0
  393. package/dist/core/sandbox/real-path.d.ts.map +1 -0
  394. package/dist/core/sandbox/real-path.js +158 -0
  395. package/dist/core/sandbox/real-path.js.map +1 -0
  396. package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
  397. package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
  398. package/dist/core/sandbox/seatbelt-profile.js +239 -0
  399. package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
  400. package/dist/core/sandbox/seatbelt.d.ts +95 -0
  401. package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
  402. package/dist/core/sandbox/seatbelt.js +154 -0
  403. package/dist/core/sandbox/seatbelt.js.map +1 -0
  404. package/dist/core/sandbox/self-test.d.ts +109 -0
  405. package/dist/core/sandbox/self-test.d.ts.map +1 -0
  406. package/dist/core/sandbox/self-test.js +369 -0
  407. package/dist/core/sandbox/self-test.js.map +1 -0
  408. package/dist/core/sandbox/spawn.d.ts +33 -0
  409. package/dist/core/sandbox/spawn.d.ts.map +1 -0
  410. package/dist/core/sandbox/spawn.js +87 -0
  411. package/dist/core/sandbox/spawn.js.map +1 -0
  412. package/dist/core/sdk.d.ts +7 -5
  413. package/dist/core/sdk.d.ts.map +1 -1
  414. package/dist/core/sdk.js +103 -53
  415. package/dist/core/sdk.js.map +1 -1
  416. package/dist/core/session-cwd.js +1 -0
  417. package/dist/core/session-cwd.js.map +1 -1
  418. package/dist/core/session-export.d.ts +8 -0
  419. package/dist/core/session-export.d.ts.map +1 -0
  420. package/dist/core/session-export.js +33 -0
  421. package/dist/core/session-export.js.map +1 -0
  422. package/dist/core/session-manager.d.ts +134 -15
  423. package/dist/core/session-manager.d.ts.map +1 -1
  424. package/dist/core/session-manager.js +366 -149
  425. package/dist/core/session-manager.js.map +1 -1
  426. package/dist/core/settings-diagnostics.d.ts +9 -0
  427. package/dist/core/settings-diagnostics.d.ts.map +1 -0
  428. package/dist/core/settings-diagnostics.js +21 -0
  429. package/dist/core/settings-diagnostics.js.map +1 -0
  430. package/dist/core/settings-manager.d.ts +105 -4
  431. package/dist/core/settings-manager.d.ts.map +1 -1
  432. package/dist/core/settings-manager.js +274 -40
  433. package/dist/core/settings-manager.js.map +1 -1
  434. package/dist/core/skills.d.ts +3 -1
  435. package/dist/core/skills.d.ts.map +1 -1
  436. package/dist/core/skills.js +70 -39
  437. package/dist/core/skills.js.map +1 -1
  438. package/dist/core/slash-commands.d.ts.map +1 -1
  439. package/dist/core/slash-commands.js +4 -1
  440. package/dist/core/slash-commands.js.map +1 -1
  441. package/dist/core/soak/soak-log.d.ts +298 -0
  442. package/dist/core/soak/soak-log.d.ts.map +1 -0
  443. package/dist/core/soak/soak-log.js +666 -0
  444. package/dist/core/soak/soak-log.js.map +1 -0
  445. package/dist/core/soak/soak-reader.d.ts +60 -0
  446. package/dist/core/soak/soak-reader.d.ts.map +1 -0
  447. package/dist/core/soak/soak-reader.js +106 -0
  448. package/dist/core/soak/soak-reader.js.map +1 -0
  449. package/dist/core/socket-server/discovery.d.ts +78 -1
  450. package/dist/core/socket-server/discovery.d.ts.map +1 -1
  451. package/dist/core/socket-server/discovery.js +356 -37
  452. package/dist/core/socket-server/discovery.js.map +1 -1
  453. package/dist/core/socket-server/index.d.ts +10 -4
  454. package/dist/core/socket-server/index.d.ts.map +1 -1
  455. package/dist/core/socket-server/index.js +6 -3
  456. package/dist/core/socket-server/index.js.map +1 -1
  457. package/dist/core/socket-server/permission-delivery.d.ts +125 -0
  458. package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
  459. package/dist/core/socket-server/permission-delivery.js +152 -0
  460. package/dist/core/socket-server/permission-delivery.js.map +1 -0
  461. package/dist/core/socket-server/permission-registry.d.ts +301 -0
  462. package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
  463. package/dist/core/socket-server/permission-registry.js +410 -0
  464. package/dist/core/socket-server/permission-registry.js.map +1 -0
  465. package/dist/core/socket-server/permission-relay.d.ts +81 -0
  466. package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
  467. package/dist/core/socket-server/permission-relay.js +528 -0
  468. package/dist/core/socket-server/permission-relay.js.map +1 -0
  469. package/dist/core/socket-server/safe-text.d.ts +83 -0
  470. package/dist/core/socket-server/safe-text.d.ts.map +1 -0
  471. package/dist/core/socket-server/safe-text.js +277 -0
  472. package/dist/core/socket-server/safe-text.js.map +1 -0
  473. package/dist/core/socket-server/session-integration.d.ts +65 -2
  474. package/dist/core/socket-server/session-integration.d.ts.map +1 -1
  475. package/dist/core/socket-server/session-integration.js +434 -32
  476. package/dist/core/socket-server/session-integration.js.map +1 -1
  477. package/dist/core/socket-server/socket-client.d.ts +21 -2
  478. package/dist/core/socket-server/socket-client.d.ts.map +1 -1
  479. package/dist/core/socket-server/socket-client.js +52 -1
  480. package/dist/core/socket-server/socket-client.js.map +1 -1
  481. package/dist/core/socket-server/socket-server.d.ts +152 -1
  482. package/dist/core/socket-server/socket-server.d.ts.map +1 -1
  483. package/dist/core/socket-server/socket-server.js +786 -26
  484. package/dist/core/socket-server/socket-server.js.map +1 -1
  485. package/dist/core/socket-server/types.d.ts +108 -3
  486. package/dist/core/socket-server/types.d.ts.map +1 -1
  487. package/dist/core/socket-server/types.js +13 -1
  488. package/dist/core/socket-server/types.js.map +1 -1
  489. package/dist/core/source-info.d.ts +8 -0
  490. package/dist/core/source-info.d.ts.map +1 -1
  491. package/dist/core/source-info.js +16 -0
  492. package/dist/core/source-info.js.map +1 -1
  493. package/dist/core/system-prompt.d.ts +49 -6
  494. package/dist/core/system-prompt.d.ts.map +1 -1
  495. package/dist/core/system-prompt.js +126 -90
  496. package/dist/core/system-prompt.js.map +1 -1
  497. package/dist/core/tools/bash.d.ts +32 -2
  498. package/dist/core/tools/bash.d.ts.map +1 -1
  499. package/dist/core/tools/bash.js +83 -141
  500. package/dist/core/tools/bash.js.map +1 -1
  501. package/dist/core/tools/edit-diff.d.ts +0 -5
  502. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  503. package/dist/core/tools/edit-diff.js +2 -5
  504. package/dist/core/tools/edit-diff.js.map +1 -1
  505. package/dist/core/tools/edit.d.ts +5 -12
  506. package/dist/core/tools/edit.d.ts.map +1 -1
  507. package/dist/core/tools/edit.js +36 -173
  508. package/dist/core/tools/edit.js.map +1 -1
  509. package/dist/core/tools/find.d.ts +7 -0
  510. package/dist/core/tools/find.d.ts.map +1 -1
  511. package/dist/core/tools/find.js +22 -76
  512. package/dist/core/tools/find.js.map +1 -1
  513. package/dist/core/tools/grep.d.ts +4 -0
  514. package/dist/core/tools/grep.d.ts.map +1 -1
  515. package/dist/core/tools/grep.js +10 -62
  516. package/dist/core/tools/grep.js.map +1 -1
  517. package/dist/core/tools/index.d.ts +4 -1
  518. package/dist/core/tools/index.d.ts.map +1 -1
  519. package/dist/core/tools/index.js +18 -1
  520. package/dist/core/tools/index.js.map +1 -1
  521. package/dist/core/tools/ls.d.ts +4 -0
  522. package/dist/core/tools/ls.d.ts.map +1 -1
  523. package/dist/core/tools/ls.js +9 -50
  524. package/dist/core/tools/ls.js.map +1 -1
  525. package/dist/core/tools/output-accumulator.d.ts +11 -0
  526. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  527. package/dist/core/tools/output-accumulator.js +54 -12
  528. package/dist/core/tools/output-accumulator.js.map +1 -1
  529. package/dist/core/tools/powershell.d.ts +16 -0
  530. package/dist/core/tools/powershell.d.ts.map +1 -0
  531. package/dist/core/tools/powershell.js +39 -0
  532. package/dist/core/tools/powershell.js.map +1 -0
  533. package/dist/core/tools/read.d.ts +8 -1
  534. package/dist/core/tools/read.d.ts.map +1 -1
  535. package/dist/core/tools/read.js +16 -123
  536. package/dist/core/tools/read.js.map +1 -1
  537. package/dist/core/tools/render-utils.d.ts +6 -0
  538. package/dist/core/tools/render-utils.d.ts.map +1 -1
  539. package/dist/core/tools/render-utils.js +26 -0
  540. package/dist/core/tools/render-utils.js.map +1 -1
  541. package/dist/core/tools/renderers/bash.d.ts +12 -0
  542. package/dist/core/tools/renderers/bash.d.ts.map +1 -0
  543. package/dist/core/tools/renderers/bash.js +117 -0
  544. package/dist/core/tools/renderers/bash.js.map +1 -0
  545. package/dist/core/tools/renderers/edit.d.ts +23 -0
  546. package/dist/core/tools/renderers/edit.d.ts.map +1 -0
  547. package/dist/core/tools/renderers/edit.js +167 -0
  548. package/dist/core/tools/renderers/edit.js.map +1 -0
  549. package/dist/core/tools/renderers/find.d.ts +10 -0
  550. package/dist/core/tools/renderers/find.d.ts.map +1 -0
  551. package/dist/core/tools/renderers/find.js +64 -0
  552. package/dist/core/tools/renderers/find.js.map +1 -0
  553. package/dist/core/tools/renderers/grep.d.ts +10 -0
  554. package/dist/core/tools/renderers/grep.d.ts.map +1 -0
  555. package/dist/core/tools/renderers/grep.js +69 -0
  556. package/dist/core/tools/renderers/grep.js.map +1 -0
  557. package/dist/core/tools/renderers/index.d.ts +28 -0
  558. package/dist/core/tools/renderers/index.d.ts.map +1 -0
  559. package/dist/core/tools/renderers/index.js +47 -0
  560. package/dist/core/tools/renderers/index.js.map +1 -0
  561. package/dist/core/tools/renderers/ls.d.ts +10 -0
  562. package/dist/core/tools/renderers/ls.d.ts.map +1 -0
  563. package/dist/core/tools/renderers/ls.js +58 -0
  564. package/dist/core/tools/renderers/ls.js.map +1 -0
  565. package/dist/core/tools/renderers/read.d.ts +11 -0
  566. package/dist/core/tools/renderers/read.d.ts.map +1 -0
  567. package/dist/core/tools/renderers/read.js +130 -0
  568. package/dist/core/tools/renderers/read.js.map +1 -0
  569. package/dist/core/tools/renderers/write.d.ts +10 -0
  570. package/dist/core/tools/renderers/write.d.ts.map +1 -0
  571. package/dist/core/tools/renderers/write.js +153 -0
  572. package/dist/core/tools/renderers/write.js.map +1 -0
  573. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  574. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  575. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  576. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  577. package/dist/core/tools/truncate.d.ts +14 -0
  578. package/dist/core/tools/truncate.d.ts.map +1 -1
  579. package/dist/core/tools/truncate.js +29 -0
  580. package/dist/core/tools/truncate.js.map +1 -1
  581. package/dist/core/tools/write.d.ts +4 -0
  582. package/dist/core/tools/write.d.ts.map +1 -1
  583. package/dist/core/tools/write.js +12 -147
  584. package/dist/core/tools/write.js.map +1 -1
  585. package/dist/core/trust-manager.d.ts +6 -4
  586. package/dist/core/trust-manager.d.ts.map +1 -1
  587. package/dist/core/trust-manager.js +59 -22
  588. package/dist/core/trust-manager.js.map +1 -1
  589. package/dist/core/usage-totals.d.ts +3 -1
  590. package/dist/core/usage-totals.d.ts.map +1 -1
  591. package/dist/core/usage-totals.js +28 -1
  592. package/dist/core/usage-totals.js.map +1 -1
  593. package/dist/core/virtual-models.d.ts +117 -0
  594. package/dist/core/virtual-models.d.ts.map +1 -0
  595. package/dist/core/virtual-models.js +124 -0
  596. package/dist/core/virtual-models.js.map +1 -0
  597. package/dist/experimental/micro/api.d.ts +81 -0
  598. package/dist/experimental/micro/api.d.ts.map +1 -0
  599. package/dist/experimental/micro/api.js +2 -0
  600. package/dist/experimental/micro/api.js.map +1 -0
  601. package/dist/experimental/micro/main.d.ts +3 -0
  602. package/dist/experimental/micro/main.d.ts.map +1 -0
  603. package/dist/experimental/micro/main.js +21 -0
  604. package/dist/experimental/micro/main.js.map +1 -0
  605. package/dist/experimental/micro/models.d.ts +11 -0
  606. package/dist/experimental/micro/models.d.ts.map +1 -0
  607. package/dist/experimental/micro/models.js +95 -0
  608. package/dist/experimental/micro/models.js.map +1 -0
  609. package/dist/experimental/micro/runtime.d.ts +12 -0
  610. package/dist/experimental/micro/runtime.d.ts.map +1 -0
  611. package/dist/experimental/micro/runtime.js +465 -0
  612. package/dist/experimental/micro/runtime.js.map +1 -0
  613. package/dist/experimental/micro/sessions.d.ts +10 -0
  614. package/dist/experimental/micro/sessions.d.ts.map +1 -0
  615. package/dist/experimental/micro/sessions.js +41 -0
  616. package/dist/experimental/micro/sessions.js.map +1 -0
  617. package/dist/experimental/micro/tools.d.ts +10 -0
  618. package/dist/experimental/micro/tools.d.ts.map +1 -0
  619. package/dist/experimental/micro/tools.js +96 -0
  620. package/dist/experimental/micro/tools.js.map +1 -0
  621. package/dist/experimental/micro/tui.d.ts +3 -0
  622. package/dist/experimental/micro/tui.d.ts.map +1 -0
  623. package/dist/experimental/micro/tui.js +510 -0
  624. package/dist/experimental/micro/tui.js.map +1 -0
  625. package/dist/experimental/mini/main.d.ts +7 -0
  626. package/dist/experimental/mini/main.d.ts.map +1 -0
  627. package/dist/experimental/mini/main.js +21 -0
  628. package/dist/experimental/mini/main.js.map +1 -0
  629. package/dist/experimental/mini/server/entry.d.ts +3 -0
  630. package/dist/experimental/mini/server/entry.d.ts.map +1 -0
  631. package/dist/experimental/mini/server/entry.js +11 -0
  632. package/dist/experimental/mini/server/entry.js.map +1 -0
  633. package/dist/experimental/mini/server/run.d.ts +13 -0
  634. package/dist/experimental/mini/server/run.d.ts.map +1 -0
  635. package/dist/experimental/mini/server/run.js +150 -0
  636. package/dist/experimental/mini/server/run.js.map +1 -0
  637. package/dist/experimental/mini/shared/protocol.d.ts +127 -0
  638. package/dist/experimental/mini/shared/protocol.d.ts.map +1 -0
  639. package/dist/experimental/mini/shared/protocol.js +13 -0
  640. package/dist/experimental/mini/shared/protocol.js.map +1 -0
  641. package/dist/experimental/mini/shared/rpc.d.ts +49 -0
  642. package/dist/experimental/mini/shared/rpc.d.ts.map +1 -0
  643. package/dist/experimental/mini/shared/rpc.js +171 -0
  644. package/dist/experimental/mini/shared/rpc.js.map +1 -0
  645. package/dist/experimental/mini/shared/transport.d.ts +35 -0
  646. package/dist/experimental/mini/shared/transport.d.ts.map +1 -0
  647. package/dist/experimental/mini/shared/transport.js +94 -0
  648. package/dist/experimental/mini/shared/transport.js.map +1 -0
  649. package/dist/experimental/mini/tui/run.d.ts +9 -0
  650. package/dist/experimental/mini/tui/run.d.ts.map +1 -0
  651. package/dist/experimental/mini/tui/run.js +62 -0
  652. package/dist/experimental/mini/tui/run.js.map +1 -0
  653. package/dist/experimental/mini/tui/session.d.ts +26 -0
  654. package/dist/experimental/mini/tui/session.d.ts.map +1 -0
  655. package/dist/experimental/mini/tui/session.js +94 -0
  656. package/dist/experimental/mini/tui/session.js.map +1 -0
  657. package/dist/experimental/mini/tui/view.d.ts +10 -0
  658. package/dist/experimental/mini/tui/view.d.ts.map +1 -0
  659. package/dist/experimental/mini/tui/view.js +461 -0
  660. package/dist/experimental/mini/tui/view.js.map +1 -0
  661. package/dist/experimental/mini/worker/entry.d.ts +3 -0
  662. package/dist/experimental/mini/worker/entry.d.ts.map +1 -0
  663. package/dist/experimental/mini/worker/entry.js +10 -0
  664. package/dist/experimental/mini/worker/entry.js.map +1 -0
  665. package/dist/experimental/mini/worker/lane-service.d.ts +44 -0
  666. package/dist/experimental/mini/worker/lane-service.d.ts.map +1 -0
  667. package/dist/experimental/mini/worker/lane-service.js +97 -0
  668. package/dist/experimental/mini/worker/lane-service.js.map +1 -0
  669. package/dist/experimental/mini/worker/models-service.d.ts +19 -0
  670. package/dist/experimental/mini/worker/models-service.d.ts.map +1 -0
  671. package/dist/experimental/mini/worker/models-service.js +136 -0
  672. package/dist/experimental/mini/worker/models-service.js.map +1 -0
  673. package/dist/experimental/mini/worker/run.d.ts +14 -0
  674. package/dist/experimental/mini/worker/run.d.ts.map +1 -0
  675. package/dist/experimental/mini/worker/run.js +88 -0
  676. package/dist/experimental/mini/worker/run.js.map +1 -0
  677. package/dist/extensions/codemode/execute.d.ts +16 -0
  678. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  679. package/dist/extensions/codemode/execute.js +429 -0
  680. package/dist/extensions/codemode/execute.js.map +1 -0
  681. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  682. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  683. package/dist/extensions/codemode/execute.lazy.js +3 -0
  684. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  685. package/dist/extensions/codemode/index.d.ts +21 -0
  686. package/dist/extensions/codemode/index.d.ts.map +1 -0
  687. package/dist/extensions/codemode/index.js +31 -0
  688. package/dist/extensions/codemode/index.js.map +1 -0
  689. package/dist/extensions/codemode/renderer.d.ts +12 -0
  690. package/dist/extensions/codemode/renderer.d.ts.map +1 -0
  691. package/dist/extensions/codemode/renderer.js +137 -0
  692. package/dist/extensions/codemode/renderer.js.map +1 -0
  693. package/dist/extensions/codemode/tool.d.ts +123 -0
  694. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  695. package/dist/extensions/codemode/tool.js +315 -0
  696. package/dist/extensions/codemode/tool.js.map +1 -0
  697. package/dist/extensions/codemode/worker.d.ts +7 -0
  698. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  699. package/dist/extensions/codemode/worker.js +7 -0
  700. package/dist/extensions/codemode/worker.js.map +1 -0
  701. package/dist/extensions/index.d.ts.map +1 -1
  702. package/dist/extensions/index.js +13 -1
  703. package/dist/extensions/index.js.map +1 -1
  704. package/dist/extensions/llama/client.d.ts +8 -0
  705. package/dist/extensions/llama/client.d.ts.map +1 -1
  706. package/dist/extensions/llama/client.js +13 -0
  707. package/dist/extensions/llama/client.js.map +1 -1
  708. package/dist/extensions/llama/huggingface.js +2 -0
  709. package/dist/extensions/llama/huggingface.js.map +1 -1
  710. package/dist/extensions/llama/index.d.ts.map +1 -1
  711. package/dist/extensions/llama/index.js +13 -2
  712. package/dist/extensions/llama/index.js.map +1 -1
  713. package/dist/extensions/llama/provider.d.ts +4 -2
  714. package/dist/extensions/llama/provider.d.ts.map +1 -1
  715. package/dist/extensions/llama/provider.js +121 -15
  716. package/dist/extensions/llama/provider.js.map +1 -1
  717. package/dist/extensions/llama/ui.js +28 -12
  718. package/dist/extensions/llama/ui.js.map +1 -1
  719. package/dist/extensions/mcp/cli.d.ts +21 -0
  720. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  721. package/dist/extensions/mcp/cli.js +500 -0
  722. package/dist/extensions/mcp/cli.js.map +1 -0
  723. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  724. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  725. package/dist/extensions/mcp/cli.lazy.js +3 -0
  726. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  727. package/dist/extensions/mcp/config.d.ts +72 -0
  728. package/dist/extensions/mcp/config.d.ts.map +1 -0
  729. package/dist/extensions/mcp/config.js +158 -0
  730. package/dist/extensions/mcp/config.js.map +1 -0
  731. package/dist/extensions/mcp/index.d.ts +76 -0
  732. package/dist/extensions/mcp/index.d.ts.map +1 -0
  733. package/dist/extensions/mcp/index.js +1055 -0
  734. package/dist/extensions/mcp/index.js.map +1 -0
  735. package/dist/extensions/mcp/log.d.ts +16 -0
  736. package/dist/extensions/mcp/log.d.ts.map +1 -0
  737. package/dist/extensions/mcp/log.js +66 -0
  738. package/dist/extensions/mcp/log.js.map +1 -0
  739. package/dist/extensions/mcp/oauth.d.ts +96 -0
  740. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  741. package/dist/extensions/mcp/oauth.js +333 -0
  742. package/dist/extensions/mcp/oauth.js.map +1 -0
  743. package/dist/extensions/mcp/resources.d.ts +43 -0
  744. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  745. package/dist/extensions/mcp/resources.js +262 -0
  746. package/dist/extensions/mcp/resources.js.map +1 -0
  747. package/dist/extensions/mcp/runtime.d.ts +98 -0
  748. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  749. package/dist/extensions/mcp/runtime.js +394 -0
  750. package/dist/extensions/mcp/runtime.js.map +1 -0
  751. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  752. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  753. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  754. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  755. package/dist/extensions/mcp/tools.d.ts +84 -0
  756. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  757. package/dist/extensions/mcp/tools.js +251 -0
  758. package/dist/extensions/mcp/tools.js.map +1 -0
  759. package/dist/extensions/mcp/ui.d.ts +60 -0
  760. package/dist/extensions/mcp/ui.d.ts.map +1 -0
  761. package/dist/extensions/mcp/ui.js +174 -0
  762. package/dist/extensions/mcp/ui.js.map +1 -0
  763. package/dist/extensions/stub-provider/index.d.ts +9 -0
  764. package/dist/extensions/stub-provider/index.d.ts.map +1 -0
  765. package/dist/extensions/stub-provider/index.js +13 -0
  766. package/dist/extensions/stub-provider/index.js.map +1 -0
  767. package/dist/extensions/stub-provider/provider.d.ts +77 -0
  768. package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
  769. package/dist/extensions/stub-provider/provider.js +194 -0
  770. package/dist/extensions/stub-provider/provider.js.map +1 -0
  771. package/dist/extensions/tool-search/index.d.ts +12 -0
  772. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  773. package/dist/extensions/tool-search/index.js +15 -0
  774. package/dist/extensions/tool-search/index.js.map +1 -0
  775. package/dist/extensions/tool-search/tool.d.ts +73 -0
  776. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  777. package/dist/extensions/tool-search/tool.js +189 -0
  778. package/dist/extensions/tool-search/tool.js.map +1 -0
  779. package/dist/hooks/gsd/draht-quality-gate.js +3 -3
  780. package/dist/index.d.ts +20 -11
  781. package/dist/index.d.ts.map +1 -1
  782. package/dist/index.js +12 -6
  783. package/dist/index.js.map +1 -1
  784. package/dist/main.d.ts +4 -0
  785. package/dist/main.d.ts.map +1 -1
  786. package/dist/main.js +365 -96
  787. package/dist/main.js.map +1 -1
  788. package/dist/migrations.d.ts +1 -1
  789. package/dist/migrations.js +7 -6
  790. package/dist/migrations.js.map +1 -1
  791. package/dist/modes/index.d.ts +1 -0
  792. package/dist/modes/index.d.ts.map +1 -1
  793. package/dist/modes/index.js.map +1 -1
  794. package/dist/modes/interactive/bug-report.d.ts +19 -0
  795. package/dist/modes/interactive/bug-report.d.ts.map +1 -0
  796. package/dist/modes/interactive/bug-report.js +211 -0
  797. package/dist/modes/interactive/bug-report.js.map +1 -0
  798. package/dist/modes/interactive/chat-viewport.d.ts +20 -0
  799. package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
  800. package/dist/modes/interactive/chat-viewport.js +28 -0
  801. package/dist/modes/interactive/chat-viewport.js.map +1 -0
  802. package/dist/modes/interactive/components/armin.js +10 -6
  803. package/dist/modes/interactive/components/armin.js.map +1 -1
  804. package/dist/modes/interactive/components/assistant-message.d.ts +6 -2
  805. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  806. package/dist/modes/interactive/components/assistant-message.js +38 -15
  807. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  808. package/dist/modes/interactive/components/bash-execution.js +9 -4
  809. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  810. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  811. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  812. package/dist/modes/interactive/components/branch-summary-message.d.ts +1 -1
  813. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  814. package/dist/modes/interactive/components/branch-summary-message.js +15 -6
  815. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  816. package/dist/modes/interactive/components/compaction-summary-message.d.ts +1 -1
  817. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  818. package/dist/modes/interactive/components/compaction-summary-message.js +15 -6
  819. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  820. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  821. package/dist/modes/interactive/components/config-selector.js +38 -10
  822. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  823. package/dist/modes/interactive/components/countdown-timer.js +5 -0
  824. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  825. package/dist/modes/interactive/components/custom-editor.d.ts +10 -1
  826. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  827. package/dist/modes/interactive/components/custom-editor.js +54 -2
  828. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  829. package/dist/modes/interactive/components/custom-entry.js +4 -1
  830. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  831. package/dist/modes/interactive/components/custom-message.js +7 -1
  832. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  833. package/dist/modes/interactive/components/daxnuts.js +8 -6
  834. package/dist/modes/interactive/components/daxnuts.js.map +1 -1
  835. package/dist/modes/interactive/components/dynamic-border.js +1 -0
  836. package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
  837. package/dist/modes/interactive/components/extension-editor.d.ts +4 -1
  838. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  839. package/dist/modes/interactive/components/extension-editor.js +14 -3
  840. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  841. package/dist/modes/interactive/components/extension-input.d.ts +2 -0
  842. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  843. package/dist/modes/interactive/components/extension-input.js +14 -2
  844. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  845. package/dist/modes/interactive/components/extension-selector.d.ts +50 -0
  846. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  847. package/dist/modes/interactive/components/extension-selector.js +218 -6
  848. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  849. package/dist/modes/interactive/components/first-time-setup.d.ts +4 -4
  850. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -1
  851. package/dist/modes/interactive/components/first-time-setup.js +12 -4
  852. package/dist/modes/interactive/components/first-time-setup.js.map +1 -1
  853. package/dist/modes/interactive/components/footer.d.ts +7 -0
  854. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  855. package/dist/modes/interactive/components/footer.js +51 -6
  856. package/dist/modes/interactive/components/footer.js.map +1 -1
  857. package/dist/modes/interactive/components/index.d.ts +1 -1
  858. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  859. package/dist/modes/interactive/components/index.js.map +1 -1
  860. package/dist/modes/interactive/components/login-dialog.js +9 -3
  861. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  862. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  863. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  864. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  865. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  866. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  867. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  868. package/dist/modes/interactive/components/mermaid.js +75 -0
  869. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  870. package/dist/modes/interactive/components/model-selector.d.ts +10 -4
  871. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  872. package/dist/modes/interactive/components/model-selector.js +101 -40
  873. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  874. package/dist/modes/interactive/components/oauth-selector.js +11 -3
  875. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  876. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  877. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  878. package/dist/modes/interactive/components/scoped-models-selector.js +60 -32
  879. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  880. package/dist/modes/interactive/components/session-selector.d.ts +5 -5
  881. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  882. package/dist/modes/interactive/components/session-selector.js +138 -80
  883. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  884. package/dist/modes/interactive/components/settings-selector.d.ts +25 -4
  885. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  886. package/dist/modes/interactive/components/settings-selector.js +240 -67
  887. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  888. package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
  889. package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
  890. package/dist/modes/interactive/components/settings-submenu.js +165 -0
  891. package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
  892. package/dist/modes/interactive/components/show-images-selector.js +1 -0
  893. package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
  894. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  895. package/dist/modes/interactive/components/skill-invocation-message.js +14 -5
  896. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  897. package/dist/modes/interactive/components/status-indicator.d.ts +3 -1
  898. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  899. package/dist/modes/interactive/components/status-indicator.js +12 -3
  900. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  901. package/dist/modes/interactive/components/theme-selector.js +2 -0
  902. package/dist/modes/interactive/components/theme-selector.js.map +1 -1
  903. package/dist/modes/interactive/components/themed-text.d.ts +17 -0
  904. package/dist/modes/interactive/components/themed-text.d.ts.map +1 -0
  905. package/dist/modes/interactive/components/themed-text.js +29 -0
  906. package/dist/modes/interactive/components/themed-text.js.map +1 -0
  907. package/dist/modes/interactive/components/thinking-selector.d.ts +15 -3
  908. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  909. package/dist/modes/interactive/components/thinking-selector.js +76 -18
  910. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  911. package/dist/modes/interactive/components/tool-execution.d.ts +21 -4
  912. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  913. package/dist/modes/interactive/components/tool-execution.js +88 -53
  914. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  915. package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
  916. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  917. package/dist/modes/interactive/components/tree-selector.js +65 -23
  918. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  919. package/dist/modes/interactive/components/trust-selector.js +8 -2
  920. package/dist/modes/interactive/components/trust-selector.js.map +1 -1
  921. package/dist/modes/interactive/components/user-message-selector.js +6 -3
  922. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  923. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  924. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  925. package/dist/modes/interactive/components/user-message.js +12 -2
  926. package/dist/modes/interactive/components/user-message.js.map +1 -1
  927. package/dist/modes/interactive/components/visual-truncate.d.ts +27 -3
  928. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
  929. package/dist/modes/interactive/components/visual-truncate.js +39 -6
  930. package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
  931. package/dist/modes/interactive/external-editor.d.ts.map +1 -1
  932. package/dist/modes/interactive/external-editor.js +2 -1
  933. package/dist/modes/interactive/external-editor.js.map +1 -1
  934. package/dist/modes/interactive/interactive-mode.d.ts +166 -8
  935. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  936. package/dist/modes/interactive/interactive-mode.js +1690 -599
  937. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  938. package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
  939. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
  940. package/dist/modes/interactive/model-catalog-refresh.js +34 -0
  941. package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
  942. package/dist/modes/interactive/session-share.d.ts +23 -0
  943. package/dist/modes/interactive/session-share.d.ts.map +1 -0
  944. package/dist/modes/interactive/session-share.js +130 -0
  945. package/dist/modes/interactive/session-share.js.map +1 -0
  946. package/dist/modes/interactive/theme/dark.json +54 -63
  947. package/dist/modes/interactive/theme/light.json +52 -60
  948. package/dist/modes/interactive/theme/system-theme.d.ts +54 -0
  949. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -0
  950. package/dist/modes/interactive/theme/system-theme.js +535 -0
  951. package/dist/modes/interactive/theme/system-theme.js.map +1 -0
  952. package/dist/modes/interactive/theme/theme-controller.d.ts +59 -7
  953. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  954. package/dist/modes/interactive/theme/theme-controller.js +164 -51
  955. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  956. package/dist/modes/interactive/theme/theme-json.d.ts +85 -0
  957. package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
  958. package/dist/modes/interactive/theme/theme-json.js +132 -0
  959. package/dist/modes/interactive/theme/theme-json.js.map +1 -0
  960. package/dist/modes/interactive/theme/theme-schema.json +24 -3
  961. package/dist/modes/interactive/theme/theme.d.ts +80 -42
  962. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  963. package/dist/modes/interactive/theme/theme.js +274 -417
  964. package/dist/modes/interactive/theme/theme.js.map +1 -1
  965. package/dist/modes/interactive/tui-renderer.d.ts +22 -0
  966. package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
  967. package/dist/modes/interactive/tui-renderer.js +67 -0
  968. package/dist/modes/interactive/tui-renderer.js.map +1 -0
  969. package/dist/modes/json-event.d.ts +34 -0
  970. package/dist/modes/json-event.d.ts.map +1 -0
  971. package/dist/modes/json-event.js +29 -0
  972. package/dist/modes/json-event.js.map +1 -0
  973. package/dist/modes/print-mode.d.ts +1 -1
  974. package/dist/modes/print-mode.d.ts.map +1 -1
  975. package/dist/modes/print-mode.js +12 -2
  976. package/dist/modes/print-mode.js.map +1 -1
  977. package/dist/modes/rpc/rpc-client.d.ts +17 -9
  978. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  979. package/dist/modes/rpc/rpc-client.js +27 -15
  980. package/dist/modes/rpc/rpc-client.js.map +1 -1
  981. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  982. package/dist/modes/rpc/rpc-mode.js +179 -19
  983. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  984. package/dist/modes/rpc/rpc-types.d.ts +90 -2
  985. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  986. package/dist/modes/rpc/rpc-types.js.map +1 -1
  987. package/dist/package-manager-cli.d.ts +1 -0
  988. package/dist/package-manager-cli.d.ts.map +1 -1
  989. package/dist/package-manager-cli.js +217 -63
  990. package/dist/package-manager-cli.js.map +1 -1
  991. package/dist/prompts/commands/atomic-commit.md +1 -12
  992. package/dist/prompts/commands/brainstorm.md +12 -15
  993. package/dist/prompts/commands/create-verification-skill.md +108 -0
  994. package/dist/prompts/commands/discuss-phase.md +3 -14
  995. package/dist/prompts/commands/execute-phase.md +3 -11
  996. package/dist/prompts/commands/fix.md +41 -18
  997. package/dist/prompts/commands/grill.md +66 -0
  998. package/dist/prompts/commands/init-project.md +5 -15
  999. package/dist/prompts/commands/map-codebase.md +1 -13
  1000. package/dist/prompts/commands/new-project.md +5 -15
  1001. package/dist/prompts/commands/next-milestone.md +1 -13
  1002. package/dist/prompts/commands/orchestrate.md +1 -1
  1003. package/dist/prompts/commands/pause-work.md +1 -13
  1004. package/dist/prompts/commands/plan-phase.md +3 -11
  1005. package/dist/prompts/commands/progress.md +0 -13
  1006. package/dist/prompts/commands/quick.md +3 -11
  1007. package/dist/prompts/commands/resolve-conflicts.md +71 -0
  1008. package/dist/prompts/commands/resume-work.md +0 -13
  1009. package/dist/prompts/commands/review.md +6 -13
  1010. package/dist/prompts/commands/triage.md +159 -0
  1011. package/dist/prompts/commands/verify-work.md +5 -14
  1012. package/dist/prompts/commands/why.md +139 -0
  1013. package/dist/rpc-entry.js +1 -0
  1014. package/dist/rpc-entry.js.map +1 -1
  1015. package/dist/skills/atomic-reasoning/SKILL.md +115 -0
  1016. package/dist/skills/blast-radius/SKILL.md +56 -0
  1017. package/dist/skills/epistemics/SKILL.md +99 -0
  1018. package/dist/skills/explainers/SKILL.md +65 -0
  1019. package/dist/skills/hexagon-animation/SKILL.md +49 -0
  1020. package/dist/skills/hexagon-animation/generate.mjs +81 -0
  1021. package/dist/skills/hexagon-animation/template.html +361 -0
  1022. package/dist/skills/typescript-discipline/SKILL.md +50 -0
  1023. package/dist/skills/typescript-discipline/references/patterns.md +294 -0
  1024. package/dist/skills/unslop/SKILL.md +119 -0
  1025. package/dist/utils/abort.d.ts +5 -0
  1026. package/dist/utils/abort.d.ts.map +1 -0
  1027. package/dist/utils/abort.js +48 -0
  1028. package/dist/utils/abort.js.map +1 -0
  1029. package/dist/utils/canonical-path.d.ts +28 -0
  1030. package/dist/utils/canonical-path.d.ts.map +1 -0
  1031. package/dist/utils/canonical-path.js +90 -0
  1032. package/dist/utils/canonical-path.js.map +1 -0
  1033. package/dist/utils/changelog.js +1 -1
  1034. package/dist/utils/changelog.js.map +1 -1
  1035. package/dist/utils/child-process.d.ts +13 -2
  1036. package/dist/utils/child-process.d.ts.map +1 -1
  1037. package/dist/utils/child-process.js +26 -9
  1038. package/dist/utils/child-process.js.map +1 -1
  1039. package/dist/utils/clipboard-command.d.ts +7 -0
  1040. package/dist/utils/clipboard-command.d.ts.map +1 -0
  1041. package/dist/utils/clipboard-command.js +45 -0
  1042. package/dist/utils/clipboard-command.js.map +1 -0
  1043. package/dist/utils/clipboard-image.d.ts.map +1 -1
  1044. package/dist/utils/clipboard-image.js +60 -91
  1045. package/dist/utils/clipboard-image.js.map +1 -1
  1046. package/dist/utils/clipboard.d.ts +3 -1
  1047. package/dist/utils/clipboard.d.ts.map +1 -1
  1048. package/dist/utils/clipboard.js +123 -108
  1049. package/dist/utils/clipboard.js.map +1 -1
  1050. package/dist/utils/draht-user-agent.d.ts +2 -0
  1051. package/dist/utils/draht-user-agent.d.ts.map +1 -0
  1052. package/dist/utils/draht-user-agent.js +5 -0
  1053. package/dist/utils/draht-user-agent.js.map +1 -0
  1054. package/dist/utils/exif-orientation.d.ts +2 -1
  1055. package/dist/utils/exif-orientation.d.ts.map +1 -1
  1056. package/dist/utils/exif-orientation.js +2 -3
  1057. package/dist/utils/exif-orientation.js.map +1 -1
  1058. package/dist/utils/frontmatter.d.ts.map +1 -1
  1059. package/dist/utils/frontmatter.js +2 -1
  1060. package/dist/utils/frontmatter.js.map +1 -1
  1061. package/dist/utils/management-http.d.ts +25 -0
  1062. package/dist/utils/management-http.d.ts.map +1 -0
  1063. package/dist/utils/management-http.js +54 -0
  1064. package/dist/utils/management-http.js.map +1 -0
  1065. package/dist/utils/mime.js +1 -1
  1066. package/dist/utils/mime.js.map +1 -1
  1067. package/dist/utils/paths.d.ts +6 -10
  1068. package/dist/utils/paths.d.ts.map +1 -1
  1069. package/dist/utils/paths.js +23 -14
  1070. package/dist/utils/paths.js.map +1 -1
  1071. package/dist/utils/photon.d.ts +2 -1
  1072. package/dist/utils/photon.d.ts.map +1 -1
  1073. package/dist/utils/photon.js.map +1 -1
  1074. package/dist/utils/shell.d.ts +4 -3
  1075. package/dist/utils/shell.d.ts.map +1 -1
  1076. package/dist/utils/shell.js +26 -39
  1077. package/dist/utils/shell.js.map +1 -1
  1078. package/dist/utils/syntax-highlight.d.ts +1 -0
  1079. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  1080. package/dist/utils/syntax-highlight.js +62 -1
  1081. package/dist/utils/syntax-highlight.js.map +1 -1
  1082. package/dist/utils/text.d.ts +8 -0
  1083. package/dist/utils/text.d.ts.map +1 -0
  1084. package/dist/utils/text.js +9 -0
  1085. package/dist/utils/text.js.map +1 -0
  1086. package/dist/utils/tool-result-images.d.ts +21 -0
  1087. package/dist/utils/tool-result-images.d.ts.map +1 -0
  1088. package/dist/utils/tool-result-images.js +48 -0
  1089. package/dist/utils/tool-result-images.js.map +1 -0
  1090. package/dist/utils/tools-manager.d.ts +11 -1
  1091. package/dist/utils/tools-manager.d.ts.map +1 -1
  1092. package/dist/utils/tools-manager.js +56 -41
  1093. package/dist/utils/tools-manager.js.map +1 -1
  1094. package/dist/utils/version-check.d.ts +4 -1
  1095. package/dist/utils/version-check.d.ts.map +1 -1
  1096. package/dist/utils/version-check.js +30 -9
  1097. package/dist/utils/version-check.js.map +1 -1
  1098. package/dist/utils/wsl.d.ts +3 -0
  1099. package/dist/utils/wsl.d.ts.map +1 -0
  1100. package/dist/utils/wsl.js +15 -0
  1101. package/dist/utils/wsl.js.map +1 -0
  1102. package/dist/utils/zip.d.ts +7 -0
  1103. package/dist/utils/zip.d.ts.map +1 -0
  1104. package/dist/utils/zip.js +60 -0
  1105. package/dist/utils/zip.js.map +1 -0
  1106. package/docs/attachable-sessions.md +79 -0
  1107. package/docs/cli-integration.md +106 -0
  1108. package/docs/cli.md +374 -0
  1109. package/docs/compaction.md +107 -45
  1110. package/docs/configuration.md +47 -0
  1111. package/docs/containerization.md +100 -66
  1112. package/docs/custom-provider.md +109 -707
  1113. package/docs/docs.json +155 -95
  1114. package/docs/duet.md +42 -0
  1115. package/docs/environment-variables.md +30 -17
  1116. package/docs/extensions.md +169 -2811
  1117. package/docs/how-pi-works.md +53 -0
  1118. package/docs/images/interactive-mode.png +0 -0
  1119. package/docs/index.md +25 -69
  1120. package/docs/json.md +198 -57
  1121. package/docs/keybindings.md +89 -92
  1122. package/docs/llama-cpp.md +23 -8
  1123. package/docs/mcp.md +231 -0
  1124. package/docs/message-types.md +261 -0
  1125. package/docs/models.md +94 -478
  1126. package/docs/packages.md +68 -164
  1127. package/docs/prompt-templates.md +31 -68
  1128. package/docs/providers.md +118 -215
  1129. package/docs/quickstart.md +56 -109
  1130. package/docs/rpc-commands.md +860 -0
  1131. package/docs/rpc-extension-ui.md +200 -0
  1132. package/docs/rpc.md +186 -1494
  1133. package/docs/sdk.md +79 -1127
  1134. package/docs/security.md +77 -33
  1135. package/docs/session-format.md +98 -222
  1136. package/docs/sessions.md +36 -113
  1137. package/docs/settings.md +125 -251
  1138. package/docs/shell-aliases.md +85 -5
  1139. package/docs/skills.md +52 -188
  1140. package/docs/slash-commands.md +61 -0
  1141. package/docs/terminal-setup.md +132 -61
  1142. package/docs/termux.md +74 -84
  1143. package/docs/themes.md +91 -252
  1144. package/docs/tmux.md +31 -39
  1145. package/docs/tui.md +74 -891
  1146. package/docs/usage.md +54 -255
  1147. package/docs/virtual-models.md +114 -0
  1148. package/docs/windows.md +57 -7
  1149. package/examples/extensions/antigravity-image-gen.ts +9 -9
  1150. package/examples/extensions/bash-spawn-hook.ts +1 -1
  1151. package/examples/extensions/border-status-editor.ts +1 -1
  1152. package/examples/extensions/built-in-tool-renderer.ts +16 -40
  1153. package/examples/extensions/custom-compaction.ts +1 -16
  1154. package/examples/extensions/custom-provider-anthropic/index.ts +20 -13
  1155. package/examples/extensions/custom-provider-gitlab-duo/index.ts +4 -3
  1156. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  1157. package/examples/extensions/debug-provider.ts +90 -0
  1158. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  1159. package/examples/extensions/dynamic-resources/dynamic.json +3 -1
  1160. package/examples/extensions/git-checkpoint.ts +2 -2
  1161. package/examples/extensions/handoff.ts +2 -11
  1162. package/examples/extensions/jev-router.ts +113 -0
  1163. package/examples/extensions/minimal-mode.ts +24 -96
  1164. package/examples/extensions/notify.ts +3 -1
  1165. package/examples/extensions/overlay-qa-tests.ts +3 -3
  1166. package/examples/extensions/prompt-customizer.ts +19 -67
  1167. package/examples/extensions/qna.ts +3 -7
  1168. package/examples/extensions/subagent/agents.ts +40 -9
  1169. package/examples/extensions/subagent/index.ts +27 -4
  1170. package/examples/extensions/summarize.ts +7 -18
  1171. package/examples/extensions/titlebar-spinner.ts +1 -1
  1172. package/examples/rpc-client.ts +35 -0
  1173. package/examples/rpc-extension-ui.ts +38 -9
  1174. package/examples/sdk/02-custom-model.ts +1 -2
  1175. package/examples/sdk/06-extensions.ts +1 -1
  1176. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  1177. package/examples/sdk/12-full-control.ts +1 -1
  1178. package/examples/sdk/14-codemode-mcp.ts +61 -0
  1179. package/hooks/gsd/draht-quality-gate.js +3 -3
  1180. package/package.json +28 -32
  1181. package/prompts/commands/atomic-commit.md +1 -12
  1182. package/prompts/commands/brainstorm.md +12 -15
  1183. package/prompts/commands/create-verification-skill.md +108 -0
  1184. package/prompts/commands/discuss-phase.md +3 -14
  1185. package/prompts/commands/execute-phase.md +3 -11
  1186. package/prompts/commands/fix.md +41 -18
  1187. package/prompts/commands/grill.md +66 -0
  1188. package/prompts/commands/init-project.md +5 -15
  1189. package/prompts/commands/map-codebase.md +1 -13
  1190. package/prompts/commands/new-project.md +5 -15
  1191. package/prompts/commands/next-milestone.md +1 -13
  1192. package/prompts/commands/orchestrate.md +1 -1
  1193. package/prompts/commands/pause-work.md +1 -13
  1194. package/prompts/commands/plan-phase.md +3 -11
  1195. package/prompts/commands/progress.md +0 -13
  1196. package/prompts/commands/quick.md +3 -11
  1197. package/prompts/commands/resolve-conflicts.md +71 -0
  1198. package/prompts/commands/resume-work.md +0 -13
  1199. package/prompts/commands/review.md +6 -13
  1200. package/prompts/commands/triage.md +159 -0
  1201. package/prompts/commands/verify-work.md +5 -14
  1202. package/prompts/commands/why.md +139 -0
  1203. package/skills/atomic-reasoning/SKILL.md +115 -0
  1204. package/skills/blast-radius/SKILL.md +56 -0
  1205. package/skills/epistemics/SKILL.md +99 -0
  1206. package/skills/explainers/SKILL.md +65 -0
  1207. package/skills/hexagon-animation/SKILL.md +49 -0
  1208. package/skills/hexagon-animation/generate.mjs +81 -0
  1209. package/skills/hexagon-animation/template.html +361 -0
  1210. package/skills/typescript-discipline/SKILL.md +50 -0
  1211. package/skills/typescript-discipline/references/patterns.md +294 -0
  1212. package/skills/unslop/SKILL.md +119 -0
  1213. package/dist/prompts/agents/build.md +0 -86
  1214. package/dist/prompts/agents/plan.md +0 -79
  1215. package/dist/prompts/agents/verify.md +0 -69
  1216. package/dist/utils/clipboard-native.d.ts +0 -11
  1217. package/dist/utils/clipboard-native.d.ts.map +0 -1
  1218. package/dist/utils/clipboard-native.js +0 -20
  1219. package/dist/utils/clipboard-native.js.map +0 -1
  1220. package/dist/utils/pi-user-agent.d.ts +0 -2
  1221. package/dist/utils/pi-user-agent.d.ts.map +0 -1
  1222. package/dist/utils/pi-user-agent.js +0 -5
  1223. package/dist/utils/pi-user-agent.js.map +0 -1
  1224. package/docs/development.md +0 -71
  1225. package/docs/tree.md +0 -231
  1226. package/examples/extensions/kimi-deferred-tools.ts +0 -61
  1227. package/prompts/agents/build.md +0 -86
  1228. package/prompts/agents/plan.md +0 -79
  1229. package/prompts/agents/verify.md +0 -69
@@ -0,0 +1,149 @@
1
+ /**
2
+ * The `BashOperations` wrapper (R44-SBX.6).
3
+ *
4
+ * This is the only place the sandbox meets the agent's bash tool. It implements
5
+ * the existing `BashOperations` seam in `../tools/bash.ts` -- the same interface
6
+ * an SSH or container backend would implement -- so the bash tool itself needs
7
+ * no change: `createBashTool(cwd, { operations })` is the whole integration.
8
+ *
9
+ * ## Three states, and the rule that separates them
10
+ *
11
+ * | sandboxing | backend | what runs |
12
+ * |------------|------------|---------------------------------------------|
13
+ * | off | (not asked)| the wrapped local backend, untouched |
14
+ * | on | available | the command, confined by the policy |
15
+ * | on | unavailable| the wrapped local backend, announced once |
16
+ *
17
+ * **Off must be invisible.** Sandboxing off is the default and is what every
18
+ * existing session is: the wrapper forwards `command`, `cwd` and the *same
19
+ * options object* to the wrapped backend and returns its result. It does not
20
+ * resolve a policy, does not construct an env, does not so much as ask the
21
+ * executor whether it exists -- because asking runs a self-test, which spawns
22
+ * processes. The bash tool is the agent's primary limb; a wrapper that subtly
23
+ * changed its timing, its environment or its error text while claiming to be
24
+ * disabled would be a regression paid for by every user who never turned the
25
+ * sandbox on.
26
+ *
27
+ * ## Why `unavailable` falls back, when the rest of this module never does
28
+ *
29
+ * Everywhere else in `src/core/sandbox/`, "cannot confine" means "do not run".
30
+ * Here it means "run the way this product ran yesterday". That inversion is
31
+ * deliberate and is the spec's one explicit departure from Phase 28
32
+ * (`.planning/specs/2026-07-12-bash-sandbox-confinement.md`): the RLM sandbox
33
+ * exists to contain untrusted generated code, so refusing to start is the safe
34
+ * answer; the bash tool *is* the agent, so hard-failing every command on a host
35
+ * without a working backend bricks the product rather than protecting it. The
36
+ * documented posture is to fall back to the permission gate exactly as it works
37
+ * today (R45-SBM.5), which is a strictly-unchanged security posture, not a
38
+ * weakened one.
39
+ *
40
+ * What makes that safe rather than merely convenient is that the fallback is
41
+ * **loud and whole-session**:
42
+ *
43
+ * - It is announced through `onNotice` **once**, not once per command. A
44
+ * per-command warning is noise, and noise is how a security notice gets
45
+ * trained away.
46
+ * - The decision is taken from `SandboxExecutor.status()`, which is asked once
47
+ * and memoised, so a session is either sandboxed or it is not. There is no
48
+ * command-by-command drift where some commands were confined and nobody can
49
+ * say which.
50
+ * - The fallback child is the *ordinary* child: it carries no `DRAHT_SANDBOX`
51
+ * marker and gets no filtered env, so nothing downstream -- a prompt, a
52
+ * script, a future permission decision -- can mistake it for a confined one.
53
+ * The test suite asserts this by checking that an escape write actually
54
+ * *succeeds* in fallback: a fallback that happened to block it would be
55
+ * indistinguishable from confinement the session never had.
56
+ *
57
+ * ## What does *not* fall back
58
+ *
59
+ * Once the backend has reported `available`, a single invocation that cannot be
60
+ * confined -- an unrenderable policy, a cwd that no longer resolves -- is an
61
+ * error, not a fallback. It rejects with `SandboxUnavailableError`. Silently
62
+ * running that one command unconfined in an otherwise-sandboxed session is the
63
+ * exact hole this phase exists to close: the caller believes confinement holds,
64
+ * and the one command that escaped it is the one nobody was told about. Phase 45
65
+ * turns that rejection into the "rerun unsandboxed?" approval prompt, which is
66
+ * the same decision made *in the open*.
67
+ *
68
+ * ## Layering note
69
+ *
70
+ * This is the only file in `src/core/sandbox/` that imports from `../tools/`,
71
+ * which is why it is deliberately absent from `./index.ts`: the barrel stays
72
+ * usable by anything that just wants the policy model, without dragging the tool
73
+ * and render layers in behind it -- and a future `bash.ts` that wants to import
74
+ * the sandbox barrel cannot create a cycle.
75
+ */
76
+ import { type BashOperations } from "../tools/bash.ts";
77
+ import { type SandboxExecutor, type SandboxStatus } from "./executor.ts";
78
+ import { type SandboxPolicyInput } from "./policy.ts";
79
+ /** Static, or read per invocation so a `/sandbox` toggle takes effect on the next command. */
80
+ export type SandboxEnabledSource = boolean | (() => boolean);
81
+ /**
82
+ * Everything about the policy except `cwd`.
83
+ *
84
+ * `cwd` is not configurable here on purpose: the policy's project root is always
85
+ * the directory the command actually runs in, taken from the `exec` call itself.
86
+ * A separately-configured root could drift from the real working directory, and
87
+ * a write allowlist that does not contain the cwd is the kind of mismatch that
88
+ * gets "fixed" by widening the allowlist. Anything else that must be writable is
89
+ * `extraWritePaths`, which is explicit and visible.
90
+ */
91
+ export type SandboxPolicyOverrides = Omit<SandboxPolicyInput, "cwd">;
92
+ /** Static, or read per invocation so settings changes take effect without a restart. */
93
+ export type SandboxPolicySource = SandboxPolicyOverrides | (() => SandboxPolicyOverrides);
94
+ /**
95
+ * Something the caller must be able to show the user. Both kinds are emitted at
96
+ * most once per distinct fact per wrapper, never once per command.
97
+ */
98
+ export type SandboxNotice = {
99
+ readonly kind: "unavailable";
100
+ /** Backend that could not confine, for diagnostics (`"seatbelt"`, `"unavailable"`, ...). */
101
+ readonly backend: string;
102
+ readonly reason: string;
103
+ } | {
104
+ /** A configured write path was dropped from the policy. Narrowing, but never silent. */
105
+ readonly kind: "write-path-rejected";
106
+ /** The entry exactly as configured, so the user can find it in their settings. */
107
+ readonly input: string;
108
+ readonly reason: string;
109
+ };
110
+ export interface SandboxedBashOperationsOptions {
111
+ /**
112
+ * The unsandboxed backend, used when sandboxing is off or unavailable.
113
+ * Defaults to `createLocalBashOperations({ shellPath })` -- the same call the
114
+ * bash tool makes for itself, so the fallback path is not a reimplementation
115
+ * of local execution but literally the existing one.
116
+ */
117
+ operations?: BashOperations;
118
+ /** Explicit shell path from settings, forwarded to the default local backend. */
119
+ shellPath?: string;
120
+ /** Defaults to `createSandboxExecutor()` (platform backend, or an unavailable one with a reason). */
121
+ executor?: SandboxExecutor;
122
+ /** Session sandbox state. Defaults to `false`: nothing becomes sandboxed by accident. */
123
+ enabled?: SandboxEnabledSource;
124
+ /** Policy inputs other than `cwd`. */
125
+ policy?: SandboxPolicySource;
126
+ /** Where user-visible sandbox facts go. Phase 45 wires this to the UI. */
127
+ onNotice?: (notice: SandboxNotice) => void;
128
+ }
129
+ export interface SandboxedBashOperations extends BashOperations {
130
+ /** Backend identity for diagnostics. */
131
+ readonly backendName: string;
132
+ /**
133
+ * The backend's status, asked once and memoised.
134
+ *
135
+ * Answers "*can* this session sandbox?", which is a different question from
136
+ * "is sandboxing on?" -- Phase 45 needs the former to decide whether to offer
137
+ * `/sandbox on` at all. Calling it runs the R44-SBX.4 self-test, so it is not
138
+ * called implicitly while sandboxing is off.
139
+ */
140
+ sandboxStatus(): Promise<SandboxStatus>;
141
+ }
142
+ /**
143
+ * Wraps a local `BashOperations` with OS-level confinement.
144
+ *
145
+ * The returned object is a drop-in for `createLocalBashOperations()`; with
146
+ * `enabled` false (the default) it *is* that backend, one function call deeper.
147
+ */
148
+ export declare function createSandboxedBashOperations(options?: SandboxedBashOperationsOptions): SandboxedBashOperations;
149
+ //# sourceMappingURL=bash-operations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash-operations.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/bash-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AAEH,OAAO,EAAE,KAAK,cAAc,EAA6B,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,MAAM,eAAe,CAAC;AACvB,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEhG,8FAA8F;AAC9F,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAErE,wFAAwF;AACxF,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,CAAC,MAAM,sBAAsB,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,MAAM,aAAa,GACtB;IACA,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACvB,GACD;IACA,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACvB,CAAC;AAEL,MAAM,WAAW,8BAA8B;IAC9C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,yFAAyF;IACzF,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,sCAAsC;IACtC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC9D,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;;;;OAOG;IACH,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,8BAAmC,GAAG,uBAAuB,CAuFnH"}
@@ -0,0 +1,163 @@
1
+ /**
2
+ * The `BashOperations` wrapper (R44-SBX.6).
3
+ *
4
+ * This is the only place the sandbox meets the agent's bash tool. It implements
5
+ * the existing `BashOperations` seam in `../tools/bash.ts` -- the same interface
6
+ * an SSH or container backend would implement -- so the bash tool itself needs
7
+ * no change: `createBashTool(cwd, { operations })` is the whole integration.
8
+ *
9
+ * ## Three states, and the rule that separates them
10
+ *
11
+ * | sandboxing | backend | what runs |
12
+ * |------------|------------|---------------------------------------------|
13
+ * | off | (not asked)| the wrapped local backend, untouched |
14
+ * | on | available | the command, confined by the policy |
15
+ * | on | unavailable| the wrapped local backend, announced once |
16
+ *
17
+ * **Off must be invisible.** Sandboxing off is the default and is what every
18
+ * existing session is: the wrapper forwards `command`, `cwd` and the *same
19
+ * options object* to the wrapped backend and returns its result. It does not
20
+ * resolve a policy, does not construct an env, does not so much as ask the
21
+ * executor whether it exists -- because asking runs a self-test, which spawns
22
+ * processes. The bash tool is the agent's primary limb; a wrapper that subtly
23
+ * changed its timing, its environment or its error text while claiming to be
24
+ * disabled would be a regression paid for by every user who never turned the
25
+ * sandbox on.
26
+ *
27
+ * ## Why `unavailable` falls back, when the rest of this module never does
28
+ *
29
+ * Everywhere else in `src/core/sandbox/`, "cannot confine" means "do not run".
30
+ * Here it means "run the way this product ran yesterday". That inversion is
31
+ * deliberate and is the spec's one explicit departure from Phase 28
32
+ * (`.planning/specs/2026-07-12-bash-sandbox-confinement.md`): the RLM sandbox
33
+ * exists to contain untrusted generated code, so refusing to start is the safe
34
+ * answer; the bash tool *is* the agent, so hard-failing every command on a host
35
+ * without a working backend bricks the product rather than protecting it. The
36
+ * documented posture is to fall back to the permission gate exactly as it works
37
+ * today (R45-SBM.5), which is a strictly-unchanged security posture, not a
38
+ * weakened one.
39
+ *
40
+ * What makes that safe rather than merely convenient is that the fallback is
41
+ * **loud and whole-session**:
42
+ *
43
+ * - It is announced through `onNotice` **once**, not once per command. A
44
+ * per-command warning is noise, and noise is how a security notice gets
45
+ * trained away.
46
+ * - The decision is taken from `SandboxExecutor.status()`, which is asked once
47
+ * and memoised, so a session is either sandboxed or it is not. There is no
48
+ * command-by-command drift where some commands were confined and nobody can
49
+ * say which.
50
+ * - The fallback child is the *ordinary* child: it carries no `DRAHT_SANDBOX`
51
+ * marker and gets no filtered env, so nothing downstream -- a prompt, a
52
+ * script, a future permission decision -- can mistake it for a confined one.
53
+ * The test suite asserts this by checking that an escape write actually
54
+ * *succeeds* in fallback: a fallback that happened to block it would be
55
+ * indistinguishable from confinement the session never had.
56
+ *
57
+ * ## What does *not* fall back
58
+ *
59
+ * Once the backend has reported `available`, a single invocation that cannot be
60
+ * confined -- an unrenderable policy, a cwd that no longer resolves -- is an
61
+ * error, not a fallback. It rejects with `SandboxUnavailableError`. Silently
62
+ * running that one command unconfined in an otherwise-sandboxed session is the
63
+ * exact hole this phase exists to close: the caller believes confinement holds,
64
+ * and the one command that escaped it is the one nobody was told about. Phase 45
65
+ * turns that rejection into the "rerun unsandboxed?" approval prompt, which is
66
+ * the same decision made *in the open*.
67
+ *
68
+ * ## Layering note
69
+ *
70
+ * This is the only file in `src/core/sandbox/` that imports from `../tools/`,
71
+ * which is why it is deliberately absent from `./index.ts`: the barrel stays
72
+ * usable by anything that just wants the policy model, without dragging the tool
73
+ * and render layers in behind it -- and a future `bash.ts` that wants to import
74
+ * the sandbox barrel cannot create a cycle.
75
+ */
76
+ import { createLocalBashOperations } from "../tools/bash.js";
77
+ import { createSandboxExecutor, SandboxUnavailableError, } from "./executor.js";
78
+ import { resolveSandboxPolicy } from "./policy.js";
79
+ /**
80
+ * Wraps a local `BashOperations` with OS-level confinement.
81
+ *
82
+ * The returned object is a drop-in for `createLocalBashOperations()`; with
83
+ * `enabled` false (the default) it *is* that backend, one function call deeper.
84
+ */
85
+ export function createSandboxedBashOperations(options = {}) {
86
+ const fallback = options.operations ?? createLocalBashOperations({ shellPath: options.shellPath });
87
+ const executor = options.executor ?? createSandboxExecutor();
88
+ const enabledSource = options.enabled ?? false;
89
+ const policySource = options.policy ?? {};
90
+ const onNotice = options.onNotice;
91
+ const isEnabled = () => (typeof enabledSource === "function" ? enabledSource() : enabledSource);
92
+ let unavailableAnnounced = false;
93
+ const announcedRejections = new Set();
94
+ const announceUnavailable = (reason) => {
95
+ if (unavailableAnnounced)
96
+ return;
97
+ unavailableAnnounced = true;
98
+ onNotice?.({ kind: "unavailable", backend: executor.name, reason });
99
+ };
100
+ const announceRejection = (input, reason) => {
101
+ const key = JSON.stringify([input, reason]);
102
+ if (announcedRejections.has(key))
103
+ return;
104
+ announcedRejections.add(key);
105
+ onNotice?.({ kind: "write-path-rejected", input, reason });
106
+ };
107
+ let statusPromise;
108
+ const sandboxStatus = () => {
109
+ // `Promise.resolve().then(...)` rather than a bare call: `status()` is
110
+ // documented never to throw, but a caller-supplied executor is not bound by
111
+ // our documentation, and a synchronous throw here would escape as an
112
+ // exception from the *bash tool* rather than as "we could not confine".
113
+ statusPromise ??= Promise.resolve()
114
+ .then(() => executor.status())
115
+ .catch((err) => ({
116
+ available: false,
117
+ reason: `sandbox backend ${JSON.stringify(executor.name)} could not report its status: ${err instanceof Error ? err.message : String(err)}`,
118
+ }));
119
+ return statusPromise;
120
+ };
121
+ /**
122
+ * Resolved fresh for every invocation, not cached by cwd.
123
+ *
124
+ * Real-path resolution is a claim about the filesystem *now*: a directory in
125
+ * the allowlist can be replaced by a symlink between two commands in the same
126
+ * session, and a policy cached from before that swap would authorise a path
127
+ * that no longer means what it meant. It matches the backends, which
128
+ * regenerate their profile per invocation for the same reason. Phase 46 owns
129
+ * the spawn-overhead budget and can revisit this with numbers.
130
+ */
131
+ const policyFor = (cwd) => {
132
+ const overrides = typeof policySource === "function" ? policySource() : policySource;
133
+ let resolution;
134
+ try {
135
+ resolution = resolveSandboxPolicy({ ...overrides, cwd });
136
+ }
137
+ catch (err) {
138
+ // The policy is what confinement *is*. Not being able to build one is not
139
+ // a reason to run without one.
140
+ throw new SandboxUnavailableError(`cannot resolve a sandbox policy for ${JSON.stringify(cwd)}: ${err instanceof Error ? err.message : String(err)}`);
141
+ }
142
+ for (const rejection of resolution.rejected)
143
+ announceRejection(rejection.input, rejection.reason);
144
+ return resolution.policy;
145
+ };
146
+ return {
147
+ backendName: executor.name,
148
+ sandboxStatus,
149
+ exec: async (command, cwd, execOptions) => {
150
+ // Sandboxing off: hand the call straight through. Same arguments, same
151
+ // options object, same promise -- nothing to diverge from.
152
+ if (!isEnabled())
153
+ return fallback.exec(command, cwd, execOptions);
154
+ const status = await sandboxStatus();
155
+ if (!status.available) {
156
+ announceUnavailable(status.reason);
157
+ return fallback.exec(command, cwd, execOptions);
158
+ }
159
+ return executor.exec(command, cwd, policyFor(cwd), execOptions);
160
+ },
161
+ };
162
+ }
163
+ //# sourceMappingURL=bash-operations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash-operations.js","sourceRoot":"","sources":["../../../src/core/sandbox/bash-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AAEH,OAAO,EAAuB,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EACN,qBAAqB,EAGrB,uBAAuB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAA+C,MAAM,aAAa,CAAC;AAyEhG;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAO,GAAmC,EAAE;IACzF,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,IAAI,yBAAyB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,EAAE,CAAC;IAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,CAAC,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEzG,IAAI,oBAAoB,GAAG,KAAK,CAAC;IACjC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9C,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAQ,EAAE;QACpD,IAAI,oBAAoB;YAAE,OAAO;QACjC,oBAAoB,GAAG,IAAI,CAAC;QAC5B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAE,MAAc,EAAQ,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QACzC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC;IAEF,IAAI,aAAiD,CAAC;IACtD,MAAM,aAAa,GAAG,GAA2B,EAAE;QAClD,uEAAuE;QACvE,4EAA4E;QAC5E,qEAAqE;QACrE,wEAAwE;QACxE,aAAa,KAAK,OAAO,CAAC,OAAO,EAAE;aACjC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;aAC7B,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAChB,SAAS,EAAE,KAAc;YACzB,MAAM,EAAE,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,iCACvD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAChD,EAAE;SACF,CAAC,CAAC,CAAC;QACL,OAAO,aAAa,CAAC;IACtB,CAAC,CAAC;IAEF;;;;;;;;;OASG;IACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAiB,EAAE;QAChD,MAAM,SAAS,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;QACrF,IAAI,UAAmD,CAAC;QACxD,IAAI,CAAC;YACJ,UAAU,GAAG,oBAAoB,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,0EAA0E;YAC1E,+BAA+B;YAC/B,MAAM,IAAI,uBAAuB,CAChC,uCAAuC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KACzD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAChD,EAAE,CACF,CAAC;QACH,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,QAAQ;YAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAClG,OAAO,UAAU,CAAC,MAAM,CAAC;IAC1B,CAAC,CAAC;IAEF,OAAO;QACN,WAAW,EAAE,QAAQ,CAAC,IAAI;QAC1B,aAAa;QACb,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;YACzC,uEAAuE;YACvE,2DAA2D;YAC3D,IAAI,CAAC,SAAS,EAAE;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;YAElE,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvB,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["/**\n * The `BashOperations` wrapper (R44-SBX.6).\n *\n * This is the only place the sandbox meets the agent's bash tool. It implements\n * the existing `BashOperations` seam in `../tools/bash.ts` -- the same interface\n * an SSH or container backend would implement -- so the bash tool itself needs\n * no change: `createBashTool(cwd, { operations })` is the whole integration.\n *\n * ## Three states, and the rule that separates them\n *\n * | sandboxing | backend | what runs |\n * |------------|------------|---------------------------------------------|\n * | off | (not asked)| the wrapped local backend, untouched |\n * | on | available | the command, confined by the policy |\n * | on | unavailable| the wrapped local backend, announced once |\n *\n * **Off must be invisible.** Sandboxing off is the default and is what every\n * existing session is: the wrapper forwards `command`, `cwd` and the *same\n * options object* to the wrapped backend and returns its result. It does not\n * resolve a policy, does not construct an env, does not so much as ask the\n * executor whether it exists -- because asking runs a self-test, which spawns\n * processes. The bash tool is the agent's primary limb; a wrapper that subtly\n * changed its timing, its environment or its error text while claiming to be\n * disabled would be a regression paid for by every user who never turned the\n * sandbox on.\n *\n * ## Why `unavailable` falls back, when the rest of this module never does\n *\n * Everywhere else in `src/core/sandbox/`, \"cannot confine\" means \"do not run\".\n * Here it means \"run the way this product ran yesterday\". That inversion is\n * deliberate and is the spec's one explicit departure from Phase 28\n * (`.planning/specs/2026-07-12-bash-sandbox-confinement.md`): the RLM sandbox\n * exists to contain untrusted generated code, so refusing to start is the safe\n * answer; the bash tool *is* the agent, so hard-failing every command on a host\n * without a working backend bricks the product rather than protecting it. The\n * documented posture is to fall back to the permission gate exactly as it works\n * today (R45-SBM.5), which is a strictly-unchanged security posture, not a\n * weakened one.\n *\n * What makes that safe rather than merely convenient is that the fallback is\n * **loud and whole-session**:\n *\n * - It is announced through `onNotice` **once**, not once per command. A\n * per-command warning is noise, and noise is how a security notice gets\n * trained away.\n * - The decision is taken from `SandboxExecutor.status()`, which is asked once\n * and memoised, so a session is either sandboxed or it is not. There is no\n * command-by-command drift where some commands were confined and nobody can\n * say which.\n * - The fallback child is the *ordinary* child: it carries no `DRAHT_SANDBOX`\n * marker and gets no filtered env, so nothing downstream -- a prompt, a\n * script, a future permission decision -- can mistake it for a confined one.\n * The test suite asserts this by checking that an escape write actually\n * *succeeds* in fallback: a fallback that happened to block it would be\n * indistinguishable from confinement the session never had.\n *\n * ## What does *not* fall back\n *\n * Once the backend has reported `available`, a single invocation that cannot be\n * confined -- an unrenderable policy, a cwd that no longer resolves -- is an\n * error, not a fallback. It rejects with `SandboxUnavailableError`. Silently\n * running that one command unconfined in an otherwise-sandboxed session is the\n * exact hole this phase exists to close: the caller believes confinement holds,\n * and the one command that escaped it is the one nobody was told about. Phase 45\n * turns that rejection into the \"rerun unsandboxed?\" approval prompt, which is\n * the same decision made *in the open*.\n *\n * ## Layering note\n *\n * This is the only file in `src/core/sandbox/` that imports from `../tools/`,\n * which is why it is deliberately absent from `./index.ts`: the barrel stays\n * usable by anything that just wants the policy model, without dragging the tool\n * and render layers in behind it -- and a future `bash.ts` that wants to import\n * the sandbox barrel cannot create a cycle.\n */\n\nimport { type BashOperations, createLocalBashOperations } from \"../tools/bash.ts\";\nimport {\n\tcreateSandboxExecutor,\n\ttype SandboxExecutor,\n\ttype SandboxStatus,\n\tSandboxUnavailableError,\n} from \"./executor.ts\";\nimport { resolveSandboxPolicy, type SandboxPolicy, type SandboxPolicyInput } from \"./policy.ts\";\n\n/** Static, or read per invocation so a `/sandbox` toggle takes effect on the next command. */\nexport type SandboxEnabledSource = boolean | (() => boolean);\n\n/**\n * Everything about the policy except `cwd`.\n *\n * `cwd` is not configurable here on purpose: the policy's project root is always\n * the directory the command actually runs in, taken from the `exec` call itself.\n * A separately-configured root could drift from the real working directory, and\n * a write allowlist that does not contain the cwd is the kind of mismatch that\n * gets \"fixed\" by widening the allowlist. Anything else that must be writable is\n * `extraWritePaths`, which is explicit and visible.\n */\nexport type SandboxPolicyOverrides = Omit<SandboxPolicyInput, \"cwd\">;\n\n/** Static, or read per invocation so settings changes take effect without a restart. */\nexport type SandboxPolicySource = SandboxPolicyOverrides | (() => SandboxPolicyOverrides);\n\n/**\n * Something the caller must be able to show the user. Both kinds are emitted at\n * most once per distinct fact per wrapper, never once per command.\n */\nexport type SandboxNotice =\n\t| {\n\t\t\treadonly kind: \"unavailable\";\n\t\t\t/** Backend that could not confine, for diagnostics (`\"seatbelt\"`, `\"unavailable\"`, ...). */\n\t\t\treadonly backend: string;\n\t\t\treadonly reason: string;\n\t }\n\t| {\n\t\t\t/** A configured write path was dropped from the policy. Narrowing, but never silent. */\n\t\t\treadonly kind: \"write-path-rejected\";\n\t\t\t/** The entry exactly as configured, so the user can find it in their settings. */\n\t\t\treadonly input: string;\n\t\t\treadonly reason: string;\n\t };\n\nexport interface SandboxedBashOperationsOptions {\n\t/**\n\t * The unsandboxed backend, used when sandboxing is off or unavailable.\n\t * Defaults to `createLocalBashOperations({ shellPath })` -- the same call the\n\t * bash tool makes for itself, so the fallback path is not a reimplementation\n\t * of local execution but literally the existing one.\n\t */\n\toperations?: BashOperations;\n\t/** Explicit shell path from settings, forwarded to the default local backend. */\n\tshellPath?: string;\n\t/** Defaults to `createSandboxExecutor()` (platform backend, or an unavailable one with a reason). */\n\texecutor?: SandboxExecutor;\n\t/** Session sandbox state. Defaults to `false`: nothing becomes sandboxed by accident. */\n\tenabled?: SandboxEnabledSource;\n\t/** Policy inputs other than `cwd`. */\n\tpolicy?: SandboxPolicySource;\n\t/** Where user-visible sandbox facts go. Phase 45 wires this to the UI. */\n\tonNotice?: (notice: SandboxNotice) => void;\n}\n\nexport interface SandboxedBashOperations extends BashOperations {\n\t/** Backend identity for diagnostics. */\n\treadonly backendName: string;\n\t/**\n\t * The backend's status, asked once and memoised.\n\t *\n\t * Answers \"*can* this session sandbox?\", which is a different question from\n\t * \"is sandboxing on?\" -- Phase 45 needs the former to decide whether to offer\n\t * `/sandbox on` at all. Calling it runs the R44-SBX.4 self-test, so it is not\n\t * called implicitly while sandboxing is off.\n\t */\n\tsandboxStatus(): Promise<SandboxStatus>;\n}\n\n/**\n * Wraps a local `BashOperations` with OS-level confinement.\n *\n * The returned object is a drop-in for `createLocalBashOperations()`; with\n * `enabled` false (the default) it *is* that backend, one function call deeper.\n */\nexport function createSandboxedBashOperations(options: SandboxedBashOperationsOptions = {}): SandboxedBashOperations {\n\tconst fallback = options.operations ?? createLocalBashOperations({ shellPath: options.shellPath });\n\tconst executor = options.executor ?? createSandboxExecutor();\n\tconst enabledSource = options.enabled ?? false;\n\tconst policySource = options.policy ?? {};\n\tconst onNotice = options.onNotice;\n\n\tconst isEnabled = (): boolean => (typeof enabledSource === \"function\" ? enabledSource() : enabledSource);\n\n\tlet unavailableAnnounced = false;\n\tconst announcedRejections = new Set<string>();\n\n\tconst announceUnavailable = (reason: string): void => {\n\t\tif (unavailableAnnounced) return;\n\t\tunavailableAnnounced = true;\n\t\tonNotice?.({ kind: \"unavailable\", backend: executor.name, reason });\n\t};\n\n\tconst announceRejection = (input: string, reason: string): void => {\n\t\tconst key = JSON.stringify([input, reason]);\n\t\tif (announcedRejections.has(key)) return;\n\t\tannouncedRejections.add(key);\n\t\tonNotice?.({ kind: \"write-path-rejected\", input, reason });\n\t};\n\n\tlet statusPromise: Promise<SandboxStatus> | undefined;\n\tconst sandboxStatus = (): Promise<SandboxStatus> => {\n\t\t// `Promise.resolve().then(...)` rather than a bare call: `status()` is\n\t\t// documented never to throw, but a caller-supplied executor is not bound by\n\t\t// our documentation, and a synchronous throw here would escape as an\n\t\t// exception from the *bash tool* rather than as \"we could not confine\".\n\t\tstatusPromise ??= Promise.resolve()\n\t\t\t.then(() => executor.status())\n\t\t\t.catch((err) => ({\n\t\t\t\tavailable: false as const,\n\t\t\t\treason: `sandbox backend ${JSON.stringify(executor.name)} could not report its status: ${\n\t\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t\t}`,\n\t\t\t}));\n\t\treturn statusPromise;\n\t};\n\n\t/**\n\t * Resolved fresh for every invocation, not cached by cwd.\n\t *\n\t * Real-path resolution is a claim about the filesystem *now*: a directory in\n\t * the allowlist can be replaced by a symlink between two commands in the same\n\t * session, and a policy cached from before that swap would authorise a path\n\t * that no longer means what it meant. It matches the backends, which\n\t * regenerate their profile per invocation for the same reason. Phase 46 owns\n\t * the spawn-overhead budget and can revisit this with numbers.\n\t */\n\tconst policyFor = (cwd: string): SandboxPolicy => {\n\t\tconst overrides = typeof policySource === \"function\" ? policySource() : policySource;\n\t\tlet resolution: ReturnType<typeof resolveSandboxPolicy>;\n\t\ttry {\n\t\t\tresolution = resolveSandboxPolicy({ ...overrides, cwd });\n\t\t} catch (err) {\n\t\t\t// The policy is what confinement *is*. Not being able to build one is not\n\t\t\t// a reason to run without one.\n\t\t\tthrow new SandboxUnavailableError(\n\t\t\t\t`cannot resolve a sandbox policy for ${JSON.stringify(cwd)}: ${\n\t\t\t\t\terr instanceof Error ? err.message : String(err)\n\t\t\t\t}`,\n\t\t\t);\n\t\t}\n\t\tfor (const rejection of resolution.rejected) announceRejection(rejection.input, rejection.reason);\n\t\treturn resolution.policy;\n\t};\n\n\treturn {\n\t\tbackendName: executor.name,\n\t\tsandboxStatus,\n\t\texec: async (command, cwd, execOptions) => {\n\t\t\t// Sandboxing off: hand the call straight through. Same arguments, same\n\t\t\t// options object, same promise -- nothing to diverge from.\n\t\t\tif (!isEnabled()) return fallback.exec(command, cwd, execOptions);\n\n\t\t\tconst status = await sandboxStatus();\n\t\t\tif (!status.available) {\n\t\t\t\tannounceUnavailable(status.reason);\n\t\t\t\treturn fallback.exec(command, cwd, execOptions);\n\t\t\t}\n\n\t\t\treturn executor.exec(command, cwd, policyFor(cwd), execOptions);\n\t\t},\n\t};\n}\n"]}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Environment hygiene for the sandboxed child (R44-SBX.5).
3
+ *
4
+ * The child gets a **constructed** environment, never `{ ...process.env }` and
5
+ * never the caller's env object passed straight through. The caller's env is
6
+ * treated as a *source of values*; the allowlist below is the *gate*.
7
+ *
8
+ * ## Why an allowlist and not a denylist
9
+ *
10
+ * A denylist has to enumerate every secret-bearing variable that exists, which
11
+ * is unbounded and grows with every tool a user installs -- `ANTHROPIC_API_KEY`,
12
+ * `AWS_SECRET_ACCESS_KEY`, `GH_TOKEN`, `NPM_TOKEN`, `OP_SERVICE_ACCOUNT_TOKEN`,
13
+ * whatever tomorrow ships. Getting a denylist wrong leaks a credential; getting
14
+ * an allowlist wrong breaks a build, loudly, and the user tells us. Only one of
15
+ * those two failure modes is recoverable.
16
+ *
17
+ * This matters *more* here than it did in Phase 28, not less. Phase 28's RLM
18
+ * sandbox denies network outright, so a leaked key could at worst be written
19
+ * into the session workdir. The bash sandbox's network is **on by default**
20
+ * (R44-SBX.2 -- dev workflows need `npm install` and `git fetch`), so a variable
21
+ * that reaches the child is a variable that can leave the machine. The write
22
+ * allowlist bounds what a command can *destroy*; only this list bounds what it
23
+ * can *disclose*.
24
+ *
25
+ * ## What is on the list, and why
26
+ *
27
+ * Everything here is either (a) needed to make a shell and a toolchain behave
28
+ * like the user's own shell -- `PATH`, `HOME`, `SHELL`, `TMPDIR`, locale, `TERM`
29
+ * -- or (b) a `DRAHT_*` session variable the bash tool sets deliberately for
30
+ * user scripts to read (see `resolveSpawnContext` in `../tools/bash.ts`), none
31
+ * of which carry credentials.
32
+ *
33
+ * Deliberately **absent**, and worth stating because each is a thing somebody
34
+ * will eventually ask for:
35
+ *
36
+ * - `SSH_AUTH_SOCK` / `GPG_AGENT_INFO` -- handles to an agent holding live
37
+ * private keys. Forwarding one lets anything in the sandbox sign and
38
+ * authenticate as the user; the filesystem allowlist does not bound that at
39
+ * all. `git push` over SSH therefore does not work inside the sandbox, which
40
+ * is the correct default (the spec keeps outward-facing operations prompting
41
+ * in Phase 45 anyway).
42
+ * - `*_TOKEN`, `*_API_KEY`, `AWS_*`, `NPM_TOKEN`, ... -- the whole point.
43
+ * - `NODE_OPTIONS`, `BASH_ENV`, `ENV`, `LD_PRELOAD`, `DYLD_INSERT_LIBRARIES` --
44
+ * these inject code into the child before its first line runs. They are not
45
+ * secrets, they are execution vectors, and inheriting them silently would let
46
+ * the *parent's* configuration decide what the sandboxed shell actually does.
47
+ *
48
+ * A project that genuinely needs one of these passes it through
49
+ * `extraAllowedNames` (Phase 45 wires that to settings) -- an explicit, visible,
50
+ * per-project decision rather than an accident of inheritance.
51
+ */
52
+ /** Set in every sandboxed child, so scripts and prompts can detect confinement. */
53
+ export declare const SANDBOX_ENV_MARKER = "DRAHT_SANDBOX";
54
+ /**
55
+ * The only variable names that may reach a sandboxed child by default.
56
+ * See the module doc for the reasoning and for what is deliberately missing.
57
+ */
58
+ export declare const SANDBOX_ENV_ALLOWLIST: readonly string[];
59
+ export interface BuildSandboxEnvOptions {
60
+ /**
61
+ * Where values are read from. Defaults to `process.env`. The bash tool passes
62
+ * its own prepared env here; passing it does **not** widen what is exported,
63
+ * it only changes the values the allowlist picks up.
64
+ */
65
+ source?: NodeJS.ProcessEnv;
66
+ /** Additional names to admit, from project settings. Explicit by construction. */
67
+ extraAllowedNames?: readonly string[];
68
+ /**
69
+ * Values forced after filtering, regardless of the source. Used for variables
70
+ * the sandbox itself decides (a `TMPDIR` that is inside the write allowlist,
71
+ * for instance).
72
+ */
73
+ overrides?: NodeJS.ProcessEnv;
74
+ }
75
+ /**
76
+ * Builds the child environment from the allowlist.
77
+ *
78
+ * A name absent from the source stays absent from the result -- the function
79
+ * never invents a default, because a fabricated `HOME` or `PATH` is a behaviour
80
+ * difference that would be blamed on the sandbox rather than on the caller.
81
+ */
82
+ export declare function buildSandboxEnv(options?: BuildSandboxEnvOptions): NodeJS.ProcessEnv;
83
+ //# sourceMappingURL=env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAuCjD,CAAC;AAEH,MAAM,WAAW,sBAAsB;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC3B,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,CAAC,UAAU,CAevF"}
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Environment hygiene for the sandboxed child (R44-SBX.5).
3
+ *
4
+ * The child gets a **constructed** environment, never `{ ...process.env }` and
5
+ * never the caller's env object passed straight through. The caller's env is
6
+ * treated as a *source of values*; the allowlist below is the *gate*.
7
+ *
8
+ * ## Why an allowlist and not a denylist
9
+ *
10
+ * A denylist has to enumerate every secret-bearing variable that exists, which
11
+ * is unbounded and grows with every tool a user installs -- `ANTHROPIC_API_KEY`,
12
+ * `AWS_SECRET_ACCESS_KEY`, `GH_TOKEN`, `NPM_TOKEN`, `OP_SERVICE_ACCOUNT_TOKEN`,
13
+ * whatever tomorrow ships. Getting a denylist wrong leaks a credential; getting
14
+ * an allowlist wrong breaks a build, loudly, and the user tells us. Only one of
15
+ * those two failure modes is recoverable.
16
+ *
17
+ * This matters *more* here than it did in Phase 28, not less. Phase 28's RLM
18
+ * sandbox denies network outright, so a leaked key could at worst be written
19
+ * into the session workdir. The bash sandbox's network is **on by default**
20
+ * (R44-SBX.2 -- dev workflows need `npm install` and `git fetch`), so a variable
21
+ * that reaches the child is a variable that can leave the machine. The write
22
+ * allowlist bounds what a command can *destroy*; only this list bounds what it
23
+ * can *disclose*.
24
+ *
25
+ * ## What is on the list, and why
26
+ *
27
+ * Everything here is either (a) needed to make a shell and a toolchain behave
28
+ * like the user's own shell -- `PATH`, `HOME`, `SHELL`, `TMPDIR`, locale, `TERM`
29
+ * -- or (b) a `DRAHT_*` session variable the bash tool sets deliberately for
30
+ * user scripts to read (see `resolveSpawnContext` in `../tools/bash.ts`), none
31
+ * of which carry credentials.
32
+ *
33
+ * Deliberately **absent**, and worth stating because each is a thing somebody
34
+ * will eventually ask for:
35
+ *
36
+ * - `SSH_AUTH_SOCK` / `GPG_AGENT_INFO` -- handles to an agent holding live
37
+ * private keys. Forwarding one lets anything in the sandbox sign and
38
+ * authenticate as the user; the filesystem allowlist does not bound that at
39
+ * all. `git push` over SSH therefore does not work inside the sandbox, which
40
+ * is the correct default (the spec keeps outward-facing operations prompting
41
+ * in Phase 45 anyway).
42
+ * - `*_TOKEN`, `*_API_KEY`, `AWS_*`, `NPM_TOKEN`, ... -- the whole point.
43
+ * - `NODE_OPTIONS`, `BASH_ENV`, `ENV`, `LD_PRELOAD`, `DYLD_INSERT_LIBRARIES` --
44
+ * these inject code into the child before its first line runs. They are not
45
+ * secrets, they are execution vectors, and inheriting them silently would let
46
+ * the *parent's* configuration decide what the sandboxed shell actually does.
47
+ *
48
+ * A project that genuinely needs one of these passes it through
49
+ * `extraAllowedNames` (Phase 45 wires that to settings) -- an explicit, visible,
50
+ * per-project decision rather than an accident of inheritance.
51
+ */
52
+ /** Set in every sandboxed child, so scripts and prompts can detect confinement. */
53
+ export const SANDBOX_ENV_MARKER = "DRAHT_SANDBOX";
54
+ /**
55
+ * The only variable names that may reach a sandboxed child by default.
56
+ * See the module doc for the reasoning and for what is deliberately missing.
57
+ */
58
+ export const SANDBOX_ENV_ALLOWLIST = Object.freeze([
59
+ // Shell and toolchain basics.
60
+ "PATH",
61
+ "HOME",
62
+ "SHELL",
63
+ "USER",
64
+ "LOGNAME",
65
+ // Kept deliberately: the unsandboxed backend inherits it too, and bash
66
+ // overrides a stale value against the real cwd (verified). Dropping it would
67
+ // make `$PWD` report the physical path where the unsandboxed shell reports
68
+ // the logical one -- a gratuitous behaviour difference, not a safety gain.
69
+ "PWD",
70
+ "TMPDIR",
71
+ "TMP",
72
+ "TEMP",
73
+ // Terminal presentation. Without these, tools that colourise or wrap output
74
+ // behave differently inside the sandbox than outside it, which reads as the
75
+ // sandbox "breaking" things it did not break.
76
+ "TERM",
77
+ "COLORTERM",
78
+ "COLUMNS",
79
+ "LINES",
80
+ // Locale. Absent these, some toolchains fall back to ASCII and mangle output.
81
+ "LANG",
82
+ "LANGUAGE",
83
+ "LC_ALL",
84
+ "LC_COLLATE",
85
+ "LC_CTYPE",
86
+ "LC_MESSAGES",
87
+ "LC_MONETARY",
88
+ "LC_NUMERIC",
89
+ "LC_TIME",
90
+ "TZ",
91
+ // Session metadata the bash tool sets on purpose for user scripts.
92
+ "DRAHT_SESSION_ID",
93
+ "DRAHT_SESSION_FILE",
94
+ "DRAHT_PROVIDER",
95
+ "DRAHT_MODEL",
96
+ "DRAHT_REASONING_LEVEL",
97
+ ]);
98
+ /**
99
+ * Builds the child environment from the allowlist.
100
+ *
101
+ * A name absent from the source stays absent from the result -- the function
102
+ * never invents a default, because a fabricated `HOME` or `PATH` is a behaviour
103
+ * difference that would be blamed on the sandbox rather than on the caller.
104
+ */
105
+ export function buildSandboxEnv(options = {}) {
106
+ const source = options.source ?? process.env;
107
+ const allowed = new Set(SANDBOX_ENV_ALLOWLIST);
108
+ for (const name of options.extraAllowedNames ?? [])
109
+ allowed.add(name);
110
+ const env = {};
111
+ for (const name of allowed) {
112
+ const value = source[name];
113
+ if (value !== undefined)
114
+ env[name] = value;
115
+ }
116
+ for (const [name, value] of Object.entries(options.overrides ?? {})) {
117
+ if (value !== undefined)
118
+ env[name] = value;
119
+ }
120
+ env[SANDBOX_ENV_MARKER] = "1";
121
+ return env;
122
+ }
123
+ //# sourceMappingURL=env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/core/sandbox/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB,MAAM,CAAC,MAAM,CAAC;IACrE,8BAA8B;IAC9B,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,SAAS;IACT,uEAAuE;IACvE,6EAA6E;IAC7E,2EAA2E;IAC3E,2EAA2E;IAC3E,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,4EAA4E;IAC5E,4EAA4E;IAC5E,8CAA8C;IAC9C,MAAM;IACN,WAAW;IACX,SAAS;IACT,OAAO;IACP,8EAA8E;IAC9E,MAAM;IACN,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,aAAa;IACb,aAAa;IACb,YAAY;IACZ,SAAS;IACT,IAAI;IACJ,mEAAmE;IACnE,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAChB,aAAa;IACb,uBAAuB;CACvB,CAAC,CAAC;AAmBH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAA2B,EAAE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,iBAAiB,IAAI,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEtE,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC5C,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC5C,CAAC;IACD,GAAG,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC;IAC9B,OAAO,GAAG,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Environment hygiene for the sandboxed child (R44-SBX.5).\n *\n * The child gets a **constructed** environment, never `{ ...process.env }` and\n * never the caller's env object passed straight through. The caller's env is\n * treated as a *source of values*; the allowlist below is the *gate*.\n *\n * ## Why an allowlist and not a denylist\n *\n * A denylist has to enumerate every secret-bearing variable that exists, which\n * is unbounded and grows with every tool a user installs -- `ANTHROPIC_API_KEY`,\n * `AWS_SECRET_ACCESS_KEY`, `GH_TOKEN`, `NPM_TOKEN`, `OP_SERVICE_ACCOUNT_TOKEN`,\n * whatever tomorrow ships. Getting a denylist wrong leaks a credential; getting\n * an allowlist wrong breaks a build, loudly, and the user tells us. Only one of\n * those two failure modes is recoverable.\n *\n * This matters *more* here than it did in Phase 28, not less. Phase 28's RLM\n * sandbox denies network outright, so a leaked key could at worst be written\n * into the session workdir. The bash sandbox's network is **on by default**\n * (R44-SBX.2 -- dev workflows need `npm install` and `git fetch`), so a variable\n * that reaches the child is a variable that can leave the machine. The write\n * allowlist bounds what a command can *destroy*; only this list bounds what it\n * can *disclose*.\n *\n * ## What is on the list, and why\n *\n * Everything here is either (a) needed to make a shell and a toolchain behave\n * like the user's own shell -- `PATH`, `HOME`, `SHELL`, `TMPDIR`, locale, `TERM`\n * -- or (b) a `DRAHT_*` session variable the bash tool sets deliberately for\n * user scripts to read (see `resolveSpawnContext` in `../tools/bash.ts`), none\n * of which carry credentials.\n *\n * Deliberately **absent**, and worth stating because each is a thing somebody\n * will eventually ask for:\n *\n * - `SSH_AUTH_SOCK` / `GPG_AGENT_INFO` -- handles to an agent holding live\n * private keys. Forwarding one lets anything in the sandbox sign and\n * authenticate as the user; the filesystem allowlist does not bound that at\n * all. `git push` over SSH therefore does not work inside the sandbox, which\n * is the correct default (the spec keeps outward-facing operations prompting\n * in Phase 45 anyway).\n * - `*_TOKEN`, `*_API_KEY`, `AWS_*`, `NPM_TOKEN`, ... -- the whole point.\n * - `NODE_OPTIONS`, `BASH_ENV`, `ENV`, `LD_PRELOAD`, `DYLD_INSERT_LIBRARIES` --\n * these inject code into the child before its first line runs. They are not\n * secrets, they are execution vectors, and inheriting them silently would let\n * the *parent's* configuration decide what the sandboxed shell actually does.\n *\n * A project that genuinely needs one of these passes it through\n * `extraAllowedNames` (Phase 45 wires that to settings) -- an explicit, visible,\n * per-project decision rather than an accident of inheritance.\n */\n\n/** Set in every sandboxed child, so scripts and prompts can detect confinement. */\nexport const SANDBOX_ENV_MARKER = \"DRAHT_SANDBOX\";\n\n/**\n * The only variable names that may reach a sandboxed child by default.\n * See the module doc for the reasoning and for what is deliberately missing.\n */\nexport const SANDBOX_ENV_ALLOWLIST: readonly string[] = Object.freeze([\n\t// Shell and toolchain basics.\n\t\"PATH\",\n\t\"HOME\",\n\t\"SHELL\",\n\t\"USER\",\n\t\"LOGNAME\",\n\t// Kept deliberately: the unsandboxed backend inherits it too, and bash\n\t// overrides a stale value against the real cwd (verified). Dropping it would\n\t// make `$PWD` report the physical path where the unsandboxed shell reports\n\t// the logical one -- a gratuitous behaviour difference, not a safety gain.\n\t\"PWD\",\n\t\"TMPDIR\",\n\t\"TMP\",\n\t\"TEMP\",\n\t// Terminal presentation. Without these, tools that colourise or wrap output\n\t// behave differently inside the sandbox than outside it, which reads as the\n\t// sandbox \"breaking\" things it did not break.\n\t\"TERM\",\n\t\"COLORTERM\",\n\t\"COLUMNS\",\n\t\"LINES\",\n\t// Locale. Absent these, some toolchains fall back to ASCII and mangle output.\n\t\"LANG\",\n\t\"LANGUAGE\",\n\t\"LC_ALL\",\n\t\"LC_COLLATE\",\n\t\"LC_CTYPE\",\n\t\"LC_MESSAGES\",\n\t\"LC_MONETARY\",\n\t\"LC_NUMERIC\",\n\t\"LC_TIME\",\n\t\"TZ\",\n\t// Session metadata the bash tool sets on purpose for user scripts.\n\t\"DRAHT_SESSION_ID\",\n\t\"DRAHT_SESSION_FILE\",\n\t\"DRAHT_PROVIDER\",\n\t\"DRAHT_MODEL\",\n\t\"DRAHT_REASONING_LEVEL\",\n]);\n\nexport interface BuildSandboxEnvOptions {\n\t/**\n\t * Where values are read from. Defaults to `process.env`. The bash tool passes\n\t * its own prepared env here; passing it does **not** widen what is exported,\n\t * it only changes the values the allowlist picks up.\n\t */\n\tsource?: NodeJS.ProcessEnv;\n\t/** Additional names to admit, from project settings. Explicit by construction. */\n\textraAllowedNames?: readonly string[];\n\t/**\n\t * Values forced after filtering, regardless of the source. Used for variables\n\t * the sandbox itself decides (a `TMPDIR` that is inside the write allowlist,\n\t * for instance).\n\t */\n\toverrides?: NodeJS.ProcessEnv;\n}\n\n/**\n * Builds the child environment from the allowlist.\n *\n * A name absent from the source stays absent from the result -- the function\n * never invents a default, because a fabricated `HOME` or `PATH` is a behaviour\n * difference that would be blamed on the sandbox rather than on the caller.\n */\nexport function buildSandboxEnv(options: BuildSandboxEnvOptions = {}): NodeJS.ProcessEnv {\n\tconst source = options.source ?? process.env;\n\tconst allowed = new Set<string>(SANDBOX_ENV_ALLOWLIST);\n\tfor (const name of options.extraAllowedNames ?? []) allowed.add(name);\n\n\tconst env: NodeJS.ProcessEnv = {};\n\tfor (const name of allowed) {\n\t\tconst value = source[name];\n\t\tif (value !== undefined) env[name] = value;\n\t}\n\tfor (const [name, value] of Object.entries(options.overrides ?? {})) {\n\t\tif (value !== undefined) env[name] = value;\n\t}\n\tenv[SANDBOX_ENV_MARKER] = \"1\";\n\treturn env;\n}\n"]}