@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,410 @@
1
+ /**
2
+ * permission-registry — the session's bounded pending-ask registry, and the ONE clock.
3
+ *
4
+ * An ask raised by the agent parks the turn until somebody answers it. This module is what holds
5
+ * that ask while it is unanswered: what was offered, who may answer it, when it stops being
6
+ * answerable, and — once — who won.
7
+ *
8
+ * FOUR PROPERTIES ARE LOAD-BEARING, each paid for by a defect this file exists to make
9
+ * unrepresentable:
10
+ *
11
+ * 1. {@link PermissionRegistry.settle} is SYNCHRONOUS from the pending-check through the removal.
12
+ * One `await` between "is it still pending?" and "mark it resolved" lets two answers both pass
13
+ * validation; the second `resolve()` on the caller's promise is a silent no-op, so a denial
14
+ * and an approval both look accepted and only one of them happened.
15
+ * 2. AN ANSWER'S MEANING COMES FROM THE OFFERED OPTION'S OWN `decision`. Never from its position
16
+ * in the array, never from the shape of its id, never from a label. A vocabulary like
17
+ * `[allow, deny-once, deny-always]` has its denial in the middle and two of them.
18
+ * 3. A REFUSAL NEVER CONSUMES. An unknown id, an id from another session, an option nobody
19
+ * offered — each returns a refusal VALUE and leaves the entry pending and still answerable.
20
+ * A refusal that consumed the ask would let one malformed frame from any attached client
21
+ * silently deny a tool call the human never saw.
22
+ * 4. NOTHING IS FABRICATED. Every terminal state names a decider, and the only decider that is a
23
+ * person is one whose answer named an offered option. Expiry and cancellation are attributed
24
+ * to `system`, never to a surface that did not act.
25
+ *
26
+ * The registry is PURE: it performs no I/O, opens no socket, and touches no session. It imports
27
+ * types only. What it holds is state plus the caller's own resolver, handed BACK on settle so the
28
+ * caller runs it — the registry never calls out into the world by itself except through the expiry
29
+ * listener, which exists because a deadline has to fire from somewhere.
30
+ */
31
+ /** Env var that overrides the fail-closed expiry. Milliseconds. */
32
+ export const PERMISSION_EXPIRY_ENV = "DRAHT_PERMISSION_EXPIRY_MS";
33
+ /**
34
+ * How long an unanswered ask stays answerable: ONE HOUR.
35
+ *
36
+ * The number is chosen for the job this phase exists to do — a human walks away from the terminal
37
+ * and answers from a phone. Every shorter candidate fails that job: 30s and 5m are shorter than a
38
+ * meeting, a commute or a lunch, and an ask that expires while the person who would have approved
39
+ * it is still walking back to their desk fails CLOSED, which reports to the model as a blocked tool
40
+ * call and wastes the whole turn. The archived R34-PERM.8 measurement is what makes an hour safe to
41
+ * pick: the agent core imposes NO deadline of its own (25 minutes parked in `beforeToolCall` with
42
+ * zero degradation), so "hold the turn" is the mechanism and this timer is only the backstop that
43
+ * stops a forgotten ask from parking a session forever.
44
+ *
45
+ * It is a BACKSTOP, not a policy: the expected end of an ask is a human answering it, and every
46
+ * expiry is a small failure. That is also why it is not infinite — an ask nobody will ever answer
47
+ * must eventually fail closed and say so, rather than leaving a session wedged with no diagnosis.
48
+ */
49
+ export const DEFAULT_PERMISSION_EXPIRY_MS = 60 * 60 * 1000;
50
+ /** Floor for a configured expiry: below this a human cannot answer at all. */
51
+ export const MIN_PERMISSION_EXPIRY_MS = 1_000;
52
+ /**
53
+ * Ceiling for a configured expiry: 24 hours.
54
+ *
55
+ * A bound exists so a typo cannot produce an ask that never expires. `Infinity`, `NaN` and a
56
+ * negative number are all rejected in favour of the default rather than clamped, because each of
57
+ * them means "this value was not thought about" rather than "keep it forever".
58
+ */
59
+ export const MAX_PERMISSION_EXPIRY_MS = 24 * 60 * 60 * 1000;
60
+ /** How many asks may be pending at once before new ones are refused. */
61
+ export const DEFAULT_MAX_PENDING = 32;
62
+ /**
63
+ * Largest encoded ask the registry will hold, in bytes.
64
+ *
65
+ * Under the transport's 64 KiB frame cap with headroom: a frame larger than this could not be
66
+ * relayed anyway (the attach bridge refuses an oversized permission frame rather than splitting it,
67
+ * because half an ask is a dialog showing half a command with an Approve button under it), so it is
68
+ * refused here, before anything is written, rather than after a renderer has been dropped.
69
+ */
70
+ export const DEFAULT_MAX_ENTRY_BYTES = 60_000;
71
+ /** Total encoded bytes across all pending asks. */
72
+ export const DEFAULT_MAX_TOTAL_BYTES = 4 * 1024 * 1024;
73
+ /** How long a settled ask is remembered so a late answer is TOLD, rather than merely refused. */
74
+ export const DEFAULT_TOMBSTONE_TTL_MS = 120_000;
75
+ /** How many tombstones are kept. Oldest first out. */
76
+ export const DEFAULT_MAX_TOMBSTONES = 128;
77
+ /** Nobody decided. The only decider an unanswered ask may ever name. */
78
+ export const SYSTEM_DECIDER = Object.freeze({ surface: "system", clientId: null });
79
+ /** THE expiry fact, stated once. The timer lays it and the listener is handed the very same value. */
80
+ export const EXPIRED_BY_SYSTEM = Object.freeze({
81
+ decidedBy: SYSTEM_DECIDER,
82
+ decision: "expired",
83
+ });
84
+ /** THE cancellation fact, stated once, for a session that is being replaced or stopped. */
85
+ export const CANCELLED_BY_SYSTEM = Object.freeze({
86
+ decidedBy: SYSTEM_DECIDER,
87
+ decision: "cancelled",
88
+ });
89
+ /**
90
+ * Read the configured expiry, falling back to {@link DEFAULT_PERMISSION_EXPIRY_MS}.
91
+ *
92
+ * Anything unusable — unset, empty, non-numeric, zero, negative, `Infinity`, out of range — yields
93
+ * the default. A permission deadline must never be `NaN`: `new Date(Date.now() + NaN)` throws a
94
+ * RangeError out of the ask itself, which the permission gate reports as a TOOL ERROR rather than
95
+ * as a denial, so the ask neither fails closed nor reaches anybody.
96
+ */
97
+ export function resolvePermissionExpiryMs(env = process.env) {
98
+ const raw = env[PERMISSION_EXPIRY_ENV];
99
+ if (raw === undefined || raw.trim() === "")
100
+ return DEFAULT_PERMISSION_EXPIRY_MS;
101
+ const parsed = Number(raw);
102
+ if (!Number.isFinite(parsed))
103
+ return DEFAULT_PERMISSION_EXPIRY_MS;
104
+ if (parsed < MIN_PERMISSION_EXPIRY_MS || parsed > MAX_PERMISSION_EXPIRY_MS) {
105
+ return DEFAULT_PERMISSION_EXPIRY_MS;
106
+ }
107
+ return Math.floor(parsed);
108
+ }
109
+ /**
110
+ * The pending-ask registry for ONE session.
111
+ *
112
+ * Lifetime: it is built inside the attach bind closure, so it dies with the session and survives
113
+ * client churn. It is deliberately NOT built in the UI decorator — a new `ExtensionRunner`, and
114
+ * therefore a new decorator, is constructed on every extension reload, which would orphan every
115
+ * ask raised before the reload with the agent still parked on it.
116
+ */
117
+ export class PermissionRegistry {
118
+ #sessionId;
119
+ #expiryMs;
120
+ #maxPending;
121
+ #maxEntryBytes;
122
+ #maxTotalBytes;
123
+ #tombstoneTtlMs;
124
+ #maxTombstones;
125
+ #now;
126
+ /** PENDING entries only. A settled entry is removed here and remembered as a tombstone. */
127
+ #entries = new Map();
128
+ #timers = new Map();
129
+ #tombstones = new Map();
130
+ #totalBytes = 0;
131
+ #expiryListener = null;
132
+ constructor(options) {
133
+ this.#sessionId = options.sessionId;
134
+ this.#expiryMs = options.expiryMs ?? resolvePermissionExpiryMs();
135
+ this.#maxPending = options.maxPending ?? DEFAULT_MAX_PENDING;
136
+ this.#maxEntryBytes = options.maxEntryBytes ?? DEFAULT_MAX_ENTRY_BYTES;
137
+ this.#maxTotalBytes = options.maxTotalBytes ?? DEFAULT_MAX_TOTAL_BYTES;
138
+ this.#tombstoneTtlMs = options.tombstoneTtlMs ?? DEFAULT_TOMBSTONE_TTL_MS;
139
+ this.#maxTombstones = options.maxTombstones ?? DEFAULT_MAX_TOMBSTONES;
140
+ this.#now = options.now ?? Date.now;
141
+ }
142
+ get sessionId() {
143
+ return this.#sessionId;
144
+ }
145
+ /** The one clock, in milliseconds. */
146
+ get expiryMs() {
147
+ return this.#expiryMs;
148
+ }
149
+ get pendingCount() {
150
+ return this.#entries.size;
151
+ }
152
+ /**
153
+ * Called when an ask reaches its deadline with nobody having answered.
154
+ *
155
+ * The listener owns the fail-closed handling: end the raiser's ask, tell every surface, record
156
+ * it. The registry has already removed the entry by then, so a late answer sees a tombstone
157
+ * rather than a still-answerable ask.
158
+ *
159
+ * `ending` is THE SAME VALUE the tombstone was laid with — not a second copy of it. The
160
+ * listener must state the ending from this argument and never from a literal of its own; two
161
+ * literals for one fact is how a mutation to either survived every test in the suite.
162
+ */
163
+ onExpired(listener) {
164
+ this.#expiryListener = listener;
165
+ }
166
+ /** Every still-pending ask, oldest first (insertion order). */
167
+ pending() {
168
+ return [...this.#entries.values()];
169
+ }
170
+ get(requestId) {
171
+ return this.#entries.get(requestId);
172
+ }
173
+ /**
174
+ * Register an ask BEFORE the first socket write.
175
+ *
176
+ * Order matters and is not negotiable: a client can answer before the writer's loop has even
177
+ * finished fanning out, and an answer naming an id the registry has never seen is refused as
178
+ * unknown — which would refuse the very first, correct answer to a real ask.
179
+ */
180
+ insert(input) {
181
+ if (this.#entries.has(input.requestId)) {
182
+ // Ids are `crypto.randomUUID`; a collision means a caller reused one, which would make
183
+ // one answer settle the wrong ask.
184
+ return {
185
+ ok: false,
186
+ reason: "duplicate_request",
187
+ message: `permission request ${JSON.stringify(input.requestId)} is already pending`,
188
+ };
189
+ }
190
+ if (this.#entries.size >= this.#maxPending) {
191
+ return {
192
+ ok: false,
193
+ reason: "too_many_pending",
194
+ message: `at most ${this.#maxPending} permission asks may be pending at once`,
195
+ };
196
+ }
197
+ const bytes = Buffer.byteLength(JSON.stringify(input.frame), "utf8");
198
+ if (bytes > this.#maxEntryBytes) {
199
+ return {
200
+ ok: false,
201
+ reason: "entry_too_large",
202
+ message: `a permission ask must encode to at most ${this.#maxEntryBytes} bytes; this one is ${bytes}`,
203
+ };
204
+ }
205
+ if (this.#totalBytes + bytes > this.#maxTotalBytes) {
206
+ return {
207
+ ok: false,
208
+ reason: "total_too_large",
209
+ message: `pending permission asks may hold at most ${this.#maxTotalBytes} bytes`,
210
+ };
211
+ }
212
+ const entry = Object.freeze({
213
+ sessionId: this.#sessionId,
214
+ requestId: input.requestId,
215
+ method: input.method,
216
+ // Frozen twice over: the array cannot gain an option, and no option can change what it
217
+ // declares. The set that was validated and the set that is offered are the same read.
218
+ options: Object.freeze(input.options.map((option) => Object.freeze({ ...option }))),
219
+ detail: input.detail,
220
+ frame: input.frame,
221
+ requestedAt: input.requestedAt,
222
+ deadlineAt: this.#now() + this.#expiryMs,
223
+ bytes,
224
+ resolve: input.resolve,
225
+ });
226
+ this.#entries.set(entry.requestId, entry);
227
+ this.#totalBytes += bytes;
228
+ const timer = setTimeout(() => {
229
+ this.#timers.delete(entry.requestId);
230
+ // ONE value, laid into the tombstone and handed to the listener. See PermissionEnding.
231
+ const expired = this.#take(entry.requestId, EXPIRED_BY_SYSTEM.decidedBy, EXPIRED_BY_SYSTEM.decision);
232
+ if (expired === undefined)
233
+ return;
234
+ this.#expiryListener?.(expired, EXPIRED_BY_SYSTEM);
235
+ }, this.#expiryMs);
236
+ // A pending ask must not be the reason the process stays alive: the session's own run loop
237
+ // decides that. An `unref`'d timer still fires for as long as anything else is running,
238
+ // which is exactly as long as an ask can matter.
239
+ timer.unref?.();
240
+ this.#timers.set(entry.requestId, timer);
241
+ return { ok: true, entry };
242
+ }
243
+ /**
244
+ * Answer an ask. SYNCHRONOUS from the pending-check through the removal — see property (1).
245
+ *
246
+ * Returns the entry and its resolver on success; the caller runs the resolver. Every refusal
247
+ * leaves the entry exactly as it was, still pending and still answerable by somebody else.
248
+ */
249
+ settle(sessionId, requestId, optionId, decidedBy) {
250
+ if (sessionId !== this.#sessionId) {
251
+ // Said the same way as an unknown id on purpose: a client must not be able to use the
252
+ // refusal text as an oracle for which session ids exist.
253
+ return {
254
+ status: "refused",
255
+ reason: "cross_session",
256
+ message: `No permission ask ${JSON.stringify(requestId)} is pending`,
257
+ };
258
+ }
259
+ const entry = this.#entries.get(requestId);
260
+ if (entry === undefined) {
261
+ const tombstone = this.#tombstone(requestId);
262
+ if (tombstone !== undefined) {
263
+ return {
264
+ status: "already_resolved",
265
+ decidedBy: tombstone.decidedBy,
266
+ decision: tombstone.decision,
267
+ message: `Permission ask ${JSON.stringify(requestId)} was already resolved by ${tombstone.decidedBy.surface}`,
268
+ };
269
+ }
270
+ return {
271
+ status: "refused",
272
+ reason: "unknown_request",
273
+ message: `No permission ask ${JSON.stringify(requestId)} is pending`,
274
+ };
275
+ }
276
+ const decision = decisionFor(entry, optionId);
277
+ if (decision === undefined) {
278
+ // An option nobody offered is SILENCE, not a dismissal. It decides nothing, it consumes
279
+ // nothing, and it can never become a decision attributed to a human.
280
+ return {
281
+ status: "refused",
282
+ reason: "invalid_option",
283
+ message: `Option ${JSON.stringify(optionId)} was not offered for permission ask ${JSON.stringify(requestId)}`,
284
+ };
285
+ }
286
+ // ── the compare-and-swap. Nothing above yields; nothing below may either. ──
287
+ this.#remove(entry.requestId);
288
+ this.#addTombstone({ requestId: entry.requestId, decidedBy, decision, at: this.#now() });
289
+ return {
290
+ status: "resolved",
291
+ entry,
292
+ answer: { requestId: entry.requestId, optionId, decidedBy },
293
+ chosenOptionId: optionId,
294
+ decision,
295
+ };
296
+ }
297
+ /**
298
+ * End a pending ask that some OTHER surface decided.
299
+ *
300
+ * Returns the entry when this call is the one that ended it, and `undefined` when it was
301
+ * already over — which is the common case and must stay silent, because the relay decorator
302
+ * withdraws every ask it settles, including the ones a remote answer just settled here. A
303
+ * second broadcast and a second audit record would both be wrong.
304
+ */
305
+ withdraw(requestId, decidedBy, decision) {
306
+ return this.#take(requestId, decidedBy, decision);
307
+ }
308
+ /**
309
+ * End every pending ask, fail-closed.
310
+ *
311
+ * Used when the session is replaced or stopped: the asks belong to a session that is going
312
+ * away, so nothing they gate may proceed. Returns them so the caller can resolve, announce and
313
+ * record each one.
314
+ */
315
+ cancelAll(decidedBy = CANCELLED_BY_SYSTEM.decidedBy) {
316
+ const cancelled = [];
317
+ for (const requestId of [...this.#entries.keys()]) {
318
+ const entry = this.#take(requestId, decidedBy, CANCELLED_BY_SYSTEM.decision);
319
+ if (entry !== undefined)
320
+ cancelled.push(entry);
321
+ }
322
+ return cancelled;
323
+ }
324
+ #take(requestId, decidedBy, decision) {
325
+ const entry = this.#entries.get(requestId);
326
+ if (entry === undefined)
327
+ return undefined;
328
+ this.#remove(requestId);
329
+ this.#addTombstone({ requestId, decidedBy, decision, at: this.#now() });
330
+ return entry;
331
+ }
332
+ #remove(requestId) {
333
+ const entry = this.#entries.get(requestId);
334
+ if (entry === undefined)
335
+ return;
336
+ this.#entries.delete(requestId);
337
+ this.#totalBytes -= entry.bytes;
338
+ const timer = this.#timers.get(requestId);
339
+ if (timer !== undefined) {
340
+ clearTimeout(timer);
341
+ this.#timers.delete(requestId);
342
+ }
343
+ }
344
+ #addTombstone(tombstone) {
345
+ this.#tombstones.set(tombstone.requestId, tombstone);
346
+ while (this.#tombstones.size > this.#maxTombstones) {
347
+ const oldest = this.#tombstones.keys().next();
348
+ if (oldest.done === true)
349
+ break;
350
+ this.#tombstones.delete(oldest.value);
351
+ }
352
+ }
353
+ #tombstone(requestId) {
354
+ const found = this.#tombstones.get(requestId);
355
+ if (found === undefined)
356
+ return undefined;
357
+ if (this.#now() - found.at > this.#tombstoneTtlMs) {
358
+ this.#tombstones.delete(requestId);
359
+ return undefined;
360
+ }
361
+ return found;
362
+ }
363
+ }
364
+ /**
365
+ * What answering `optionId` MEANS for this ask, or `undefined` when it means nothing at all.
366
+ *
367
+ * The whole rule, in one place:
368
+ *
369
+ * - `input` OFFERS NOTHING — it has no option ids and never had any — so EVERY string is a valid
370
+ * answer, carried verbatim as the answer itself. Refusing free text here would hang the agent on
371
+ * an ask the client rendered as fully answerable. The condition is the EMPTY OFFERED SET, not the
372
+ * method name: keying it on `method === "input"` alone made "an answer must name an offered
373
+ * option" depend on an invariant maintained in a different module (the decorator's
374
+ * `NO_OFFERED_OPTIONS`), and an `input` ask that ever carried a vocabulary would have accepted —
375
+ * and CONSUMED — an id nobody offered. Property (3) of this file holds for every method now,
376
+ * whoever builds the ask.
377
+ * - otherwise the id must be one of the ids that were OFFERED, and what it means is that option's
378
+ * OWN `decision` — read off the option, never derived from its index, its id or its label.
379
+ * - an offered option that declares no `decision` (a plain `select`, whose entries are choices
380
+ * rather than a permission vocabulary) ends the ask by being ANSWERED — `answered`, the wire's
381
+ * neutral word. The choice itself travels as `chosenOptionId`.
382
+ *
383
+ * GAP CLOSED (geist/0.4). This function used to say `approved` for those last two, because the wire
384
+ * union had no neutral member. That was a FABRICATED GRANT: `select` and `input` grant nothing and
385
+ * refuse nothing, so "approved" stated a decision that was never offered, let alone made. The
386
+ * containment argument that went with it — "no audit row is written for an ask with no
387
+ * `tool_permission` detail" — was false: nothing stops an extension attaching one, and a probe did,
388
+ * which put the fabricated word into the DURABLE record. `answered` now exists on
389
+ * `TerminalDecision`, on `socket-server/types.ts`, on `PermissionResolutionEntry.decision` and on
390
+ * `geist-protocol`'s `PermissionResolvedFrameSchema`, so the true thing is sayable and is said.
391
+ *
392
+ * `answered` GRANTS NOTHING. Anything downstream that branches on this value must treat it as it
393
+ * treats `denied`; only `approved` is permission. What was actually chosen is `chosenOptionId`.
394
+ *
395
+ * A `deny` option still yields `denied` and an `approve` option still yields `approved` — the words
396
+ * for a real permission vocabulary are unchanged, and only the case that HAD no true word moved.
397
+ */
398
+ export function decisionFor(entry, optionId) {
399
+ if (entry.method === "input" && entry.options.length === 0)
400
+ return "answered";
401
+ const chosen = entry.options.find((option) => option.id === optionId);
402
+ if (chosen === undefined)
403
+ return undefined;
404
+ if (chosen.decision === "deny")
405
+ return "denied";
406
+ if (chosen.decision === "approve")
407
+ return "approved";
408
+ return "answered";
409
+ }
410
+ //# sourceMappingURL=permission-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permission-registry.js","sourceRoot":"","sources":["../../../src/core/socket-server/permission-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * permission-registry — the session's bounded pending-ask registry, and the ONE clock.\n *\n * An ask raised by the agent parks the turn until somebody answers it. This module is what holds\n * that ask while it is unanswered: what was offered, who may answer it, when it stops being\n * answerable, and — once — who won.\n *\n * FOUR PROPERTIES ARE LOAD-BEARING, each paid for by a defect this file exists to make\n * unrepresentable:\n *\n * 1. {@link PermissionRegistry.settle} is SYNCHRONOUS from the pending-check through the removal.\n * One `await` between \"is it still pending?\" and \"mark it resolved\" lets two answers both pass\n * validation; the second `resolve()` on the caller's promise is a silent no-op, so a denial\n * and an approval both look accepted and only one of them happened.\n * 2. AN ANSWER'S MEANING COMES FROM THE OFFERED OPTION'S OWN `decision`. Never from its position\n * in the array, never from the shape of its id, never from a label. A vocabulary like\n * `[allow, deny-once, deny-always]` has its denial in the middle and two of them.\n * 3. A REFUSAL NEVER CONSUMES. An unknown id, an id from another session, an option nobody\n * offered — each returns a refusal VALUE and leaves the entry pending and still answerable.\n * A refusal that consumed the ask would let one malformed frame from any attached client\n * silently deny a tool call the human never saw.\n * 4. NOTHING IS FABRICATED. Every terminal state names a decider, and the only decider that is a\n * person is one whose answer named an offered option. Expiry and cancellation are attributed\n * to `system`, never to a surface that did not act.\n *\n * The registry is PURE: it performs no I/O, opens no socket, and touches no session. It imports\n * types only. What it holds is state plus the caller's own resolver, handed BACK on settle so the\n * caller runs it — the registry never calls out into the world by itself except through the expiry\n * listener, which exists because a deadline has to fire from somewhere.\n */\n\nimport type { PermissionAskDetail } from \"../extensions/types.js\";\nimport type { RelayAnswer, RelayAsk, RelayDecider, RelayEnded } from \"../permission-relay/types.js\";\nimport type { PermissionRequestMessage } from \"./types.js\";\n\n/** Env var that overrides the fail-closed expiry. Milliseconds. */\nexport const PERMISSION_EXPIRY_ENV = \"DRAHT_PERMISSION_EXPIRY_MS\";\n\n/**\n * How long an unanswered ask stays answerable: ONE HOUR.\n *\n * The number is chosen for the job this phase exists to do — a human walks away from the terminal\n * and answers from a phone. Every shorter candidate fails that job: 30s and 5m are shorter than a\n * meeting, a commute or a lunch, and an ask that expires while the person who would have approved\n * it is still walking back to their desk fails CLOSED, which reports to the model as a blocked tool\n * call and wastes the whole turn. The archived R34-PERM.8 measurement is what makes an hour safe to\n * pick: the agent core imposes NO deadline of its own (25 minutes parked in `beforeToolCall` with\n * zero degradation), so \"hold the turn\" is the mechanism and this timer is only the backstop that\n * stops a forgotten ask from parking a session forever.\n *\n * It is a BACKSTOP, not a policy: the expected end of an ask is a human answering it, and every\n * expiry is a small failure. That is also why it is not infinite — an ask nobody will ever answer\n * must eventually fail closed and say so, rather than leaving a session wedged with no diagnosis.\n */\nexport const DEFAULT_PERMISSION_EXPIRY_MS = 60 * 60 * 1000;\n\n/** Floor for a configured expiry: below this a human cannot answer at all. */\nexport const MIN_PERMISSION_EXPIRY_MS = 1_000;\n\n/**\n * Ceiling for a configured expiry: 24 hours.\n *\n * A bound exists so a typo cannot produce an ask that never expires. `Infinity`, `NaN` and a\n * negative number are all rejected in favour of the default rather than clamped, because each of\n * them means \"this value was not thought about\" rather than \"keep it forever\".\n */\nexport const MAX_PERMISSION_EXPIRY_MS = 24 * 60 * 60 * 1000;\n\n/** How many asks may be pending at once before new ones are refused. */\nexport const DEFAULT_MAX_PENDING = 32;\n\n/**\n * Largest encoded ask the registry will hold, in bytes.\n *\n * Under the transport's 64 KiB frame cap with headroom: a frame larger than this could not be\n * relayed anyway (the attach bridge refuses an oversized permission frame rather than splitting it,\n * because half an ask is a dialog showing half a command with an Approve button under it), so it is\n * refused here, before anything is written, rather than after a renderer has been dropped.\n */\nexport const DEFAULT_MAX_ENTRY_BYTES = 60_000;\n\n/** Total encoded bytes across all pending asks. */\nexport const DEFAULT_MAX_TOTAL_BYTES = 4 * 1024 * 1024;\n\n/** How long a settled ask is remembered so a late answer is TOLD, rather than merely refused. */\nexport const DEFAULT_TOMBSTONE_TTL_MS = 120_000;\n\n/** How many tombstones are kept. Oldest first out. */\nexport const DEFAULT_MAX_TOMBSTONES = 128;\n\n/**\n * Every way an ask can end. Mirrors the wire's `permission_resolved.decision`\n * member for member — `socket-server/types.ts`, and through it\n * `geist-protocol`'s `PermissionResolvedFrameSchema`.\n *\n * `answered` is the NEUTRAL member, added with `geist/0.4`. It says an ask was\n * ANSWERED and says nothing about permission, which is the only true thing to say\n * about a `select` or an `input`: they offer no vocabulary that grants or refuses.\n * It GRANTS NOTHING — read it fail-closed everywhere, exactly as `denied`.\n */\nexport type TerminalDecision = \"approved\" | \"denied\" | \"cancelled\" | \"expired\" | \"answered\";\n\n/**\n * WHO ended an ask nobody answered, and WHAT that ending was — as ONE value.\n *\n * The two halves travel together because they are one fact and they were previously written down\n * twice: this file's expiry timer laid the tombstone from its own `{surface: \"system\"}` /\n * `\"expired\"` literals, and the relay's `onExpired` listener used a second, independent pair for\n * the broadcast and the audit row. They agreed, so nothing noticed — until a verifier mutated one\n * and the other carried on asserting the old word, which is a durable record and a live wire frame\n * disagreeing about the same ending with no test in a position to see it.\n */\nexport interface PermissionEnding {\n\treadonly decidedBy: RelayDecider;\n\treadonly decision: TerminalDecision;\n}\n\n/** Nobody decided. The only decider an unanswered ask may ever name. */\nexport const SYSTEM_DECIDER: RelayDecider = Object.freeze({ surface: \"system\", clientId: null });\n\n/** THE expiry fact, stated once. The timer lays it and the listener is handed the very same value. */\nexport const EXPIRED_BY_SYSTEM: PermissionEnding = Object.freeze({\n\tdecidedBy: SYSTEM_DECIDER,\n\tdecision: \"expired\" as const,\n});\n\n/** THE cancellation fact, stated once, for a session that is being replaced or stopped. */\nexport const CANCELLED_BY_SYSTEM: PermissionEnding = Object.freeze({\n\tdecidedBy: SYSTEM_DECIDER,\n\tdecision: \"cancelled\" as const,\n});\n\n/**\n * Read the configured expiry, falling back to {@link DEFAULT_PERMISSION_EXPIRY_MS}.\n *\n * Anything unusable — unset, empty, non-numeric, zero, negative, `Infinity`, out of range — yields\n * the default. A permission deadline must never be `NaN`: `new Date(Date.now() + NaN)` throws a\n * RangeError out of the ask itself, which the permission gate reports as a TOOL ERROR rather than\n * as a denial, so the ask neither fails closed nor reaches anybody.\n */\nexport function resolvePermissionExpiryMs(env: NodeJS.ProcessEnv = process.env): number {\n\tconst raw = env[PERMISSION_EXPIRY_ENV];\n\tif (raw === undefined || raw.trim() === \"\") return DEFAULT_PERMISSION_EXPIRY_MS;\n\tconst parsed = Number(raw);\n\tif (!Number.isFinite(parsed)) return DEFAULT_PERMISSION_EXPIRY_MS;\n\tif (parsed < MIN_PERMISSION_EXPIRY_MS || parsed > MAX_PERMISSION_EXPIRY_MS) {\n\t\treturn DEFAULT_PERMISSION_EXPIRY_MS;\n\t}\n\treturn Math.floor(parsed);\n}\n\n/** One offered option, exactly as it was offered. Frozen on insert; never rebuilt. */\nexport interface RegisteredOption {\n\treadonly id: string;\n\treadonly label: string;\n\t/** What choosing this option MEANS, when the vocabulary declares it. Read, never inferred. */\n\treadonly decision?: \"approve\" | \"deny\";\n}\n\n/** A pending ask. Everything here was fixed when the ask was raised. */\nexport interface PermissionEntry {\n\treadonly sessionId: string;\n\treadonly requestId: string;\n\treadonly method: RelayAsk[\"method\"];\n\t/** The immutable offered set — the ONLY answerable set. Frozen. */\n\treadonly options: readonly RegisteredOption[];\n\t/** Canonical detail, when this ask gates a tool call. Absent for a plain extension dialog. */\n\treadonly detail?: PermissionAskDetail;\n\t/** The exact frame that was broadcast, replayed verbatim to a client that arrives later. */\n\treadonly frame: PermissionRequestMessage;\n\treadonly requestedAt: string;\n\t/** Wall-clock instant this ask stops being answerable, in ms since the epoch. */\n\treadonly deadlineAt: number;\n\t/** Encoded size of {@link PermissionEntry.frame}, counted once at insert. */\n\treadonly bytes: number;\n\t/**\n\t * The raiser's own resolver. The registry stores it and hands it back; it never calls it.\n\t *\n\t * It takes a {@link RelayEnded} as well as an answer because an ask that EXPIRED or was\n\t * CANCELLED is over on every surface, and the raiser has to be told that rather than told the\n\t * relay merely gave up — the two used to be the same `undefined`, and a decorator reading the\n\t * second meaning kept a live Approve button on an ask already recorded as expired.\n\t */\n\treadonly resolve: (answer: RelayAnswer | RelayEnded | undefined) => void;\n}\n\n/** Why an insert was refused. Each is a bound, not a failure of the asker. */\nexport type InsertRefusal = \"duplicate_request\" | \"too_many_pending\" | \"entry_too_large\" | \"total_too_large\";\n\nexport type InsertResult =\n\t| { readonly ok: true; readonly entry: PermissionEntry }\n\t| { readonly ok: false; readonly reason: InsertRefusal; readonly message: string };\n\n/** Why an answer was refused. In every case the entry, if there is one, is left untouched. */\nexport type SettleRefusal = \"unknown_request\" | \"cross_session\" | \"invalid_option\";\n\nexport type SettleResult =\n\t| {\n\t\t\treadonly status: \"resolved\";\n\t\t\treadonly entry: PermissionEntry;\n\t\t\treadonly answer: RelayAnswer;\n\t\t\treadonly chosenOptionId: string;\n\t\t\treadonly decision: TerminalDecision;\n\t }\n\t| { readonly status: \"refused\"; readonly reason: SettleRefusal; readonly message: string }\n\t| {\n\t\t\treadonly status: \"already_resolved\";\n\t\t\treadonly decidedBy: RelayDecider;\n\t\t\treadonly decision: TerminalDecision;\n\t\t\treadonly message: string;\n\t };\n\n/** A settled ask, remembered briefly so a late or reconnecting answerer learns WHY it is refused. */\ninterface Tombstone {\n\treadonly requestId: string;\n\treadonly decidedBy: RelayDecider;\n\treadonly decision: TerminalDecision;\n\treadonly at: number;\n}\n\nexport interface PermissionRegistryOptions {\n\t/** The session these asks belong to. An answer naming any other session is refused. */\n\tsessionId: string;\n\texpiryMs?: number;\n\tmaxPending?: number;\n\tmaxEntryBytes?: number;\n\tmaxTotalBytes?: number;\n\ttombstoneTtlMs?: number;\n\tmaxTombstones?: number;\n\t/** Injectable for tests. Defaults to `Date.now`. */\n\tnow?: () => number;\n}\n\n/** What {@link PermissionRegistry.insert} needs beyond the frame itself. */\nexport interface PermissionInsert {\n\treadonly requestId: string;\n\treadonly method: RelayAsk[\"method\"];\n\treadonly options: readonly RegisteredOption[];\n\treadonly detail?: PermissionAskDetail;\n\treadonly frame: PermissionRequestMessage;\n\treadonly requestedAt: string;\n\treadonly resolve: (answer: RelayAnswer | RelayEnded | undefined) => void;\n}\n\n/**\n * The pending-ask registry for ONE session.\n *\n * Lifetime: it is built inside the attach bind closure, so it dies with the session and survives\n * client churn. It is deliberately NOT built in the UI decorator — a new `ExtensionRunner`, and\n * therefore a new decorator, is constructed on every extension reload, which would orphan every\n * ask raised before the reload with the agent still parked on it.\n */\nexport class PermissionRegistry {\n\treadonly #sessionId: string;\n\treadonly #expiryMs: number;\n\treadonly #maxPending: number;\n\treadonly #maxEntryBytes: number;\n\treadonly #maxTotalBytes: number;\n\treadonly #tombstoneTtlMs: number;\n\treadonly #maxTombstones: number;\n\treadonly #now: () => number;\n\n\t/** PENDING entries only. A settled entry is removed here and remembered as a tombstone. */\n\treadonly #entries = new Map<string, PermissionEntry>();\n\treadonly #timers = new Map<string, ReturnType<typeof setTimeout>>();\n\treadonly #tombstones = new Map<string, Tombstone>();\n\t#totalBytes = 0;\n\t#expiryListener: ((entry: PermissionEntry, ending: PermissionEnding) => void) | null = null;\n\n\tconstructor(options: PermissionRegistryOptions) {\n\t\tthis.#sessionId = options.sessionId;\n\t\tthis.#expiryMs = options.expiryMs ?? resolvePermissionExpiryMs();\n\t\tthis.#maxPending = options.maxPending ?? DEFAULT_MAX_PENDING;\n\t\tthis.#maxEntryBytes = options.maxEntryBytes ?? DEFAULT_MAX_ENTRY_BYTES;\n\t\tthis.#maxTotalBytes = options.maxTotalBytes ?? DEFAULT_MAX_TOTAL_BYTES;\n\t\tthis.#tombstoneTtlMs = options.tombstoneTtlMs ?? DEFAULT_TOMBSTONE_TTL_MS;\n\t\tthis.#maxTombstones = options.maxTombstones ?? DEFAULT_MAX_TOMBSTONES;\n\t\tthis.#now = options.now ?? Date.now;\n\t}\n\n\tget sessionId(): string {\n\t\treturn this.#sessionId;\n\t}\n\n\t/** The one clock, in milliseconds. */\n\tget expiryMs(): number {\n\t\treturn this.#expiryMs;\n\t}\n\n\tget pendingCount(): number {\n\t\treturn this.#entries.size;\n\t}\n\n\t/**\n\t * Called when an ask reaches its deadline with nobody having answered.\n\t *\n\t * The listener owns the fail-closed handling: end the raiser's ask, tell every surface, record\n\t * it. The registry has already removed the entry by then, so a late answer sees a tombstone\n\t * rather than a still-answerable ask.\n\t *\n\t * `ending` is THE SAME VALUE the tombstone was laid with — not a second copy of it. The\n\t * listener must state the ending from this argument and never from a literal of its own; two\n\t * literals for one fact is how a mutation to either survived every test in the suite.\n\t */\n\tonExpired(listener: (entry: PermissionEntry, ending: PermissionEnding) => void): void {\n\t\tthis.#expiryListener = listener;\n\t}\n\n\t/** Every still-pending ask, oldest first (insertion order). */\n\tpending(): readonly PermissionEntry[] {\n\t\treturn [...this.#entries.values()];\n\t}\n\n\tget(requestId: string): PermissionEntry | undefined {\n\t\treturn this.#entries.get(requestId);\n\t}\n\n\t/**\n\t * Register an ask BEFORE the first socket write.\n\t *\n\t * Order matters and is not negotiable: a client can answer before the writer's loop has even\n\t * finished fanning out, and an answer naming an id the registry has never seen is refused as\n\t * unknown — which would refuse the very first, correct answer to a real ask.\n\t */\n\tinsert(input: PermissionInsert): InsertResult {\n\t\tif (this.#entries.has(input.requestId)) {\n\t\t\t// Ids are `crypto.randomUUID`; a collision means a caller reused one, which would make\n\t\t\t// one answer settle the wrong ask.\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: \"duplicate_request\",\n\t\t\t\tmessage: `permission request ${JSON.stringify(input.requestId)} is already pending`,\n\t\t\t};\n\t\t}\n\t\tif (this.#entries.size >= this.#maxPending) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: \"too_many_pending\",\n\t\t\t\tmessage: `at most ${this.#maxPending} permission asks may be pending at once`,\n\t\t\t};\n\t\t}\n\n\t\tconst bytes = Buffer.byteLength(JSON.stringify(input.frame), \"utf8\");\n\t\tif (bytes > this.#maxEntryBytes) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: \"entry_too_large\",\n\t\t\t\tmessage: `a permission ask must encode to at most ${this.#maxEntryBytes} bytes; this one is ${bytes}`,\n\t\t\t};\n\t\t}\n\t\tif (this.#totalBytes + bytes > this.#maxTotalBytes) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: \"total_too_large\",\n\t\t\t\tmessage: `pending permission asks may hold at most ${this.#maxTotalBytes} bytes`,\n\t\t\t};\n\t\t}\n\n\t\tconst entry: PermissionEntry = Object.freeze({\n\t\t\tsessionId: this.#sessionId,\n\t\t\trequestId: input.requestId,\n\t\t\tmethod: input.method,\n\t\t\t// Frozen twice over: the array cannot gain an option, and no option can change what it\n\t\t\t// declares. The set that was validated and the set that is offered are the same read.\n\t\t\toptions: Object.freeze(input.options.map((option) => Object.freeze({ ...option }))),\n\t\t\tdetail: input.detail,\n\t\t\tframe: input.frame,\n\t\t\trequestedAt: input.requestedAt,\n\t\t\tdeadlineAt: this.#now() + this.#expiryMs,\n\t\t\tbytes,\n\t\t\tresolve: input.resolve,\n\t\t});\n\n\t\tthis.#entries.set(entry.requestId, entry);\n\t\tthis.#totalBytes += bytes;\n\n\t\tconst timer = setTimeout(() => {\n\t\t\tthis.#timers.delete(entry.requestId);\n\t\t\t// ONE value, laid into the tombstone and handed to the listener. See PermissionEnding.\n\t\t\tconst expired = this.#take(entry.requestId, EXPIRED_BY_SYSTEM.decidedBy, EXPIRED_BY_SYSTEM.decision);\n\t\t\tif (expired === undefined) return;\n\t\t\tthis.#expiryListener?.(expired, EXPIRED_BY_SYSTEM);\n\t\t}, this.#expiryMs);\n\t\t// A pending ask must not be the reason the process stays alive: the session's own run loop\n\t\t// decides that. An `unref`'d timer still fires for as long as anything else is running,\n\t\t// which is exactly as long as an ask can matter.\n\t\ttimer.unref?.();\n\t\tthis.#timers.set(entry.requestId, timer);\n\n\t\treturn { ok: true, entry };\n\t}\n\n\t/**\n\t * Answer an ask. SYNCHRONOUS from the pending-check through the removal — see property (1).\n\t *\n\t * Returns the entry and its resolver on success; the caller runs the resolver. Every refusal\n\t * leaves the entry exactly as it was, still pending and still answerable by somebody else.\n\t */\n\tsettle(sessionId: string, requestId: string, optionId: string, decidedBy: RelayDecider): SettleResult {\n\t\tif (sessionId !== this.#sessionId) {\n\t\t\t// Said the same way as an unknown id on purpose: a client must not be able to use the\n\t\t\t// refusal text as an oracle for which session ids exist.\n\t\t\treturn {\n\t\t\t\tstatus: \"refused\",\n\t\t\t\treason: \"cross_session\",\n\t\t\t\tmessage: `No permission ask ${JSON.stringify(requestId)} is pending`,\n\t\t\t};\n\t\t}\n\n\t\tconst entry = this.#entries.get(requestId);\n\t\tif (entry === undefined) {\n\t\t\tconst tombstone = this.#tombstone(requestId);\n\t\t\tif (tombstone !== undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tstatus: \"already_resolved\",\n\t\t\t\t\tdecidedBy: tombstone.decidedBy,\n\t\t\t\t\tdecision: tombstone.decision,\n\t\t\t\t\tmessage: `Permission ask ${JSON.stringify(requestId)} was already resolved by ${tombstone.decidedBy.surface}`,\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tstatus: \"refused\",\n\t\t\t\treason: \"unknown_request\",\n\t\t\t\tmessage: `No permission ask ${JSON.stringify(requestId)} is pending`,\n\t\t\t};\n\t\t}\n\n\t\tconst decision = decisionFor(entry, optionId);\n\t\tif (decision === undefined) {\n\t\t\t// An option nobody offered is SILENCE, not a dismissal. It decides nothing, it consumes\n\t\t\t// nothing, and it can never become a decision attributed to a human.\n\t\t\treturn {\n\t\t\t\tstatus: \"refused\",\n\t\t\t\treason: \"invalid_option\",\n\t\t\t\tmessage: `Option ${JSON.stringify(optionId)} was not offered for permission ask ${JSON.stringify(requestId)}`,\n\t\t\t};\n\t\t}\n\n\t\t// ── the compare-and-swap. Nothing above yields; nothing below may either. ──\n\t\tthis.#remove(entry.requestId);\n\t\tthis.#addTombstone({ requestId: entry.requestId, decidedBy, decision, at: this.#now() });\n\n\t\treturn {\n\t\t\tstatus: \"resolved\",\n\t\t\tentry,\n\t\t\tanswer: { requestId: entry.requestId, optionId, decidedBy },\n\t\t\tchosenOptionId: optionId,\n\t\t\tdecision,\n\t\t};\n\t}\n\n\t/**\n\t * End a pending ask that some OTHER surface decided.\n\t *\n\t * Returns the entry when this call is the one that ended it, and `undefined` when it was\n\t * already over — which is the common case and must stay silent, because the relay decorator\n\t * withdraws every ask it settles, including the ones a remote answer just settled here. A\n\t * second broadcast and a second audit record would both be wrong.\n\t */\n\twithdraw(requestId: string, decidedBy: RelayDecider, decision: TerminalDecision): PermissionEntry | undefined {\n\t\treturn this.#take(requestId, decidedBy, decision);\n\t}\n\n\t/**\n\t * End every pending ask, fail-closed.\n\t *\n\t * Used when the session is replaced or stopped: the asks belong to a session that is going\n\t * away, so nothing they gate may proceed. Returns them so the caller can resolve, announce and\n\t * record each one.\n\t */\n\tcancelAll(decidedBy: RelayDecider = CANCELLED_BY_SYSTEM.decidedBy): PermissionEntry[] {\n\t\tconst cancelled: PermissionEntry[] = [];\n\t\tfor (const requestId of [...this.#entries.keys()]) {\n\t\t\tconst entry = this.#take(requestId, decidedBy, CANCELLED_BY_SYSTEM.decision);\n\t\t\tif (entry !== undefined) cancelled.push(entry);\n\t\t}\n\t\treturn cancelled;\n\t}\n\n\t#take(requestId: string, decidedBy: RelayDecider, decision: TerminalDecision): PermissionEntry | undefined {\n\t\tconst entry = this.#entries.get(requestId);\n\t\tif (entry === undefined) return undefined;\n\t\tthis.#remove(requestId);\n\t\tthis.#addTombstone({ requestId, decidedBy, decision, at: this.#now() });\n\t\treturn entry;\n\t}\n\n\t#remove(requestId: string): void {\n\t\tconst entry = this.#entries.get(requestId);\n\t\tif (entry === undefined) return;\n\t\tthis.#entries.delete(requestId);\n\t\tthis.#totalBytes -= entry.bytes;\n\t\tconst timer = this.#timers.get(requestId);\n\t\tif (timer !== undefined) {\n\t\t\tclearTimeout(timer);\n\t\t\tthis.#timers.delete(requestId);\n\t\t}\n\t}\n\n\t#addTombstone(tombstone: Tombstone): void {\n\t\tthis.#tombstones.set(tombstone.requestId, tombstone);\n\t\twhile (this.#tombstones.size > this.#maxTombstones) {\n\t\t\tconst oldest = this.#tombstones.keys().next();\n\t\t\tif (oldest.done === true) break;\n\t\t\tthis.#tombstones.delete(oldest.value);\n\t\t}\n\t}\n\n\t#tombstone(requestId: string): Tombstone | undefined {\n\t\tconst found = this.#tombstones.get(requestId);\n\t\tif (found === undefined) return undefined;\n\t\tif (this.#now() - found.at > this.#tombstoneTtlMs) {\n\t\t\tthis.#tombstones.delete(requestId);\n\t\t\treturn undefined;\n\t\t}\n\t\treturn found;\n\t}\n}\n\n/**\n * What answering `optionId` MEANS for this ask, or `undefined` when it means nothing at all.\n *\n * The whole rule, in one place:\n *\n * - `input` OFFERS NOTHING — it has no option ids and never had any — so EVERY string is a valid\n * answer, carried verbatim as the answer itself. Refusing free text here would hang the agent on\n * an ask the client rendered as fully answerable. The condition is the EMPTY OFFERED SET, not the\n * method name: keying it on `method === \"input\"` alone made \"an answer must name an offered\n * option\" depend on an invariant maintained in a different module (the decorator's\n * `NO_OFFERED_OPTIONS`), and an `input` ask that ever carried a vocabulary would have accepted —\n * and CONSUMED — an id nobody offered. Property (3) of this file holds for every method now,\n * whoever builds the ask.\n * - otherwise the id must be one of the ids that were OFFERED, and what it means is that option's\n * OWN `decision` — read off the option, never derived from its index, its id or its label.\n * - an offered option that declares no `decision` (a plain `select`, whose entries are choices\n * rather than a permission vocabulary) ends the ask by being ANSWERED — `answered`, the wire's\n * neutral word. The choice itself travels as `chosenOptionId`.\n *\n * GAP CLOSED (geist/0.4). This function used to say `approved` for those last two, because the wire\n * union had no neutral member. That was a FABRICATED GRANT: `select` and `input` grant nothing and\n * refuse nothing, so \"approved\" stated a decision that was never offered, let alone made. The\n * containment argument that went with it — \"no audit row is written for an ask with no\n * `tool_permission` detail\" — was false: nothing stops an extension attaching one, and a probe did,\n * which put the fabricated word into the DURABLE record. `answered` now exists on\n * `TerminalDecision`, on `socket-server/types.ts`, on `PermissionResolutionEntry.decision` and on\n * `geist-protocol`'s `PermissionResolvedFrameSchema`, so the true thing is sayable and is said.\n *\n * `answered` GRANTS NOTHING. Anything downstream that branches on this value must treat it as it\n * treats `denied`; only `approved` is permission. What was actually chosen is `chosenOptionId`.\n *\n * A `deny` option still yields `denied` and an `approve` option still yields `approved` — the words\n * for a real permission vocabulary are unchanged, and only the case that HAD no true word moved.\n */\nexport function decisionFor(entry: PermissionEntry, optionId: string): TerminalDecision | undefined {\n\tif (entry.method === \"input\" && entry.options.length === 0) return \"answered\";\n\tconst chosen = entry.options.find((option) => option.id === optionId);\n\tif (chosen === undefined) return undefined;\n\tif (chosen.decision === \"deny\") return \"denied\";\n\tif (chosen.decision === \"approve\") return \"approved\";\n\treturn \"answered\";\n}\n"]}
@@ -0,0 +1,81 @@
1
+ /**
2
+ * permission-relay — the session's implementation of the {@link PermissionRelay} port.
3
+ *
4
+ * This is the piece that makes an ask raised by the agent reach a phone, and an answer from that
5
+ * phone reach the agent. Everything it does is one of five things:
6
+ *
7
+ * raise build the frame, register it, fan it out, hand back a promise
8
+ * answer first VALID answer wins, exactly once, and everybody is told
9
+ * withdraw some other surface decided; the remote copies come down, saying WHAT it decided
10
+ * replay a client that arrived late is shown what is still unanswered
11
+ * expire nobody answered in time; fail closed, attributed to the system
12
+ *
13
+ * THE ORDER AFTER A WINNING ANSWER IS LOAD-BEARING, and it cost four adversarial rounds:
14
+ *
15
+ * settle → resolve the raise() promise → broadcast `permission_resolved` → append the JSONL record
16
+ *
17
+ * The decorator that owns the caller's promise aborts the LOSING surfaces as part of resolving, and
18
+ * it does so only after it has marked itself settled. Aborting before resolving is a real defect
19
+ * with a real transcript consequence: interactive mode honours an abort by resolving its selector
20
+ * to `undefined`, which its confirm wrapper maps to `false` — a FABRICATED local denial that would
21
+ * overwrite the remote approval that just won, and be recorded as a human's refusal.
22
+ *
23
+ * NOTHING HERE FABRICATES A DECISION. An answer's meaning is read off the offered option's own
24
+ * `decision`; an option nobody offered is silence and consumes nothing; an ask that expires or is
25
+ * cancelled is attributed to `system`, never to a surface that did not act. AND NOTHING HERE
26
+ * GUESSES ONE EITHER: `withdraw` is told what happened by the surface that settled the ask, because
27
+ * when it guessed `cancelled` it wrote that word over an approval whose command had already run.
28
+ */
29
+ import type { PermissionRelay } from "../permission-relay/types.js";
30
+ import type { PermissionResolution } from "../session-manager.js";
31
+ import type { PermissionDelivery } from "./permission-delivery.js";
32
+ import { type PermissionEntry, type PermissionRegistry } from "./permission-registry.js";
33
+ import type { PermissionRequestMessage, PermissionResolvedMessage } from "./types.js";
34
+ /**
35
+ * The socket server, as this module uses it.
36
+ *
37
+ * Structural on purpose: `SocketServer` satisfies it without this module importing the class, so
38
+ * the relay can be driven by a hand-written double in a unit test and there is no import cycle
39
+ * between the server and the thing it hands answers to.
40
+ */
41
+ export interface PermissionSocketServer {
42
+ readonly permissionCapableClientCount: number;
43
+ broadcastPermissionRequest(message: PermissionRequestMessage): string[];
44
+ sendPermissionRequest(clientId: string, message: PermissionRequestMessage): void;
45
+ broadcastPermissionResolved(message: PermissionResolvedMessage): void;
46
+ sendErrorToClient(clientId: string, message: string, code?: string): void;
47
+ }
48
+ /** The session's own JSONL writer, as this module uses it. `SessionManager` satisfies it. */
49
+ export interface PermissionRecorder {
50
+ appendPermissionResolution(resolution: PermissionResolution): string;
51
+ }
52
+ export interface SocketPermissionRelayOptions {
53
+ registry: PermissionRegistry;
54
+ delivery: PermissionDelivery<PermissionEntry>;
55
+ /** Read live: the server is replaced when the session is, and stopped before it is. */
56
+ server: () => PermissionSocketServer | null;
57
+ /** Read live: the session's own JSONL writer, or null once the session is gone. */
58
+ recorder: () => PermissionRecorder | null;
59
+ /** The session id the registry is scoped to. */
60
+ sessionId: string;
61
+ /** The session's resolved working directory, for asks that carry no tool detail of their own. */
62
+ cwd: string;
63
+ /** Reports non-fatal problems. Defaults to stderr. */
64
+ onWarning?: (message: string) => void;
65
+ }
66
+ /** The port, plus the four hooks the socket server drives it through. */
67
+ export interface SocketPermissionRelay extends PermissionRelay {
68
+ /** A client answered. Validates, settles at most once, echoes, records. */
69
+ handleResponse(message: {
70
+ requestId: string;
71
+ optionId: string;
72
+ }, clientId: string): void;
73
+ /** A client attached: show it everything still unanswered, exactly once. */
74
+ replayTo(clientId: string): void;
75
+ /** A client's connection ended: drop its delivery record so a reconnect is shown everything. */
76
+ forgetClient(clientId: string): void;
77
+ /** The session is going away. Every pending ask ends fail-closed and is recorded as cancelled. */
78
+ cancelAll(): void;
79
+ }
80
+ export declare function createSocketPermissionRelay(options: SocketPermissionRelayOptions): SocketPermissionRelay;
81
+ //# sourceMappingURL=permission-relay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permission-relay.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/permission-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EACX,eAAe,EAMf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAGN,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAGvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAoB,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAExG;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,EAAE,CAAC;IACxE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACjF,2BAA2B,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACtE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1E;AAED,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IAClC,0BAA0B,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAAC;CACrE;AA2DD,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC9C,uFAAuF;IACvF,MAAM,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,EAAE,MAAM,kBAAkB,GAAG,IAAI,CAAC;IAC1C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC7D,2EAA2E;IAC3E,cAAc,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzF,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gGAAgG;IAChG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,kGAAkG;IAClG,SAAS,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB,CA+UxG"}