@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,95 @@
1
+ /**
2
+ * SBPL (Seatbelt) profile generation from a `SandboxPolicy` (R44-SBX.1, macOS).
3
+ *
4
+ * Pure string building, deliberately separated from the backend that spawns
5
+ * `sandbox-exec`, so the exact bytes handed to the kernel are directly testable
6
+ * and diffable without running anything.
7
+ *
8
+ * ## The profile is an allow-list. It used to be a deny-list, and that was a bug
9
+ *
10
+ * Phase 44 shipped `(allow default)` plus targeted denies, on the argument that
11
+ * "an enumerable allowlist of everything a compiler touches does not exist". The
12
+ * argument is wrong, and two independent reviews proved it wrong with working
13
+ * escapes. A deny-list sandbox grants every capability nobody thought to
14
+ * enumerate, and on macOS the capabilities nobody enumerated included:
15
+ *
16
+ * - **`mach-lookup` to LaunchServices.** `open -a Calculator` inside the sandbox
17
+ * made launchd start Calculator *outside* it. Reproduced: an app bundle whose
18
+ * executable wrote to a path outside the write allowlist, launched via `open`,
19
+ * and the file appeared. The write allowlist and the network toggle are both
20
+ * irrelevant once you can ask launchd to run a program for you.
21
+ * - **`mach-priv-task-port`.** `lldb -p <pid>` inside the sandbox attached to an
22
+ * unsandboxed same-uid process and ran `expr (int)system("echo ... > outside")`
23
+ * in it. Reproduced with the network off.
24
+ * - **Unix-domain sockets.** A sandboxed process connected to the socket of an
25
+ * already-running unsandboxed daemon and injected a payload into it.
26
+ * - **Every pty on the machine**, via `(regex #"^/dev/ttys[0-9]*$")`, so a
27
+ * confined process could write a fake prompt into an unrelated terminal.
28
+ *
29
+ * So the shape is now the one Phase 28 used for the RLM REPL
30
+ * (`packages/rlm/sandbox/macos.sb`):
31
+ *
32
+ * (deny default) ; nothing, unless named below
33
+ * (allow <one capability at a time>) ; each with a reason it is here
34
+ * (deny <the escape routes>) ; restating intent where it matters
35
+ *
36
+ * The enumeration turned out to be small: **thirteen** capability allows, plus a
37
+ * network section of five, cover `bash`, `python3`, `node`, `git`, `npm`, `make`,
38
+ * `clang`, `curl`, `tar`, `sqlite3`, `openssl`, python `venv` and
39
+ * `multiprocessing`, node worker threads, and local HTTP servers. Each one below
40
+ * is here because a specific command failed without it, and the comment says
41
+ * which. Nothing is here "to be safe".
42
+ *
43
+ * ## Rules for changing this file
44
+ *
45
+ * 1. An allow needs a one-sentence justification naming what breaks without it.
46
+ * 2. Reach for the narrowest filter that works -- `(global-name "...")` over a
47
+ * bare `(allow mach-lookup)`, a `(literal "...")` over a `(subpath "...")`.
48
+ * 3. Verify the narrowing, do not assume it. `com.apple.system.notification_center`
49
+ * was in an earlier draft of this list and is not here now, because testing
50
+ * showed `com.apple.system.opendirectoryd.libinfo` alone was sufficient.
51
+ * 4. Every capability an escape used gets an explicit `(deny ...)` even though
52
+ * `(deny default)` already covers it, so the next reader can see the intent
53
+ * rather than having to re-derive it from an absence.
54
+ *
55
+ * ## Properties verified empirically on macOS 26.5 (darwin 25.5), not assumed
56
+ *
57
+ * - A write outside the allowlist fails with `EPERM`, whether spelled directly,
58
+ * reached through a symlink whose *link* sits inside an allowed directory, or
59
+ * performed by an interpreter. Seatbelt checks the resolved vnode, so the
60
+ * symlink case needs no rule of its own.
61
+ * - `(deny network*)` blocks a loopback TCP connect (`EPERM`, not a refused
62
+ * connection), which is what makes the R44-SBX.4 network probe meaningful.
63
+ * - **Privilege escalation is impossible by construction**: exec of a setuid
64
+ * binary is refused for *any* sandboxed process, so `sudo` fails at exec time
65
+ * regardless of the rules below. The explicit denies are a statement of intent.
66
+ * - A sandboxed process cannot re-enter `sandbox-exec` with a looser profile:
67
+ * the nested `sandbox_apply` fails with `EPERM`. Profiles compose by
68
+ * intersection and are inherited across `exec`.
69
+ *
70
+ * ## Untrusted strings in a profile
71
+ *
72
+ * `writePaths` can contain user-configured directories (`extraWritePaths` from
73
+ * settings). A path containing `"` would close the SBPL string literal early and
74
+ * let the rest of the path be parsed as profile source -- `(allow default)`
75
+ * smuggled in through a directory name. Backslash and quote are escaped;
76
+ * anything that cannot be represented at all (control characters, newlines)
77
+ * makes generation **throw**, which the backend turns into `unavailable`. A path
78
+ * we cannot render exactly is never rendered approximately.
79
+ */
80
+ import type { SandboxPolicy } from "./policy.ts";
81
+ /** Thrown when a policy cannot be rendered into a profile exactly. Backends turn this into `unavailable`. */
82
+ export declare class SandboxProfileError extends Error {
83
+ constructor(message: string);
84
+ }
85
+ /**
86
+ * Renders `value` as an SBPL string literal.
87
+ *
88
+ * Escapes what SBPL can escape and refuses what it cannot, rather than dropping
89
+ * or substituting characters -- a path rendered as something other than itself
90
+ * is a policy that does not match the policy that was reviewed.
91
+ */
92
+ export declare function quoteSbplString(value: string): string;
93
+ /** Generates the SBPL profile text for `policy`. Deterministic: same policy, same bytes. */
94
+ export declare function buildSeatbeltProfile(policy: SandboxPolicy): string;
95
+ //# sourceMappingURL=seatbelt-profile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seatbelt-profile.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/seatbelt-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,6GAA6G;AAC7G,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAyCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAarD;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA0KlE"}
@@ -0,0 +1,239 @@
1
+ /**
2
+ * SBPL (Seatbelt) profile generation from a `SandboxPolicy` (R44-SBX.1, macOS).
3
+ *
4
+ * Pure string building, deliberately separated from the backend that spawns
5
+ * `sandbox-exec`, so the exact bytes handed to the kernel are directly testable
6
+ * and diffable without running anything.
7
+ *
8
+ * ## The profile is an allow-list. It used to be a deny-list, and that was a bug
9
+ *
10
+ * Phase 44 shipped `(allow default)` plus targeted denies, on the argument that
11
+ * "an enumerable allowlist of everything a compiler touches does not exist". The
12
+ * argument is wrong, and two independent reviews proved it wrong with working
13
+ * escapes. A deny-list sandbox grants every capability nobody thought to
14
+ * enumerate, and on macOS the capabilities nobody enumerated included:
15
+ *
16
+ * - **`mach-lookup` to LaunchServices.** `open -a Calculator` inside the sandbox
17
+ * made launchd start Calculator *outside* it. Reproduced: an app bundle whose
18
+ * executable wrote to a path outside the write allowlist, launched via `open`,
19
+ * and the file appeared. The write allowlist and the network toggle are both
20
+ * irrelevant once you can ask launchd to run a program for you.
21
+ * - **`mach-priv-task-port`.** `lldb -p <pid>` inside the sandbox attached to an
22
+ * unsandboxed same-uid process and ran `expr (int)system("echo ... > outside")`
23
+ * in it. Reproduced with the network off.
24
+ * - **Unix-domain sockets.** A sandboxed process connected to the socket of an
25
+ * already-running unsandboxed daemon and injected a payload into it.
26
+ * - **Every pty on the machine**, via `(regex #"^/dev/ttys[0-9]*$")`, so a
27
+ * confined process could write a fake prompt into an unrelated terminal.
28
+ *
29
+ * So the shape is now the one Phase 28 used for the RLM REPL
30
+ * (`packages/rlm/sandbox/macos.sb`):
31
+ *
32
+ * (deny default) ; nothing, unless named below
33
+ * (allow <one capability at a time>) ; each with a reason it is here
34
+ * (deny <the escape routes>) ; restating intent where it matters
35
+ *
36
+ * The enumeration turned out to be small: **thirteen** capability allows, plus a
37
+ * network section of five, cover `bash`, `python3`, `node`, `git`, `npm`, `make`,
38
+ * `clang`, `curl`, `tar`, `sqlite3`, `openssl`, python `venv` and
39
+ * `multiprocessing`, node worker threads, and local HTTP servers. Each one below
40
+ * is here because a specific command failed without it, and the comment says
41
+ * which. Nothing is here "to be safe".
42
+ *
43
+ * ## Rules for changing this file
44
+ *
45
+ * 1. An allow needs a one-sentence justification naming what breaks without it.
46
+ * 2. Reach for the narrowest filter that works -- `(global-name "...")` over a
47
+ * bare `(allow mach-lookup)`, a `(literal "...")` over a `(subpath "...")`.
48
+ * 3. Verify the narrowing, do not assume it. `com.apple.system.notification_center`
49
+ * was in an earlier draft of this list and is not here now, because testing
50
+ * showed `com.apple.system.opendirectoryd.libinfo` alone was sufficient.
51
+ * 4. Every capability an escape used gets an explicit `(deny ...)` even though
52
+ * `(deny default)` already covers it, so the next reader can see the intent
53
+ * rather than having to re-derive it from an absence.
54
+ *
55
+ * ## Properties verified empirically on macOS 26.5 (darwin 25.5), not assumed
56
+ *
57
+ * - A write outside the allowlist fails with `EPERM`, whether spelled directly,
58
+ * reached through a symlink whose *link* sits inside an allowed directory, or
59
+ * performed by an interpreter. Seatbelt checks the resolved vnode, so the
60
+ * symlink case needs no rule of its own.
61
+ * - `(deny network*)` blocks a loopback TCP connect (`EPERM`, not a refused
62
+ * connection), which is what makes the R44-SBX.4 network probe meaningful.
63
+ * - **Privilege escalation is impossible by construction**: exec of a setuid
64
+ * binary is refused for *any* sandboxed process, so `sudo` fails at exec time
65
+ * regardless of the rules below. The explicit denies are a statement of intent.
66
+ * - A sandboxed process cannot re-enter `sandbox-exec` with a looser profile:
67
+ * the nested `sandbox_apply` fails with `EPERM`. Profiles compose by
68
+ * intersection and are inherited across `exec`.
69
+ *
70
+ * ## Untrusted strings in a profile
71
+ *
72
+ * `writePaths` can contain user-configured directories (`extraWritePaths` from
73
+ * settings). A path containing `"` would close the SBPL string literal early and
74
+ * let the rest of the path be parsed as profile source -- `(allow default)`
75
+ * smuggled in through a directory name. Backslash and quote are escaped;
76
+ * anything that cannot be represented at all (control characters, newlines)
77
+ * makes generation **throw**, which the backend turns into `unavailable`. A path
78
+ * we cannot render exactly is never rendered approximately.
79
+ */
80
+ /** Thrown when a policy cannot be rendered into a profile exactly. Backends turn this into `unavailable`. */
81
+ export class SandboxProfileError extends Error {
82
+ constructor(message) {
83
+ super(message);
84
+ this.name = "SandboxProfileError";
85
+ }
86
+ }
87
+ /**
88
+ * Device nodes a shell and its children need to write to in order to behave at
89
+ * all: `/dev/null` redirects, `/dev/fd` process substitution, pty allocation.
90
+ * None of these is filesystem persistence, so allowing them does not widen what
91
+ * the policy is about.
92
+ *
93
+ * `/dev/tty` is the per-process alias for the *controlling* terminal, so it can
94
+ * only ever reach the child's own terminal -- unlike the machine-wide
95
+ * `/dev/ttys*` regex this list used to carry, which is now the extension-gated
96
+ * pty rule in `buildSeatbeltProfile`.
97
+ */
98
+ const DEVICE_WRITE_RULES = [
99
+ '(literal "/dev/null")',
100
+ '(literal "/dev/zero")',
101
+ '(literal "/dev/random")',
102
+ '(literal "/dev/urandom")',
103
+ '(literal "/dev/stdin")',
104
+ '(literal "/dev/stdout")',
105
+ '(literal "/dev/stderr")',
106
+ '(literal "/dev/tty")',
107
+ '(literal "/dev/ptmx")',
108
+ '(subpath "/dev/fd")',
109
+ ];
110
+ /**
111
+ * Binaries whose entire purpose is to acquire another user's privileges. Denying
112
+ * exec of them states the invariant in the profile itself; the kernel's refusal
113
+ * to exec setuid binaries inside any sandbox is what actually enforces it.
114
+ */
115
+ const PRIVILEGE_ESCALATION_BINARIES = ["/usr/bin/sudo", "/usr/bin/su", "/usr/bin/sudoedit", "/usr/bin/login"];
116
+ /**
117
+ * The system resolver's socket. `getaddrinfo` on macOS reaches mDNSResponder
118
+ * through this unix socket, so without it every hostname fails to resolve even
119
+ * with IP networking fully allowed (measured: `curl` reports
120
+ * "Could not resolve host", `node` reports `ENOTFOUND`).
121
+ */
122
+ const DNS_RESOLVER_SOCKET = "/private/var/run/mDNSResponder";
123
+ /**
124
+ * Renders `value` as an SBPL string literal.
125
+ *
126
+ * Escapes what SBPL can escape and refuses what it cannot, rather than dropping
127
+ * or substituting characters -- a path rendered as something other than itself
128
+ * is a policy that does not match the policy that was reviewed.
129
+ */
130
+ export function quoteSbplString(value) {
131
+ for (const char of value) {
132
+ const code = char.codePointAt(0) ?? 0;
133
+ if (code < 0x20 || code === 0x7f) {
134
+ throw new SandboxProfileError(`cannot render path ${JSON.stringify(value)} into a sandbox profile: it contains a control character (U+${code
135
+ .toString(16)
136
+ .padStart(4, "0")
137
+ .toUpperCase()}) that SBPL string literals cannot represent`);
138
+ }
139
+ }
140
+ return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
141
+ }
142
+ /** Generates the SBPL profile text for `policy`. Deterministic: same policy, same bytes. */
143
+ export function buildSeatbeltProfile(policy) {
144
+ if (policy.writePaths.length === 0) {
145
+ // Every backend needs somewhere to write (the shell's own tmp, at minimum),
146
+ // and an empty allowlist almost always means policy resolution silently
147
+ // dropped everything. Refusing surfaces that as `unavailable`.
148
+ throw new SandboxProfileError("cannot render a sandbox profile: the write allowlist is empty");
149
+ }
150
+ for (const path of policy.writePaths) {
151
+ if (path === "/") {
152
+ throw new SandboxProfileError("cannot render a sandbox profile: the write allowlist contains the filesystem root, which would confine nothing");
153
+ }
154
+ }
155
+ const writeSubpaths = policy.writePaths.map((path) => `(subpath ${quoteSbplString(path)})`).join(" ");
156
+ const lines = [
157
+ "(version 1)",
158
+ "",
159
+ ";; Generated from SandboxPolicy v1 by src/core/sandbox/seatbelt-profile.ts.",
160
+ ";; Do not edit by hand. Every allow below names the thing that breaks without it.",
161
+ "",
162
+ ";; ---------------------------------------------------------------------------",
163
+ ";; Deny by default. A capability nobody enumerated is a capability nobody",
164
+ ";; reviewed; the previous `(allow default)` shape left launchd, the debugger",
165
+ ";; interface and unix sockets open, each of which is a complete escape.",
166
+ ";; ---------------------------------------------------------------------------",
167
+ "(deny default)",
168
+ "",
169
+ ";; --- what running a developer command actually requires -------------------",
170
+ "",
171
+ ";; Running arbitrary binaries is the bash tool's entire purpose; confinement",
172
+ ";; here is over what those binaries may write and reach, not over which of",
173
+ ";; them exist. (Without it nothing runs at all: even `/bin/sh` fails to exec.)",
174
+ "(allow process-exec*)",
175
+ "",
176
+ ";; Every pipeline, subshell, `$(...)` and parallel build forks.",
177
+ "(allow process-fork)",
178
+ "",
179
+ ";; R44-SBX.2: v1 is read allow-all. Dev workflows read toolchains, caches and",
180
+ ";; dotfiles constantly, and a read-deny list is a v2 concern.",
181
+ "(allow file-read*)",
182
+ "",
183
+ ";; The policy: only these subtrees are writable. Seatbelt matches the resolved",
184
+ ";; vnode, so a symlink pointing out of one of these does not widen it.",
185
+ `(allow file-write* ${writeSubpaths})`,
186
+ "",
187
+ ";; Device nodes a shell needs to function. Not filesystem persistence.",
188
+ `(allow file-write* ${DEVICE_WRITE_RULES.join(" ")})`,
189
+ "",
190
+ ";; A pty the process allocates for itself (`script`, `node-pty`, `python -m pty`,",
191
+ ";; anything that wants a tty for a child). `pseudo-tty` issues the sandbox",
192
+ ";; extension that the following rule requires, so this grants the child *its",
193
+ ';; own* terminal and no other: the machine-wide `(regex #"^/dev/ttys[0-9]*$")`',
194
+ ";; this replaces let a confined process write a forged prompt into somebody",
195
+ ";; else's terminal. Idiom taken from Apple's own application.sb.",
196
+ "(allow pseudo-tty)",
197
+ '(allow file-read* file-write* (require-all (regex #"^/dev/ttys[0-9]*$") (extension "com.apple.sandbox.pty")))',
198
+ "",
199
+ ";; `isatty`, terminal size, and the termios calls every interactive-ish tool",
200
+ ";; makes on descriptors it has already opened.",
201
+ "(allow file-ioctl)",
202
+ "",
203
+ ";; `hw.ncpu`, `kern.osversion` and friends: node, python and make read these",
204
+ ";; during startup (`os.cpus()`, `sysctl -n hw.ncpu`, `uname -a`).",
205
+ "(allow sysctl-read)",
206
+ "",
207
+ ";; Job control over the command's own process tree -- `kill %1`, `make` killing",
208
+ ";; a stuck child, `trap`. `(target same-sandbox)` stops there: without the",
209
+ ";; filter a confined command can SIGKILL the agent that launched it (verified:",
210
+ ";; it could, under the old profile).",
211
+ "(allow signal (target same-sandbox))",
212
+ "",
213
+ ";; POSIX semaphores: `multiprocessing.Pool` fails with EPERM in `sem_unlink`",
214
+ ";; without this, which takes out most parallel Python.",
215
+ "(allow ipc-posix-sem)",
216
+ "",
217
+ ";; POSIX shared memory: `multiprocessing.shared_memory` and the data-science",
218
+ ";; stacks layered on it. A memory-object namespace -- no filesystem, exec or",
219
+ ";; network reach comes with it.",
220
+ "(allow ipc-posix-shm)",
221
+ "",
222
+ ";; User and group lookup (`getpwuid`). Without it `id -un` and `whoami` print",
223
+ ";; a bare uid, `os.userInfo()` throws ENOENT, and git cannot name an author.",
224
+ ";; One service, by name: a bare `(allow mach-lookup)` is what put LaunchServices",
225
+ ";; -- and therefore launchd -- back in reach.",
226
+ '(allow mach-lookup (global-name "com.apple.system.opendirectoryd.libinfo"))',
227
+ "",
228
+ ];
229
+ if (policy.network === "on") {
230
+ lines.push(";; --- network on ------------------------------------------------------------", "", ";; IP only, in both directions, plus binding a local port for a dev server.", "(allow network-outbound (remote ip))", "(allow network-inbound (local ip))", "(allow network-bind (local ip))", "", ";; The system resolver's socket, named exactly, or nothing resolves.", `(allow network-outbound (literal ${quoteSbplString(DNS_RESOLVER_SOCKET)}))`, "", ";; Unix-domain sockets, confined to the write allowlist: a command may run", ";; its own helper daemon inside its own writable area, and a directory it", ";; can already write into is one it could already plant a socket in -- so", ";; this grants nothing the write allowlist did not already grant. Sockets", ";; anywhere else -- docker.sock, a tmux or screen server, an emacs server --", ";; belong to *unsandboxed* daemons that execute what they are told, and", ";; reaching one is a full escape (verified: a confined process injected a", ";; payload into a listening daemon this way).", `(allow network-outbound network-bind ${writeSubpaths})`, "");
231
+ }
232
+ else {
233
+ lines.push(";; --- network off -----------------------------------------------------------", "", ";; Outbound, inbound, bind, and unix-domain sockets: the toggle means *no", ";; sockets*, not merely no IP. A loopback connect fails with EPERM rather", ";; than being refused, which is what the R44-SBX.4 self-test distinguishes.", "(deny network*)", "");
234
+ }
235
+ lines.push(";; --- escape routes, denied explicitly -------------------------------------", ";; `(deny default)` already covers every rule in this block. They are written", ";; out anyway so that the next person to widen an allow above can see what the", ";; widening must not reach.", "", ";; task_for_pid / ptrace-style attach. A confined command could otherwise take", ";; the task port of any same-uid process -- including the agent itself -- and", ";; execute code inside it (verified: `lldb -p` did exactly that, network off).", "(deny mach-priv-task-port)", "(deny mach-priv-host-port)", ";; Even a task *name* port hands out another process's address-space metadata.", "(deny mach-task-name)", ";; Reading other processes' state. Scoped to `others` deliberately: an", ";; unscoped `(deny process-info*)` also blocks a process inspecting itself,", ";; which aborts curl and anything else that calls `proc_pidinfo` on self.", ";; Known consequence: `pgrep` and other whole-machine process enumeration", ";; stop working inside the sandbox. `lsof -p $$` and a command's own job", ";; control still do. (`ps` was already refused -- it is setuid.)", "(deny process-info* (target others))", "", ";; Asking launchd or LaunchServices to start a process for us. That process", ";; would run *outside* this sandbox, which defeats the write allowlist and the", ";; network toggle at once (verified: `open -a` launched an app that then wrote", ";; outside the allowlist). `appleevent-send` is the same escape one hop over:", ";; scripting an already-running unsandboxed app into running a shell command.", "(deny job-creation)", "(deny lsopen)", "(deny appleevent-send)", "", ";; Authorization Services is the other way to ask the system for privileges.", "(deny authorization-right-obtain)", "", ";; No privilege escalation (R44-SBX.2). The kernel already refuses to exec a", ";; setuid binary from inside any sandbox -- verified: sudo fails EPERM even", ";; under a bare `(allow default)` profile -- and profiles are inherited across", ";; exec and cannot be loosened by re-entering sandbox-exec. These denies state", ";; the invariant explicitly; they are not what enforces it.", "(deny file-write-setugid)", `(deny process-exec* ${PRIVILEGE_ESCALATION_BINARIES.map((bin) => `(literal ${quoteSbplString(bin)})`).join(" ")})`);
236
+ lines.push("");
237
+ return lines.join("\n");
238
+ }
239
+ //# sourceMappingURL=seatbelt-profile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seatbelt-profile.js","sourceRoot":"","sources":["../../../src/core/sandbox/seatbelt-profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAIH,6GAA6G;AAC7G,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG;IAC1B,uBAAuB;IACvB,uBAAuB;IACvB,yBAAyB;IACzB,0BAA0B;IAC1B,wBAAwB;IACxB,yBAAyB;IACzB,yBAAyB;IACzB,sBAAsB;IACtB,uBAAuB;IACvB,qBAAqB;CACZ,CAAC;AAEX;;;;GAIG;AACH,MAAM,6BAA6B,GAAG,CAAC,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,CAAU,CAAC;AAEvH;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,mBAAmB,CAC5B,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,+DAA+D,IAAI;iBAC5G,QAAQ,CAAC,EAAE,CAAC;iBACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;iBAChB,WAAW,EAAE,8CAA8C,CAC7D,CAAC;QACH,CAAC;IACF,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AACjE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACzD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,4EAA4E;QAC5E,wEAAwE;QACxE,+DAA+D;QAC/D,MAAM,IAAI,mBAAmB,CAAC,+DAA+D,CAAC,CAAC;IAChG,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,mBAAmB,CAC5B,gHAAgH,CAChH,CAAC;QACH,CAAC;IACF,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEtG,MAAM,KAAK,GAAa;QACvB,aAAa;QACb,EAAE;QACF,6EAA6E;QAC7E,mFAAmF;QACnF,EAAE;QACF,gFAAgF;QAChF,2EAA2E;QAC3E,8EAA8E;QAC9E,yEAAyE;QACzE,gFAAgF;QAChF,gBAAgB;QAChB,EAAE;QACF,+EAA+E;QAC/E,EAAE;QACF,8EAA8E;QAC9E,4EAA4E;QAC5E,gFAAgF;QAChF,uBAAuB;QACvB,EAAE;QACF,iEAAiE;QACjE,sBAAsB;QACtB,EAAE;QACF,+EAA+E;QAC/E,+DAA+D;QAC/D,oBAAoB;QACpB,EAAE;QACF,gFAAgF;QAChF,wEAAwE;QACxE,sBAAsB,aAAa,GAAG;QACtC,EAAE;QACF,wEAAwE;QACxE,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;QACrD,EAAE;QACF,mFAAmF;QACnF,4EAA4E;QAC5E,8EAA8E;QAC9E,gFAAgF;QAChF,6EAA6E;QAC7E,kEAAkE;QAClE,oBAAoB;QACpB,+GAA+G;QAC/G,EAAE;QACF,8EAA8E;QAC9E,gDAAgD;QAChD,oBAAoB;QACpB,EAAE;QACF,8EAA8E;QAC9E,mEAAmE;QACnE,qBAAqB;QACrB,EAAE;QACF,iFAAiF;QACjF,4EAA4E;QAC5E,gFAAgF;QAChF,sCAAsC;QACtC,sCAAsC;QACtC,EAAE;QACF,8EAA8E;QAC9E,wDAAwD;QACxD,uBAAuB;QACvB,EAAE;QACF,8EAA8E;QAC9E,8EAA8E;QAC9E,iCAAiC;QACjC,uBAAuB;QACvB,EAAE;QACF,+EAA+E;QAC/E,8EAA8E;QAC9E,kFAAkF;QAClF,+CAA+C;QAC/C,6EAA6E;QAC7E,EAAE;KACF,CAAC;IAEF,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACT,gFAAgF,EAChF,EAAE,EACF,6EAA6E,EAC7E,sCAAsC,EACtC,oCAAoC,EACpC,iCAAiC,EACjC,EAAE,EACF,sEAAsE,EACtE,oCAAoC,eAAe,CAAC,mBAAmB,CAAC,IAAI,EAC5E,EAAE,EACF,4EAA4E,EAC5E,2EAA2E,EAC3E,2EAA2E,EAC3E,2EAA2E,EAC3E,8EAA8E,EAC9E,yEAAyE,EACzE,2EAA2E,EAC3E,+CAA+C,EAC/C,wCAAwC,aAAa,GAAG,EACxD,EAAE,CACF,CAAC;IACH,CAAC;SAAM,CAAC;QACP,KAAK,CAAC,IAAI,CACT,gFAAgF,EAChF,EAAE,EACF,2EAA2E,EAC3E,2EAA2E,EAC3E,6EAA6E,EAC7E,iBAAiB,EACjB,EAAE,CACF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACT,+EAA+E,EAC/E,+EAA+E,EAC/E,gFAAgF,EAChF,6BAA6B,EAC7B,EAAE,EACF,gFAAgF,EAChF,+EAA+E,EAC/E,gFAAgF,EAChF,4BAA4B,EAC5B,4BAA4B,EAC5B,gFAAgF,EAChF,uBAAuB,EACvB,wEAAwE,EACxE,6EAA6E,EAC7E,2EAA2E,EAC3E,2EAA2E,EAC3E,0EAA0E,EAC1E,kEAAkE,EAClE,sCAAsC,EACtC,EAAE,EACF,6EAA6E,EAC7E,gFAAgF,EAChF,gFAAgF,EAChF,+EAA+E,EAC/E,+EAA+E,EAC/E,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EACxB,EAAE,EACF,8EAA8E,EAC9E,mCAAmC,EACnC,EAAE,EACF,8EAA8E,EAC9E,6EAA6E,EAC7E,gFAAgF,EAChF,gFAAgF,EAChF,6DAA6D,EAC7D,2BAA2B,EAC3B,uBAAuB,6BAA6B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACnH,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC","sourcesContent":["/**\n * SBPL (Seatbelt) profile generation from a `SandboxPolicy` (R44-SBX.1, macOS).\n *\n * Pure string building, deliberately separated from the backend that spawns\n * `sandbox-exec`, so the exact bytes handed to the kernel are directly testable\n * and diffable without running anything.\n *\n * ## The profile is an allow-list. It used to be a deny-list, and that was a bug\n *\n * Phase 44 shipped `(allow default)` plus targeted denies, on the argument that\n * \"an enumerable allowlist of everything a compiler touches does not exist\". The\n * argument is wrong, and two independent reviews proved it wrong with working\n * escapes. A deny-list sandbox grants every capability nobody thought to\n * enumerate, and on macOS the capabilities nobody enumerated included:\n *\n * - **`mach-lookup` to LaunchServices.** `open -a Calculator` inside the sandbox\n * made launchd start Calculator *outside* it. Reproduced: an app bundle whose\n * executable wrote to a path outside the write allowlist, launched via `open`,\n * and the file appeared. The write allowlist and the network toggle are both\n * irrelevant once you can ask launchd to run a program for you.\n * - **`mach-priv-task-port`.** `lldb -p <pid>` inside the sandbox attached to an\n * unsandboxed same-uid process and ran `expr (int)system(\"echo ... > outside\")`\n * in it. Reproduced with the network off.\n * - **Unix-domain sockets.** A sandboxed process connected to the socket of an\n * already-running unsandboxed daemon and injected a payload into it.\n * - **Every pty on the machine**, via `(regex #\"^/dev/ttys[0-9]*$\")`, so a\n * confined process could write a fake prompt into an unrelated terminal.\n *\n * So the shape is now the one Phase 28 used for the RLM REPL\n * (`packages/rlm/sandbox/macos.sb`):\n *\n * (deny default) ; nothing, unless named below\n * (allow <one capability at a time>) ; each with a reason it is here\n * (deny <the escape routes>) ; restating intent where it matters\n *\n * The enumeration turned out to be small: **thirteen** capability allows, plus a\n * network section of five, cover `bash`, `python3`, `node`, `git`, `npm`, `make`,\n * `clang`, `curl`, `tar`, `sqlite3`, `openssl`, python `venv` and\n * `multiprocessing`, node worker threads, and local HTTP servers. Each one below\n * is here because a specific command failed without it, and the comment says\n * which. Nothing is here \"to be safe\".\n *\n * ## Rules for changing this file\n *\n * 1. An allow needs a one-sentence justification naming what breaks without it.\n * 2. Reach for the narrowest filter that works -- `(global-name \"...\")` over a\n * bare `(allow mach-lookup)`, a `(literal \"...\")` over a `(subpath \"...\")`.\n * 3. Verify the narrowing, do not assume it. `com.apple.system.notification_center`\n * was in an earlier draft of this list and is not here now, because testing\n * showed `com.apple.system.opendirectoryd.libinfo` alone was sufficient.\n * 4. Every capability an escape used gets an explicit `(deny ...)` even though\n * `(deny default)` already covers it, so the next reader can see the intent\n * rather than having to re-derive it from an absence.\n *\n * ## Properties verified empirically on macOS 26.5 (darwin 25.5), not assumed\n *\n * - A write outside the allowlist fails with `EPERM`, whether spelled directly,\n * reached through a symlink whose *link* sits inside an allowed directory, or\n * performed by an interpreter. Seatbelt checks the resolved vnode, so the\n * symlink case needs no rule of its own.\n * - `(deny network*)` blocks a loopback TCP connect (`EPERM`, not a refused\n * connection), which is what makes the R44-SBX.4 network probe meaningful.\n * - **Privilege escalation is impossible by construction**: exec of a setuid\n * binary is refused for *any* sandboxed process, so `sudo` fails at exec time\n * regardless of the rules below. The explicit denies are a statement of intent.\n * - A sandboxed process cannot re-enter `sandbox-exec` with a looser profile:\n * the nested `sandbox_apply` fails with `EPERM`. Profiles compose by\n * intersection and are inherited across `exec`.\n *\n * ## Untrusted strings in a profile\n *\n * `writePaths` can contain user-configured directories (`extraWritePaths` from\n * settings). A path containing `\"` would close the SBPL string literal early and\n * let the rest of the path be parsed as profile source -- `(allow default)`\n * smuggled in through a directory name. Backslash and quote are escaped;\n * anything that cannot be represented at all (control characters, newlines)\n * makes generation **throw**, which the backend turns into `unavailable`. A path\n * we cannot render exactly is never rendered approximately.\n */\n\nimport type { SandboxPolicy } from \"./policy.ts\";\n\n/** Thrown when a policy cannot be rendered into a profile exactly. Backends turn this into `unavailable`. */\nexport class SandboxProfileError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"SandboxProfileError\";\n\t}\n}\n\n/**\n * Device nodes a shell and its children need to write to in order to behave at\n * all: `/dev/null` redirects, `/dev/fd` process substitution, pty allocation.\n * None of these is filesystem persistence, so allowing them does not widen what\n * the policy is about.\n *\n * `/dev/tty` is the per-process alias for the *controlling* terminal, so it can\n * only ever reach the child's own terminal -- unlike the machine-wide\n * `/dev/ttys*` regex this list used to carry, which is now the extension-gated\n * pty rule in `buildSeatbeltProfile`.\n */\nconst DEVICE_WRITE_RULES = [\n\t'(literal \"/dev/null\")',\n\t'(literal \"/dev/zero\")',\n\t'(literal \"/dev/random\")',\n\t'(literal \"/dev/urandom\")',\n\t'(literal \"/dev/stdin\")',\n\t'(literal \"/dev/stdout\")',\n\t'(literal \"/dev/stderr\")',\n\t'(literal \"/dev/tty\")',\n\t'(literal \"/dev/ptmx\")',\n\t'(subpath \"/dev/fd\")',\n] as const;\n\n/**\n * Binaries whose entire purpose is to acquire another user's privileges. Denying\n * exec of them states the invariant in the profile itself; the kernel's refusal\n * to exec setuid binaries inside any sandbox is what actually enforces it.\n */\nconst PRIVILEGE_ESCALATION_BINARIES = [\"/usr/bin/sudo\", \"/usr/bin/su\", \"/usr/bin/sudoedit\", \"/usr/bin/login\"] as const;\n\n/**\n * The system resolver's socket. `getaddrinfo` on macOS reaches mDNSResponder\n * through this unix socket, so without it every hostname fails to resolve even\n * with IP networking fully allowed (measured: `curl` reports\n * \"Could not resolve host\", `node` reports `ENOTFOUND`).\n */\nconst DNS_RESOLVER_SOCKET = \"/private/var/run/mDNSResponder\";\n\n/**\n * Renders `value` as an SBPL string literal.\n *\n * Escapes what SBPL can escape and refuses what it cannot, rather than dropping\n * or substituting characters -- a path rendered as something other than itself\n * is a policy that does not match the policy that was reviewed.\n */\nexport function quoteSbplString(value: string): string {\n\tfor (const char of value) {\n\t\tconst code = char.codePointAt(0) ?? 0;\n\t\tif (code < 0x20 || code === 0x7f) {\n\t\t\tthrow new SandboxProfileError(\n\t\t\t\t`cannot render path ${JSON.stringify(value)} into a sandbox profile: it contains a control character (U+${code\n\t\t\t\t\t.toString(16)\n\t\t\t\t\t.padStart(4, \"0\")\n\t\t\t\t\t.toUpperCase()}) that SBPL string literals cannot represent`,\n\t\t\t);\n\t\t}\n\t}\n\treturn `\"${value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"')}\"`;\n}\n\n/** Generates the SBPL profile text for `policy`. Deterministic: same policy, same bytes. */\nexport function buildSeatbeltProfile(policy: SandboxPolicy): string {\n\tif (policy.writePaths.length === 0) {\n\t\t// Every backend needs somewhere to write (the shell's own tmp, at minimum),\n\t\t// and an empty allowlist almost always means policy resolution silently\n\t\t// dropped everything. Refusing surfaces that as `unavailable`.\n\t\tthrow new SandboxProfileError(\"cannot render a sandbox profile: the write allowlist is empty\");\n\t}\n\tfor (const path of policy.writePaths) {\n\t\tif (path === \"/\") {\n\t\t\tthrow new SandboxProfileError(\n\t\t\t\t\"cannot render a sandbox profile: the write allowlist contains the filesystem root, which would confine nothing\",\n\t\t\t);\n\t\t}\n\t}\n\n\tconst writeSubpaths = policy.writePaths.map((path) => `(subpath ${quoteSbplString(path)})`).join(\" \");\n\n\tconst lines: string[] = [\n\t\t\"(version 1)\",\n\t\t\"\",\n\t\t\";; Generated from SandboxPolicy v1 by src/core/sandbox/seatbelt-profile.ts.\",\n\t\t\";; Do not edit by hand. Every allow below names the thing that breaks without it.\",\n\t\t\"\",\n\t\t\";; ---------------------------------------------------------------------------\",\n\t\t\";; Deny by default. A capability nobody enumerated is a capability nobody\",\n\t\t\";; reviewed; the previous `(allow default)` shape left launchd, the debugger\",\n\t\t\";; interface and unix sockets open, each of which is a complete escape.\",\n\t\t\";; ---------------------------------------------------------------------------\",\n\t\t\"(deny default)\",\n\t\t\"\",\n\t\t\";; --- what running a developer command actually requires -------------------\",\n\t\t\"\",\n\t\t\";; Running arbitrary binaries is the bash tool's entire purpose; confinement\",\n\t\t\";; here is over what those binaries may write and reach, not over which of\",\n\t\t\";; them exist. (Without it nothing runs at all: even `/bin/sh` fails to exec.)\",\n\t\t\"(allow process-exec*)\",\n\t\t\"\",\n\t\t\";; Every pipeline, subshell, `$(...)` and parallel build forks.\",\n\t\t\"(allow process-fork)\",\n\t\t\"\",\n\t\t\";; R44-SBX.2: v1 is read allow-all. Dev workflows read toolchains, caches and\",\n\t\t\";; dotfiles constantly, and a read-deny list is a v2 concern.\",\n\t\t\"(allow file-read*)\",\n\t\t\"\",\n\t\t\";; The policy: only these subtrees are writable. Seatbelt matches the resolved\",\n\t\t\";; vnode, so a symlink pointing out of one of these does not widen it.\",\n\t\t`(allow file-write* ${writeSubpaths})`,\n\t\t\"\",\n\t\t\";; Device nodes a shell needs to function. Not filesystem persistence.\",\n\t\t`(allow file-write* ${DEVICE_WRITE_RULES.join(\" \")})`,\n\t\t\"\",\n\t\t\";; A pty the process allocates for itself (`script`, `node-pty`, `python -m pty`,\",\n\t\t\";; anything that wants a tty for a child). `pseudo-tty` issues the sandbox\",\n\t\t\";; extension that the following rule requires, so this grants the child *its\",\n\t\t';; own* terminal and no other: the machine-wide `(regex #\"^/dev/ttys[0-9]*$\")`',\n\t\t\";; this replaces let a confined process write a forged prompt into somebody\",\n\t\t\";; else's terminal. Idiom taken from Apple's own application.sb.\",\n\t\t\"(allow pseudo-tty)\",\n\t\t'(allow file-read* file-write* (require-all (regex #\"^/dev/ttys[0-9]*$\") (extension \"com.apple.sandbox.pty\")))',\n\t\t\"\",\n\t\t\";; `isatty`, terminal size, and the termios calls every interactive-ish tool\",\n\t\t\";; makes on descriptors it has already opened.\",\n\t\t\"(allow file-ioctl)\",\n\t\t\"\",\n\t\t\";; `hw.ncpu`, `kern.osversion` and friends: node, python and make read these\",\n\t\t\";; during startup (`os.cpus()`, `sysctl -n hw.ncpu`, `uname -a`).\",\n\t\t\"(allow sysctl-read)\",\n\t\t\"\",\n\t\t\";; Job control over the command's own process tree -- `kill %1`, `make` killing\",\n\t\t\";; a stuck child, `trap`. `(target same-sandbox)` stops there: without the\",\n\t\t\";; filter a confined command can SIGKILL the agent that launched it (verified:\",\n\t\t\";; it could, under the old profile).\",\n\t\t\"(allow signal (target same-sandbox))\",\n\t\t\"\",\n\t\t\";; POSIX semaphores: `multiprocessing.Pool` fails with EPERM in `sem_unlink`\",\n\t\t\";; without this, which takes out most parallel Python.\",\n\t\t\"(allow ipc-posix-sem)\",\n\t\t\"\",\n\t\t\";; POSIX shared memory: `multiprocessing.shared_memory` and the data-science\",\n\t\t\";; stacks layered on it. A memory-object namespace -- no filesystem, exec or\",\n\t\t\";; network reach comes with it.\",\n\t\t\"(allow ipc-posix-shm)\",\n\t\t\"\",\n\t\t\";; User and group lookup (`getpwuid`). Without it `id -un` and `whoami` print\",\n\t\t\";; a bare uid, `os.userInfo()` throws ENOENT, and git cannot name an author.\",\n\t\t\";; One service, by name: a bare `(allow mach-lookup)` is what put LaunchServices\",\n\t\t\";; -- and therefore launchd -- back in reach.\",\n\t\t'(allow mach-lookup (global-name \"com.apple.system.opendirectoryd.libinfo\"))',\n\t\t\"\",\n\t];\n\n\tif (policy.network === \"on\") {\n\t\tlines.push(\n\t\t\t\";; --- network on ------------------------------------------------------------\",\n\t\t\t\"\",\n\t\t\t\";; IP only, in both directions, plus binding a local port for a dev server.\",\n\t\t\t\"(allow network-outbound (remote ip))\",\n\t\t\t\"(allow network-inbound (local ip))\",\n\t\t\t\"(allow network-bind (local ip))\",\n\t\t\t\"\",\n\t\t\t\";; The system resolver's socket, named exactly, or nothing resolves.\",\n\t\t\t`(allow network-outbound (literal ${quoteSbplString(DNS_RESOLVER_SOCKET)}))`,\n\t\t\t\"\",\n\t\t\t\";; Unix-domain sockets, confined to the write allowlist: a command may run\",\n\t\t\t\";; its own helper daemon inside its own writable area, and a directory it\",\n\t\t\t\";; can already write into is one it could already plant a socket in -- so\",\n\t\t\t\";; this grants nothing the write allowlist did not already grant. Sockets\",\n\t\t\t\";; anywhere else -- docker.sock, a tmux or screen server, an emacs server --\",\n\t\t\t\";; belong to *unsandboxed* daemons that execute what they are told, and\",\n\t\t\t\";; reaching one is a full escape (verified: a confined process injected a\",\n\t\t\t\";; payload into a listening daemon this way).\",\n\t\t\t`(allow network-outbound network-bind ${writeSubpaths})`,\n\t\t\t\"\",\n\t\t);\n\t} else {\n\t\tlines.push(\n\t\t\t\";; --- network off -----------------------------------------------------------\",\n\t\t\t\"\",\n\t\t\t\";; Outbound, inbound, bind, and unix-domain sockets: the toggle means *no\",\n\t\t\t\";; sockets*, not merely no IP. A loopback connect fails with EPERM rather\",\n\t\t\t\";; than being refused, which is what the R44-SBX.4 self-test distinguishes.\",\n\t\t\t\"(deny network*)\",\n\t\t\t\"\",\n\t\t);\n\t}\n\n\tlines.push(\n\t\t\";; --- escape routes, denied explicitly -------------------------------------\",\n\t\t\";; `(deny default)` already covers every rule in this block. They are written\",\n\t\t\";; out anyway so that the next person to widen an allow above can see what the\",\n\t\t\";; widening must not reach.\",\n\t\t\"\",\n\t\t\";; task_for_pid / ptrace-style attach. A confined command could otherwise take\",\n\t\t\";; the task port of any same-uid process -- including the agent itself -- and\",\n\t\t\";; execute code inside it (verified: `lldb -p` did exactly that, network off).\",\n\t\t\"(deny mach-priv-task-port)\",\n\t\t\"(deny mach-priv-host-port)\",\n\t\t\";; Even a task *name* port hands out another process's address-space metadata.\",\n\t\t\"(deny mach-task-name)\",\n\t\t\";; Reading other processes' state. Scoped to `others` deliberately: an\",\n\t\t\";; unscoped `(deny process-info*)` also blocks a process inspecting itself,\",\n\t\t\";; which aborts curl and anything else that calls `proc_pidinfo` on self.\",\n\t\t\";; Known consequence: `pgrep` and other whole-machine process enumeration\",\n\t\t\";; stop working inside the sandbox. `lsof -p $$` and a command's own job\",\n\t\t\";; control still do. (`ps` was already refused -- it is setuid.)\",\n\t\t\"(deny process-info* (target others))\",\n\t\t\"\",\n\t\t\";; Asking launchd or LaunchServices to start a process for us. That process\",\n\t\t\";; would run *outside* this sandbox, which defeats the write allowlist and the\",\n\t\t\";; network toggle at once (verified: `open -a` launched an app that then wrote\",\n\t\t\";; outside the allowlist). `appleevent-send` is the same escape one hop over:\",\n\t\t\";; scripting an already-running unsandboxed app into running a shell command.\",\n\t\t\"(deny job-creation)\",\n\t\t\"(deny lsopen)\",\n\t\t\"(deny appleevent-send)\",\n\t\t\"\",\n\t\t\";; Authorization Services is the other way to ask the system for privileges.\",\n\t\t\"(deny authorization-right-obtain)\",\n\t\t\"\",\n\t\t\";; No privilege escalation (R44-SBX.2). The kernel already refuses to exec a\",\n\t\t\";; setuid binary from inside any sandbox -- verified: sudo fails EPERM even\",\n\t\t\";; under a bare `(allow default)` profile -- and profiles are inherited across\",\n\t\t\";; exec and cannot be loosened by re-entering sandbox-exec. These denies state\",\n\t\t\";; the invariant explicitly; they are not what enforces it.\",\n\t\t\"(deny file-write-setugid)\",\n\t\t`(deny process-exec* ${PRIVILEGE_ESCALATION_BINARIES.map((bin) => `(literal ${quoteSbplString(bin)})`).join(\" \")})`,\n\t);\n\n\tlines.push(\"\");\n\treturn lines.join(\"\\n\");\n}\n"]}
@@ -0,0 +1,95 @@
1
+ /**
2
+ * macOS Seatbelt backend (R44-SBX.1) -- `sandbox-exec -p <generated profile>`.
3
+ *
4
+ * This is the platform this machine can and does exercise for real: every claim
5
+ * in `seatbelt-profile.ts`'s doc comment was measured here, and the tests in
6
+ * `test/sandbox-backend.test.ts` run against the actual `/usr/bin/sandbox-exec`,
7
+ * not a stub.
8
+ *
9
+ * ## Flow
10
+ *
11
+ * 1. Render the policy to SBPL (`buildSeatbeltProfile`).
12
+ * 2. `sandbox-exec -p <profile> <shell> -c <command>` with a constructed env.
13
+ *
14
+ * There is no step where the profile touches the filesystem, and that is the
15
+ * point. This backend used to stage the SBPL at
16
+ * `mkdtemp(os.tmpdir())/policy.sb` and pass `-f <path>` -- but `os.tmpdir()` is
17
+ * in the write allowlist of *every* production policy (R44-SBX.2), so the file
18
+ * describing the sandbox sat inside the sandbox's own writable area. A confined
19
+ * command could therefore watch that directory and overwrite the profile of a
20
+ * later command with `(allow default)`; a reviewer demonstrated the write
21
+ * succeeding. Passing the profile inline through `-p` removes the artifact
22
+ * rather than trying to protect it: there is no path to race, no directory to
23
+ * watch, and no window between write and read.
24
+ *
25
+ * The profile is visible in the wrapper's argv, which is a disclosure of the
26
+ * policy (which directories are writable), never of a secret -- and a sandboxed
27
+ * process cannot read another process's argv anyway, since the profile denies
28
+ * `process-info*` against other processes.
29
+ *
30
+ * Regenerating per invocation rather than caching by policy hash is deliberate
31
+ * for v1: the policy is resolved per invocation anyway (R44-SBX.2). Profile
32
+ * generation is string building; Phase 46 owns the spawn-overhead budget and can
33
+ * revisit with numbers.
34
+ *
35
+ * ## `status()` and `exec()`
36
+ *
37
+ * `status()` runs the R44-SBX.4 self-test once and memoises the *promise*, so
38
+ * concurrent callers share one probe. `exec()` awaits that same status first and
39
+ * throws `SandboxUnavailableError` when it is not `available` -- **before**
40
+ * spawning anything. That ordering is the whole failure posture: a backend that
41
+ * cannot prove confinement does not run the command in a weaker sandbox and does
42
+ * not run it bare, it does not run it.
43
+ *
44
+ * ## `sandbox-exec` is deprecated
45
+ *
46
+ * It has carried a deprecation warning for years and still ships on every macOS;
47
+ * Chrome, Claude Code and Codex all depend on it. The risk is handled by
48
+ * structure rather than by hope: if Apple removes it, `existsSync` fails or the
49
+ * self-test fails, and this backend reports `unavailable`. Deprecation therefore
50
+ * degrades us to today's permission-gate behaviour (Phase 45), never to silently
51
+ * unconfined execution.
52
+ */
53
+ import { type SandboxExecutor } from "./executor.ts";
54
+ import type { SandboxPolicy } from "./policy.ts";
55
+ export declare const DEFAULT_SANDBOX_EXEC_BIN = "/usr/bin/sandbox-exec";
56
+ /**
57
+ * Ceiling on the inline profile, well under the 1 MiB `ARG_MAX` this machine
58
+ * reports. A policy that renders larger than this is not one we hand to `execve`
59
+ * and hope: an `E2BIG` from the wrapper would surface as an opaque spawn failure,
60
+ * whereas refusing here surfaces as `unavailable`, which is the outcome every
61
+ * other "cannot confine" case in this module already produces.
62
+ */
63
+ export declare const MAX_INLINE_PROFILE_BYTES: number;
64
+ /**
65
+ * Builds the wrapper argv.
66
+ *
67
+ * Exported so a test can assert the shape directly: the profile travels as the
68
+ * `-p` operand and **no element is a path to a profile file**, which is the
69
+ * invariant that keeps a sandboxed command from tampering with the profile of a
70
+ * later one.
71
+ */
72
+ export declare function buildSandboxExecArgs(profile: string, shell: string, shellArgs: readonly string[], command: string): string[];
73
+ export interface SeatbeltSandboxOptions {
74
+ /**
75
+ * Path to `sandbox-exec`. Overridable chiefly as a test injection point for
76
+ * proving fail-closed behaviour -- point it at a nonexistent path and the
77
+ * backend must report `unavailable`, not fall back to a bare spawn. Same role
78
+ * the equivalent option plays in `packages/rlm/src/sandbox.ts`.
79
+ */
80
+ sandboxExecBin?: string;
81
+ /** Explicit shell path from settings; defaults to `getShellConfig()`'s resolution. */
82
+ shellPath?: string;
83
+ /**
84
+ * Profile generator override. Exists so tests can hand the backend a
85
+ * deliberately broken or deliberately permissive profile and assert the
86
+ * self-test catches both. Production never sets it.
87
+ */
88
+ buildProfile?: (policy: SandboxPolicy) => string;
89
+ /** Extra environment variable names to admit (Phase 45 wires this to settings). */
90
+ extraAllowedEnvVars?: readonly string[];
91
+ /** Seconds allowed for the self-test probe. Defaults to the self-test's own default. */
92
+ selfTestTimeoutSeconds?: number;
93
+ }
94
+ export declare function createSeatbeltSandboxExecutor(options?: SeatbeltSandboxOptions): SandboxExecutor;
95
+ //# sourceMappingURL=seatbelt.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seatbelt.d.ts","sourceRoot":"","sources":["../../../src/core/sandbox/seatbelt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAKH,OAAO,EAGN,KAAK,eAAe,EAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACb,MAAM,EAAE,CAEV;AAED,MAAM,WAAW,sBAAsB;IACtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,MAAM,CAAC;IACjD,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,6BAA6B,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAyFnG"}