@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
@@ -2,17 +2,240 @@
2
2
  * Socket Session Discovery
3
3
  *
4
4
  * Scans the sockets directory to find all running attachable sessions.
5
+ *
6
+ * ── OWNERSHIP AND HYGIENE RULES (R35-ALWAYS.3, R35-ALWAYS.4) ───────────────────
7
+ *
8
+ * These rules are implemented TWICE on purpose: here, and synchronously in
9
+ * `packages/geist-core/src/attach/socket-sessions.ts`, which may not import this
10
+ * package across the geist boundary gate. `scripts/check-geist-protocol.mjs`'s
11
+ * mirror clause only covers the relayed FRAMES — it does not cover any of this —
12
+ * so the two files have to be changed together by hand. They had already drifted
13
+ * once (this file used to shield a lock from the orphan sweep before it had
14
+ * established that `<id>.sock` was a socket at all); that drift is fixed here.
15
+ *
16
+ * O1. OURS OR INVISIBLE. An entry whose file uid is not this process's uid, or
17
+ * whose lock names a live process we cannot signal (`kill` → EPERM, i.e. it
18
+ * belongs to another user), is never listed and never dialled. Before this,
19
+ * a world-writable sockets directory holding a 0666 socket and a lock naming
20
+ * root's pid 1 was listed as a live attachable session by both readers and
21
+ * would have been dialled by the bridge; the 0700 directory mode was the
22
+ * only thing in the way, and nothing asserted it.
23
+ * O2. FOREIGN IS NOT REAPED HERE. A read must not destroy what it cannot
24
+ * interpret, and a fleet scan runs on an HTTP request. Foreign entries are
25
+ * skipped. `SocketServer.start()` is the one place allowed to remove them,
26
+ * and only after it has asserted the directory really is ours and owner-only
27
+ * — which makes a foreign file inside it debris by construction.
28
+ * O3. EPERM STILL MEANS ALIVE. `kill(pid, 0)` → EPERM says the process exists.
29
+ * It is never read as dead, so another user's live session is never reaped.
30
+ * What changed is that "alive" no longer implies "ours".
31
+ * O4. DEBRIS. Two classes used to be immortal — a `.sock` with no `.lock`, and a
32
+ * regular file named `<id>.sock` — because both readers `continue`d past
33
+ * them without reaping. Two such orphans had been sitting in the real
34
+ * `~/.draht/agent/sockets` since 2026-08-21. Both are now reaped once they
35
+ * are older than {@link DEBRIS_GRACE_MS}, which no legitimate transient
36
+ * state survives: the lock is claimed BEFORE the socket is bound, and
37
+ * teardown removes the socket BEFORE the lock, so a socket without a lock is
38
+ * never a normal intermediate state in either direction.
39
+ * O5. A LOCK CANNOT PREDATE THE BOOT. See {@link lockIsPreBootDebris}.
5
40
  */
6
41
  import { existsSync } from "node:fs";
7
- import { readdir, readFile, stat } from "node:fs/promises";
42
+ import { lstat, readdir, readFile, rm } from "node:fs/promises";
43
+ import { uptime } from "node:os";
8
44
  import path from "node:path";
45
+ import { getSoakLog, SOAK_EVENTS } from "../soak/soak-log.js";
46
+ /**
47
+ * How long a file has to sit untouched before it counts as debris rather than as
48
+ * a transient another starter is in the middle of creating.
49
+ *
50
+ * Deliberately the same number as `UNWRITTEN_LOCK_STALE_MS` in `socket-server.ts`
51
+ * and `DEBRIS_GRACE_MS` in geist-core's `socket-sessions.ts`. It is duplicated
52
+ * rather than imported for the boundary reason at the top of this file.
53
+ */
54
+ export const DEBRIS_GRACE_MS = 10_000;
55
+ /**
56
+ * Slack on the boot-time comparison in {@link lockIsPreBootDebris}.
57
+ *
58
+ * `Date.now()` is wall clock and `os.uptime()` is elapsed-since-boot, so their
59
+ * difference moves whenever the clock is stepped. Five minutes is far more than
60
+ * NTP ever steps in one go and far less than the gap between a lock written
61
+ * before a reboot and the reboot itself.
62
+ */
63
+ const PRE_BOOT_SLACK_MS = 300_000;
64
+ function newReapTally() {
65
+ return {
66
+ reaped: {
67
+ deadPid: 0,
68
+ preBootLock: 0,
69
+ locklessSocket: 0,
70
+ notASocket: 0,
71
+ orphanLockDeadPid: 0,
72
+ orphanLockPreBoot: 0,
73
+ },
74
+ skipped: { foreignSocketUid: 0, foreignLockUid: 0, foreignPid: 0 },
75
+ };
76
+ }
77
+ /** Total files unlinked in this pass. */
78
+ function reapedFileCount(tally) {
79
+ return Object.values(tally.reaped).reduce((total, count) => total + count, 0);
80
+ }
81
+ /** Total entries left alone for an ownership reason. */
82
+ function skippedCount(tally) {
83
+ return Object.values(tally.skipped).reduce((total, count) => total + count, 0);
84
+ }
85
+ /**
86
+ * Publish one pass's tally, and only when it has something to say.
87
+ *
88
+ * A quiet sweep writes nothing: `discoverSocketSessions` runs on every session
89
+ * start and on every fleet read, and a record per no-op scan would be the bulk of
90
+ * a seven-day log. Silence here therefore means "nothing was removed and nothing
91
+ * was skipped", which is the common case and the one a verdict does not need
92
+ * evidence for.
93
+ *
94
+ * Never stdout, never stderr, never a throw — a hygiene sweep may not be what
95
+ * breaks a session start.
96
+ *
97
+ * NO `sessionId` IS SUPPLIED HERE, on purpose. The writer stamps its own whenever
98
+ * it has one, which it does for every session process — the id is set at bind,
99
+ * before `SocketServer.start()` runs this sweep. The one caller that reaches this
100
+ * function without a session of its own is `draht --list-sessions`, and a sweep
101
+ * performed by a process that owns no session is not attributable to one; the
102
+ * record is written without the field rather than with a borrowed value.
103
+ */
104
+ function recordReapTally(socketDir, tally, scanned, live) {
105
+ const count = reapedFileCount(tally);
106
+ const skipped = skippedCount(tally);
107
+ if (count === 0 && skipped === 0)
108
+ return;
109
+ try {
110
+ getSoakLog().record(SOAK_EVENTS.SOCKETS_REAPED, {
111
+ // FILES, not pairs: a dead session contributes its `.sock` and its `.lock`
112
+ // separately, so this number can be compared against a `readdir` difference.
113
+ count,
114
+ reaped: tally.reaped,
115
+ skipped: tally.skipped,
116
+ skippedCount: skipped,
117
+ socketDir,
118
+ scanned,
119
+ live,
120
+ }, count > 0 ? "warn" : "info");
121
+ }
122
+ catch {
123
+ // Deliberately empty, and deliberately not logged anywhere.
124
+ }
125
+ }
126
+ /**
127
+ * Who owns the process a lock names.
128
+ *
129
+ * `process.kill(pid, 0)` sends no signal; it only asks whether the pid could be
130
+ * signalled. EPERM is the discriminator that costs nothing: a process this uid
131
+ * could have started is always signallable by this uid, so EPERM means alive AND
132
+ * not ours. That single distinction is what R35-ALWAYS.3 rests on — without it a
133
+ * lock naming root's pid 1 reads as a live session of ours forever.
134
+ */
135
+ export function pidOwnership(pid) {
136
+ if (!Number.isInteger(pid) || pid <= 0)
137
+ return "dead";
138
+ try {
139
+ process.kill(pid, 0);
140
+ return "ours";
141
+ }
142
+ catch (error) {
143
+ return error?.code === "EPERM" ? "foreign" : "dead";
144
+ }
145
+ }
146
+ /**
147
+ * Check if a process with the given PID is running.
148
+ *
149
+ * Uses `process.kill(pid, 0)` which doesn't actually send a signal,
150
+ * but throws if the process doesn't exist.
151
+ *
152
+ * EPERM means the process exists but belongs to another user: alive, and still
153
+ * reported as alive (O3). Callers that also care WHOSE it is ask
154
+ * {@link pidOwnership} instead.
155
+ */
156
+ export function isProcessRunning(pid) {
157
+ return pidOwnership(pid) !== "dead";
158
+ }
159
+ /** This process's uid, or null off POSIX where the concept does not exist. */
160
+ export function currentUid() {
161
+ return typeof process.getuid === "function" ? process.getuid() : null;
162
+ }
163
+ /** Whether a directory entry belongs to this uid. Always true off POSIX. */
164
+ function ownedByUs(info, uid) {
165
+ return uid === null || info.uid === uid;
166
+ }
167
+ /** Whether a file has sat untouched long enough to count as debris. */
168
+ function olderThanGrace(info, now) {
169
+ return now - info.mtimeMs > DEBRIS_GRACE_MS;
170
+ }
171
+ /** Epoch milliseconds at which this machine booted. */
172
+ function bootEpochMs() {
173
+ return Date.now() - uptime() * 1000;
174
+ }
175
+ /**
176
+ * A lock recording a process that started before this machine last booted.
177
+ *
178
+ * This is the answer to "bound readable-pid locks" (R35-ALWAYS.4). The two
179
+ * candidates were recording the owner's start time and comparing it, or putting a
180
+ * blanket age bound on readable-pid locks. **A blanket age bound is rejected**: a
181
+ * draht session legitimately runs for days, and reaping a live session's lock is
182
+ * worse than the leak it cures — the id becomes claimable while the socket is
183
+ * still bound, and two processes end up appending to one session JSONL.
184
+ *
185
+ * So the lock carries the owning process's start time as a 4th line, and the only
186
+ * comparison made is the one that cannot produce a false positive on a live
187
+ * session: nothing running now started before the last boot. That covers the
188
+ * dominant real-world source of pid recycling — a reboot recycles every pid at
189
+ * once, which is how a lock naming pid 1 comes to poison a session id forever.
190
+ *
191
+ * Line 3 (the ISO creation time) is used when line 4 is absent, so the locks
192
+ * already on disk from older builds are covered too. Old 3-line locks still parse:
193
+ * the length floor stays at 3.
194
+ *
195
+ * NOT covered: a same-uid pid recycled without a reboot. That needs the owner's
196
+ * real start time from the OS, which costs a subprocess per lock on a path that
197
+ * runs on every fleet read.
198
+ */
199
+ function lockIsPreBootDebris(lock, bootMs) {
200
+ return lock.startedAtMs !== null && lock.startedAtMs < bootMs - PRE_BOOT_SLACK_MS;
201
+ }
202
+ /** Parse a lock file's contents, or null when it says nothing trustworthy. */
203
+ function parseLock(contents) {
204
+ const lines = contents.trim().split("\n");
205
+ // Three lines is still the contract. A 4th line is additive; a build that does
206
+ // not write one is read exactly as before.
207
+ if (lines.length < 3)
208
+ return null;
209
+ const pid = Number.parseInt(lines[0], 10);
210
+ if (!Number.isInteger(pid) || pid <= 0)
211
+ return null;
212
+ const createdAt = new Date(lines[2]);
213
+ const fromLine4 = lines.length >= 4 ? Number.parseInt(lines[3], 10) : Number.NaN;
214
+ const startedAtMs = Number.isFinite(fromLine4)
215
+ ? fromLine4
216
+ : Number.isFinite(createdAt.getTime())
217
+ ? createdAt.getTime()
218
+ : null;
219
+ return { pid, cwd: lines[1], createdAt, startedAtMs };
220
+ }
221
+ /** Read and parse a lock file, or null when it is missing or half-written. */
222
+ async function readLock(lockPath) {
223
+ try {
224
+ return parseLock(await readFile(lockPath, "utf-8"));
225
+ }
226
+ catch {
227
+ return null;
228
+ }
229
+ }
9
230
  /**
10
231
  * Discover all running socket-based sessions.
11
232
  *
12
233
  * Scans the socket directory for .sock files and reads their corresponding
13
234
  * .lock files to extract metadata (PID, cwd, createdAt).
14
235
  *
15
- * Filters out stale sessions (PID no longer running).
236
+ * Only sessions belonging to this uid are returned, and reaping follows the rules
237
+ * at the top of this file: dead-owner pairs, pre-boot locks, lockless sockets and
238
+ * non-socket `<id>.sock` files go; anything foreign, fresh, or unreadable stays.
16
239
  *
17
240
  * @param socketDir - Directory containing socket files
18
241
  * @returns Array of discovered session info
@@ -22,50 +245,104 @@ export async function discoverSocketSessions(socketDir) {
22
245
  return [];
23
246
  }
24
247
  const sessions = [];
248
+ const uid = currentUid();
249
+ const now = Date.now();
250
+ const bootMs = bootEpochMs();
251
+ const tally = newReapTally();
25
252
  try {
26
253
  const entries = await readdir(socketDir);
254
+ const sessionIdsWithSocket = new Set();
27
255
  for (const entry of entries) {
28
256
  // Only process .sock files
29
257
  if (!entry.endsWith(".sock"))
30
258
  continue;
31
- const sessionId = entry.replace(/\.sock$/, "");
259
+ const sessionId = entry.slice(0, -".sock".length);
260
+ if (sessionId.length === 0)
261
+ continue;
32
262
  const socketPath = path.join(socketDir, entry);
33
263
  const lockPath = path.join(socketDir, `${sessionId}.lock`);
34
- // Check if socket file exists and is a socket
264
+ // lstat, not stat: a symlink named `<id>.sock` is not a socket we published,
265
+ // and following it would let something outside the directory decide what this
266
+ // scan sees.
267
+ let socketInfo;
35
268
  try {
36
- const stats = await stat(socketPath);
37
- if (!stats.isSocket())
38
- continue;
269
+ socketInfo = await lstat(socketPath);
39
270
  }
40
271
  catch {
41
272
  continue;
42
273
  }
43
- // Read lock file for metadata
44
- if (!existsSync(lockPath))
274
+ if (!socketInfo.isSocket()) {
275
+ // Debris class (ii): a regular file (or symlink) wearing a .sock name.
276
+ // Neither reader could ever remove one before. Directories are left alone —
277
+ // removing a tree is not this function's business.
278
+ if (!socketInfo.isDirectory() && ownedByUs(socketInfo, uid) && olderThanGrace(socketInfo, now)) {
279
+ await reapStaleSession(socketPath);
280
+ tally.reaped.notASocket++;
281
+ }
282
+ // Deliberately NOT added to sessionIdsWithSocket: this id has no socket, so
283
+ // its lock belongs to the orphan sweep below. Shielding it here (the old
284
+ // behaviour, and the drift from geist-core) is what made class (ii) immortal.
285
+ continue;
286
+ }
287
+ // O1: another user's socket is not ours to list, dial, or delete.
288
+ if (!ownedByUs(socketInfo, uid)) {
289
+ tally.skipped.foreignSocketUid++;
45
290
  continue;
291
+ }
292
+ sessionIdsWithSocket.add(sessionId);
293
+ let lockInfo;
46
294
  try {
47
- const lockContent = await readFile(lockPath, "utf-8");
48
- const lines = lockContent.trim().split("\n");
49
- if (lines.length < 3)
50
- continue;
51
- const pid = Number.parseInt(lines[0], 10);
52
- const cwd = lines[1];
53
- const createdAt = new Date(lines[2]);
54
- // Verify PID is still running
55
- if (!isProcessRunning(pid)) {
56
- // Stale socket - skip it (cleanup could be done here)
57
- continue;
295
+ lockInfo = await lstat(lockPath);
296
+ }
297
+ catch {
298
+ lockInfo = null;
299
+ }
300
+ if (lockInfo === null) {
301
+ // Debris class (i): a socket with no lock. Never a normal transient — the
302
+ // lock is claimed before the bind, and teardown removes the socket first.
303
+ if (olderThanGrace(socketInfo, now)) {
304
+ await reapStaleSession(socketPath);
305
+ tally.reaped.locklessSocket++;
58
306
  }
59
- sessions.push({
60
- sessionId,
61
- socketPath,
62
- pid,
63
- cwd,
64
- createdAt,
65
- });
307
+ continue;
308
+ }
309
+ // A lock that is not a plain file, or is not ours, is not evidence about a
310
+ // session of ours. Left strictly alone.
311
+ if (!lockInfo.isFile() || !ownedByUs(lockInfo, uid)) {
312
+ if (!ownedByUs(lockInfo, uid))
313
+ tally.skipped.foreignLockUid++;
314
+ continue;
66
315
  }
67
- catch { }
316
+ const lock = await readLock(lockPath);
317
+ // Unreadable or half-written: ownership unknown, never guess.
318
+ if (!lock)
319
+ continue;
320
+ const ownership = pidOwnership(lock.pid);
321
+ if (ownership === "dead" || lockIsPreBootDebris(lock, bootMs)) {
322
+ await reapStaleSession(socketPath, lockPath);
323
+ // Two files, and counted as two: this number is compared against a
324
+ // directory listing, which cannot see pairs.
325
+ if (ownership === "dead")
326
+ tally.reaped.deadPid += 2;
327
+ else
328
+ tally.reaped.preBootLock += 2;
329
+ continue;
330
+ }
331
+ // Alive, but another user's process: never listed (O1), never reaped (O2).
332
+ if (ownership === "foreign") {
333
+ tally.skipped.foreignPid++;
334
+ continue;
335
+ }
336
+ sessions.push({
337
+ sessionId,
338
+ socketPath,
339
+ pid: lock.pid,
340
+ cwd: lock.cwd,
341
+ createdAt: lock.createdAt,
342
+ });
68
343
  }
344
+ await reapOrphanedLocks(socketDir, entries, sessionIdsWithSocket, uid, bootMs, tally);
345
+ recordReapTally(socketDir, tally, entries.length, sessions.length);
69
346
  }
70
347
  catch {
71
348
  // Directory not readable - return empty
@@ -74,18 +351,60 @@ export async function discoverSocketSessions(socketDir) {
74
351
  return sessions;
75
352
  }
76
353
  /**
77
- * Check if a process with the given PID is running.
354
+ * Remove the files of a session that can never accept a connection again.
78
355
  *
79
- * Uses `process.kill(pid, 0)` which doesn't actually send a signal,
80
- * but throws if the process doesn't exist.
356
+ * Best effort: a concurrent reaper or a permission problem must never turn a
357
+ * discovery call into a failure.
81
358
  */
82
- function isProcessRunning(pid) {
83
- try {
84
- process.kill(pid, 0);
85
- return true;
359
+ async function reapStaleSession(...paths) {
360
+ for (const target of paths) {
361
+ try {
362
+ await rm(target, { force: true });
363
+ }
364
+ catch { }
86
365
  }
87
- catch {
88
- return false;
366
+ }
367
+ /**
368
+ * Remove `.lock` files whose `.sock` is already gone and whose owner is provably
369
+ * gone with it.
370
+ *
371
+ * Such locks are invisible to the `.sock` scan above, so without this they accumulate
372
+ * forever. A lock with no socket is also the normal state for a moment during startup -
373
+ * the lock is claimed before the socket is bound - so a lock whose PID is alive, or
374
+ * whose PID cannot be read at all, is always left alone. A lock belonging to another
375
+ * uid, or naming another user's live process, is left alone too (O1, O2).
376
+ */
377
+ async function reapOrphanedLocks(socketDir, entries, sessionIdsWithSocket, uid, bootMs, tally) {
378
+ for (const entry of entries) {
379
+ if (!entry.endsWith(".lock"))
380
+ continue;
381
+ if (sessionIdsWithSocket.has(entry.slice(0, -".lock".length)))
382
+ continue;
383
+ const lockPath = path.join(socketDir, entry);
384
+ try {
385
+ const info = await lstat(lockPath);
386
+ if (!info.isFile() || !ownedByUs(info, uid)) {
387
+ if (!ownedByUs(info, uid))
388
+ tally.skipped.foreignLockUid++;
389
+ continue;
390
+ }
391
+ const lock = await readLock(lockPath);
392
+ // Unreadable ownership: never guess, leave it alone.
393
+ if (!lock)
394
+ continue;
395
+ const ownership = pidOwnership(lock.pid);
396
+ if (ownership === "dead" || lockIsPreBootDebris(lock, bootMs)) {
397
+ await rm(lockPath, { force: true });
398
+ if (ownership === "dead")
399
+ tally.reaped.orphanLockDeadPid++;
400
+ else
401
+ tally.reaped.orphanLockPreBoot++;
402
+ }
403
+ else if (ownership === "foreign") {
404
+ tally.skipped.foreignPid++;
405
+ }
406
+ }
407
+ catch { }
89
408
  }
90
409
  }
91
410
  //# sourceMappingURL=discovery.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/core/socket-server/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB;IAC7D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAwB,EAAE,CAAC;IAEzC,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,2BAA2B;YAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEvC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;YAE3D,8CAA8C;YAC9C,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;oBAAE,SAAS;YACjC,CAAC;YAAC,MAAM,CAAC;gBACR,SAAS;YACV,CAAC;YAED,8BAA8B;YAC9B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEpC,IAAI,CAAC;gBACJ,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE7C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,SAAS;gBAE/B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACrB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAErC,8BAA8B;gBAC9B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,sDAAsD;oBACtD,SAAS;gBACV,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC;oBACb,SAAS;oBACT,UAAU;oBACV,GAAG;oBACH,GAAG;oBACH,SAAS;iBACT,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,wCAAwC;QACxC,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACpC,IAAI,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC","sourcesContent":["/**\n * Socket Session Discovery\n *\n * Scans the sockets directory to find all running attachable sessions.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { readdir, readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { SocketSessionInfo } from \"./types.js\";\n\n/**\n * Discover all running socket-based sessions.\n *\n * Scans the socket directory for .sock files and reads their corresponding\n * .lock files to extract metadata (PID, cwd, createdAt).\n *\n * Filters out stale sessions (PID no longer running).\n *\n * @param socketDir - Directory containing socket files\n * @returns Array of discovered session info\n */\nexport async function discoverSocketSessions(socketDir: string): Promise<SocketSessionInfo[]> {\n\tif (!existsSync(socketDir)) {\n\t\treturn [];\n\t}\n\n\tconst sessions: SocketSessionInfo[] = [];\n\n\ttry {\n\t\tconst entries = await readdir(socketDir);\n\n\t\tfor (const entry of entries) {\n\t\t\t// Only process .sock files\n\t\t\tif (!entry.endsWith(\".sock\")) continue;\n\n\t\t\tconst sessionId = entry.replace(/\\.sock$/, \"\");\n\t\t\tconst socketPath = path.join(socketDir, entry);\n\t\t\tconst lockPath = path.join(socketDir, `${sessionId}.lock`);\n\n\t\t\t// Check if socket file exists and is a socket\n\t\t\ttry {\n\t\t\t\tconst stats = await stat(socketPath);\n\t\t\t\tif (!stats.isSocket()) continue;\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Read lock file for metadata\n\t\t\tif (!existsSync(lockPath)) continue;\n\n\t\t\ttry {\n\t\t\t\tconst lockContent = await readFile(lockPath, \"utf-8\");\n\t\t\t\tconst lines = lockContent.trim().split(\"\\n\");\n\n\t\t\t\tif (lines.length < 3) continue;\n\n\t\t\t\tconst pid = Number.parseInt(lines[0], 10);\n\t\t\t\tconst cwd = lines[1];\n\t\t\t\tconst createdAt = new Date(lines[2]);\n\n\t\t\t\t// Verify PID is still running\n\t\t\t\tif (!isProcessRunning(pid)) {\n\t\t\t\t\t// Stale socket - skip it (cleanup could be done here)\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tsessions.push({\n\t\t\t\t\tsessionId,\n\t\t\t\t\tsocketPath,\n\t\t\t\t\tpid,\n\t\t\t\t\tcwd,\n\t\t\t\t\tcreatedAt,\n\t\t\t\t});\n\t\t\t} catch {}\n\t\t}\n\t} catch {\n\t\t// Directory not readable - return empty\n\t\treturn [];\n\t}\n\n\treturn sessions;\n}\n\n/**\n * Check if a process with the given PID is running.\n *\n * Uses `process.kill(pid, 0)` which doesn't actually send a signal,\n * but throws if the process doesn't exist.\n */\nfunction isProcessRunning(pid: number): boolean {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"]}
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/core/socket-server/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Socket Session Discovery\n *\n * Scans the sockets directory to find all running attachable sessions.\n *\n * ── OWNERSHIP AND HYGIENE RULES (R35-ALWAYS.3, R35-ALWAYS.4) ───────────────────\n *\n * These rules are implemented TWICE on purpose: here, and synchronously in\n * `packages/geist-core/src/attach/socket-sessions.ts`, which may not import this\n * package across the geist boundary gate. `scripts/check-geist-protocol.mjs`'s\n * mirror clause only covers the relayed FRAMES — it does not cover any of this —\n * so the two files have to be changed together by hand. They had already drifted\n * once (this file used to shield a lock from the orphan sweep before it had\n * established that `<id>.sock` was a socket at all); that drift is fixed here.\n *\n * O1. OURS OR INVISIBLE. An entry whose file uid is not this process's uid, or\n * whose lock names a live process we cannot signal (`kill` → EPERM, i.e. it\n * belongs to another user), is never listed and never dialled. Before this,\n * a world-writable sockets directory holding a 0666 socket and a lock naming\n * root's pid 1 was listed as a live attachable session by both readers and\n * would have been dialled by the bridge; the 0700 directory mode was the\n * only thing in the way, and nothing asserted it.\n * O2. FOREIGN IS NOT REAPED HERE. A read must not destroy what it cannot\n * interpret, and a fleet scan runs on an HTTP request. Foreign entries are\n * skipped. `SocketServer.start()` is the one place allowed to remove them,\n * and only after it has asserted the directory really is ours and owner-only\n * — which makes a foreign file inside it debris by construction.\n * O3. EPERM STILL MEANS ALIVE. `kill(pid, 0)` → EPERM says the process exists.\n * It is never read as dead, so another user's live session is never reaped.\n * What changed is that \"alive\" no longer implies \"ours\".\n * O4. DEBRIS. Two classes used to be immortal — a `.sock` with no `.lock`, and a\n * regular file named `<id>.sock` — because both readers `continue`d past\n * them without reaping. Two such orphans had been sitting in the real\n * `~/.draht/agent/sockets` since 2026-08-21. Both are now reaped once they\n * are older than {@link DEBRIS_GRACE_MS}, which no legitimate transient\n * state survives: the lock is claimed BEFORE the socket is bound, and\n * teardown removes the socket BEFORE the lock, so a socket without a lock is\n * never a normal intermediate state in either direction.\n * O5. A LOCK CANNOT PREDATE THE BOOT. See {@link lockIsPreBootDebris}.\n */\n\nimport type { Stats } from \"node:fs\";\nimport { existsSync } from \"node:fs\";\nimport { lstat, readdir, readFile, rm } from \"node:fs/promises\";\nimport { uptime } from \"node:os\";\nimport path from \"node:path\";\nimport { getSoakLog, SOAK_EVENTS } from \"../soak/soak-log.js\";\nimport type { SocketSessionInfo } from \"./types.js\";\n\n/**\n * How long a file has to sit untouched before it counts as debris rather than as\n * a transient another starter is in the middle of creating.\n *\n * Deliberately the same number as `UNWRITTEN_LOCK_STALE_MS` in `socket-server.ts`\n * and `DEBRIS_GRACE_MS` in geist-core's `socket-sessions.ts`. It is duplicated\n * rather than imported for the boundary reason at the top of this file.\n */\nexport const DEBRIS_GRACE_MS = 10_000;\n\n/**\n * Slack on the boot-time comparison in {@link lockIsPreBootDebris}.\n *\n * `Date.now()` is wall clock and `os.uptime()` is elapsed-since-boot, so their\n * difference moves whenever the clock is stepped. Five minutes is far more than\n * NTP ever steps in one go and far less than the gap between a lock written\n * before a reboot and the reboot itself.\n */\nconst PRE_BOOT_SLACK_MS = 300_000;\n\n/**\n * What one discovery pass removed, and what it deliberately did not.\n *\n * This is the shape of the `sockets_reaped` soak record (R35-ALWAYS.11), and the\n * reason it exists rather than a bare total: Phase 39 has to assert \"zero orphaned\n * .sock/.lock pairs after seven days\" FROM THE LOG, not from one directory listing\n * taken at verdict time — by then the evidence has been tidied away by the very\n * sweep being measured.\n *\n * THE DISTINCTION THAT EARNS ITS KEEP is `reaped.deadPid` against\n * `skipped.foreignPid`. {@link isProcessRunning} answers true on EPERM (O3), so a\n * pid recycled by ANOTHER uid pins its pair as live forever — nothing here can\n * clean that up, and nothing should: the uid checks (O1, O2) are what stop this\n * process from deleting another user's files, and the price of that safety is a\n * pair we can neither use nor remove. A soak that saw only a total would read that\n * immortal pair as a leak in the reaper. Split out, it reads as exactly what it\n * is, and a rising `skipped.foreignPid` on a machine with one user is a real\n * finding rather than noise.\n */\ninterface ReapTally {\n\t/** Files actually unlinked, by why. Counted in FILES, because that is what a directory listing counts. */\n\treaped: {\n\t\t/** A pair whose lock names a process that no longer exists. */\n\t\tdeadPid: number;\n\t\t/** A pair whose lock names a process that started before this machine last booted (O5). */\n\t\tpreBootLock: number;\n\t\t/** A socket with no lock at all, past the debris grace (O4, class i). */\n\t\tlocklessSocket: number;\n\t\t/** A regular file or symlink wearing a `.sock` name, past the debris grace (O4, class ii). */\n\t\tnotASocket: number;\n\t\t/** A lock whose socket is gone and whose owner is gone with it. */\n\t\torphanLockDeadPid: number;\n\t\t/** A lock whose socket is gone and which predates the last boot. */\n\t\torphanLockPreBoot: number;\n\t};\n\t/** Entries left strictly alone, by why. Never an error; each is a rule being obeyed. */\n\tskipped: {\n\t\t/** A `.sock` belonging to another uid (O1). */\n\t\tforeignSocketUid: number;\n\t\t/** A `.lock` belonging to another uid (O1). */\n\t\tforeignLockUid: number;\n\t\t/** Ours to read, but naming a LIVE process of another uid — EPERM (O2, O3). */\n\t\tforeignPid: number;\n\t};\n}\n\nfunction newReapTally(): ReapTally {\n\treturn {\n\t\treaped: {\n\t\t\tdeadPid: 0,\n\t\t\tpreBootLock: 0,\n\t\t\tlocklessSocket: 0,\n\t\t\tnotASocket: 0,\n\t\t\torphanLockDeadPid: 0,\n\t\t\torphanLockPreBoot: 0,\n\t\t},\n\t\tskipped: { foreignSocketUid: 0, foreignLockUid: 0, foreignPid: 0 },\n\t};\n}\n\n/** Total files unlinked in this pass. */\nfunction reapedFileCount(tally: ReapTally): number {\n\treturn Object.values(tally.reaped).reduce((total, count) => total + count, 0);\n}\n\n/** Total entries left alone for an ownership reason. */\nfunction skippedCount(tally: ReapTally): number {\n\treturn Object.values(tally.skipped).reduce((total, count) => total + count, 0);\n}\n\n/**\n * Publish one pass's tally, and only when it has something to say.\n *\n * A quiet sweep writes nothing: `discoverSocketSessions` runs on every session\n * start and on every fleet read, and a record per no-op scan would be the bulk of\n * a seven-day log. Silence here therefore means \"nothing was removed and nothing\n * was skipped\", which is the common case and the one a verdict does not need\n * evidence for.\n *\n * Never stdout, never stderr, never a throw — a hygiene sweep may not be what\n * breaks a session start.\n *\n * NO `sessionId` IS SUPPLIED HERE, on purpose. The writer stamps its own whenever\n * it has one, which it does for every session process — the id is set at bind,\n * before `SocketServer.start()` runs this sweep. The one caller that reaches this\n * function without a session of its own is `draht --list-sessions`, and a sweep\n * performed by a process that owns no session is not attributable to one; the\n * record is written without the field rather than with a borrowed value.\n */\nfunction recordReapTally(socketDir: string, tally: ReapTally, scanned: number, live: number): void {\n\tconst count = reapedFileCount(tally);\n\tconst skipped = skippedCount(tally);\n\tif (count === 0 && skipped === 0) return;\n\ttry {\n\t\tgetSoakLog().record(\n\t\t\tSOAK_EVENTS.SOCKETS_REAPED,\n\t\t\t{\n\t\t\t\t// FILES, not pairs: a dead session contributes its `.sock` and its `.lock`\n\t\t\t\t// separately, so this number can be compared against a `readdir` difference.\n\t\t\t\tcount,\n\t\t\t\treaped: tally.reaped,\n\t\t\t\tskipped: tally.skipped,\n\t\t\t\tskippedCount: skipped,\n\t\t\t\tsocketDir,\n\t\t\t\tscanned,\n\t\t\t\tlive,\n\t\t\t},\n\t\t\tcount > 0 ? \"warn\" : \"info\",\n\t\t);\n\t} catch {\n\t\t// Deliberately empty, and deliberately not logged anywhere.\n\t}\n}\n\n/** What this process may do about the process a lock names. */\nexport type PidOwnership =\n\t/** Alive and signallable by us: a session this user is running. */\n\t| \"ours\"\n\t/** Alive, but `kill` says EPERM — it belongs to another user. */\n\t| \"foreign\"\n\t/** No such process. */\n\t| \"dead\";\n\n/**\n * Who owns the process a lock names.\n *\n * `process.kill(pid, 0)` sends no signal; it only asks whether the pid could be\n * signalled. EPERM is the discriminator that costs nothing: a process this uid\n * could have started is always signallable by this uid, so EPERM means alive AND\n * not ours. That single distinction is what R35-ALWAYS.3 rests on — without it a\n * lock naming root's pid 1 reads as a live session of ours forever.\n */\nexport function pidOwnership(pid: number): PidOwnership {\n\tif (!Number.isInteger(pid) || pid <= 0) return \"dead\";\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn \"ours\";\n\t} catch (error) {\n\t\treturn (error as NodeJS.ErrnoException)?.code === \"EPERM\" ? \"foreign\" : \"dead\";\n\t}\n}\n\n/**\n * Check if a process with the given PID is running.\n *\n * Uses `process.kill(pid, 0)` which doesn't actually send a signal,\n * but throws if the process doesn't exist.\n *\n * EPERM means the process exists but belongs to another user: alive, and still\n * reported as alive (O3). Callers that also care WHOSE it is ask\n * {@link pidOwnership} instead.\n */\nexport function isProcessRunning(pid: number): boolean {\n\treturn pidOwnership(pid) !== \"dead\";\n}\n\n/** This process's uid, or null off POSIX where the concept does not exist. */\nexport function currentUid(): number | null {\n\treturn typeof process.getuid === \"function\" ? process.getuid() : null;\n}\n\n/** Whether a directory entry belongs to this uid. Always true off POSIX. */\nfunction ownedByUs(info: Stats, uid: number | null): boolean {\n\treturn uid === null || info.uid === uid;\n}\n\n/** Whether a file has sat untouched long enough to count as debris. */\nfunction olderThanGrace(info: Stats, now: number): boolean {\n\treturn now - info.mtimeMs > DEBRIS_GRACE_MS;\n}\n\n/** Epoch milliseconds at which this machine booted. */\nfunction bootEpochMs(): number {\n\treturn Date.now() - uptime() * 1000;\n}\n\n/**\n * A lock recording a process that started before this machine last booted.\n *\n * This is the answer to \"bound readable-pid locks\" (R35-ALWAYS.4). The two\n * candidates were recording the owner's start time and comparing it, or putting a\n * blanket age bound on readable-pid locks. **A blanket age bound is rejected**: a\n * draht session legitimately runs for days, and reaping a live session's lock is\n * worse than the leak it cures — the id becomes claimable while the socket is\n * still bound, and two processes end up appending to one session JSONL.\n *\n * So the lock carries the owning process's start time as a 4th line, and the only\n * comparison made is the one that cannot produce a false positive on a live\n * session: nothing running now started before the last boot. That covers the\n * dominant real-world source of pid recycling — a reboot recycles every pid at\n * once, which is how a lock naming pid 1 comes to poison a session id forever.\n *\n * Line 3 (the ISO creation time) is used when line 4 is absent, so the locks\n * already on disk from older builds are covered too. Old 3-line locks still parse:\n * the length floor stays at 3.\n *\n * NOT covered: a same-uid pid recycled without a reboot. That needs the owner's\n * real start time from the OS, which costs a subprocess per lock on a path that\n * runs on every fleet read.\n */\nfunction lockIsPreBootDebris(lock: ParsedLock, bootMs: number): boolean {\n\treturn lock.startedAtMs !== null && lock.startedAtMs < bootMs - PRE_BOOT_SLACK_MS;\n}\n\ninterface ParsedLock {\n\tpid: number;\n\tcwd: string;\n\tcreatedAt: Date;\n\t/** Owner's process start time in epoch ms, from line 4, or line 3 as a floor. */\n\tstartedAtMs: number | null;\n}\n\n/** Parse a lock file's contents, or null when it says nothing trustworthy. */\nfunction parseLock(contents: string): ParsedLock | null {\n\tconst lines = contents.trim().split(\"\\n\");\n\t// Three lines is still the contract. A 4th line is additive; a build that does\n\t// not write one is read exactly as before.\n\tif (lines.length < 3) return null;\n\tconst pid = Number.parseInt(lines[0], 10);\n\tif (!Number.isInteger(pid) || pid <= 0) return null;\n\tconst createdAt = new Date(lines[2]);\n\tconst fromLine4 = lines.length >= 4 ? Number.parseInt(lines[3], 10) : Number.NaN;\n\tconst startedAtMs = Number.isFinite(fromLine4)\n\t\t? fromLine4\n\t\t: Number.isFinite(createdAt.getTime())\n\t\t\t? createdAt.getTime()\n\t\t\t: null;\n\treturn { pid, cwd: lines[1], createdAt, startedAtMs };\n}\n\n/** Read and parse a lock file, or null when it is missing or half-written. */\nasync function readLock(lockPath: string): Promise<ParsedLock | null> {\n\ttry {\n\t\treturn parseLock(await readFile(lockPath, \"utf-8\"));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Discover all running socket-based sessions.\n *\n * Scans the socket directory for .sock files and reads their corresponding\n * .lock files to extract metadata (PID, cwd, createdAt).\n *\n * Only sessions belonging to this uid are returned, and reaping follows the rules\n * at the top of this file: dead-owner pairs, pre-boot locks, lockless sockets and\n * non-socket `<id>.sock` files go; anything foreign, fresh, or unreadable stays.\n *\n * @param socketDir - Directory containing socket files\n * @returns Array of discovered session info\n */\nexport async function discoverSocketSessions(socketDir: string): Promise<SocketSessionInfo[]> {\n\tif (!existsSync(socketDir)) {\n\t\treturn [];\n\t}\n\n\tconst sessions: SocketSessionInfo[] = [];\n\tconst uid = currentUid();\n\tconst now = Date.now();\n\tconst bootMs = bootEpochMs();\n\tconst tally = newReapTally();\n\n\ttry {\n\t\tconst entries = await readdir(socketDir);\n\t\tconst sessionIdsWithSocket = new Set<string>();\n\n\t\tfor (const entry of entries) {\n\t\t\t// Only process .sock files\n\t\t\tif (!entry.endsWith(\".sock\")) continue;\n\n\t\t\tconst sessionId = entry.slice(0, -\".sock\".length);\n\t\t\tif (sessionId.length === 0) continue;\n\t\t\tconst socketPath = path.join(socketDir, entry);\n\t\t\tconst lockPath = path.join(socketDir, `${sessionId}.lock`);\n\n\t\t\t// lstat, not stat: a symlink named `<id>.sock` is not a socket we published,\n\t\t\t// and following it would let something outside the directory decide what this\n\t\t\t// scan sees.\n\t\t\tlet socketInfo: Stats;\n\t\t\ttry {\n\t\t\t\tsocketInfo = await lstat(socketPath);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!socketInfo.isSocket()) {\n\t\t\t\t// Debris class (ii): a regular file (or symlink) wearing a .sock name.\n\t\t\t\t// Neither reader could ever remove one before. Directories are left alone —\n\t\t\t\t// removing a tree is not this function's business.\n\t\t\t\tif (!socketInfo.isDirectory() && ownedByUs(socketInfo, uid) && olderThanGrace(socketInfo, now)) {\n\t\t\t\t\tawait reapStaleSession(socketPath);\n\t\t\t\t\ttally.reaped.notASocket++;\n\t\t\t\t}\n\t\t\t\t// Deliberately NOT added to sessionIdsWithSocket: this id has no socket, so\n\t\t\t\t// its lock belongs to the orphan sweep below. Shielding it here (the old\n\t\t\t\t// behaviour, and the drift from geist-core) is what made class (ii) immortal.\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// O1: another user's socket is not ours to list, dial, or delete.\n\t\t\tif (!ownedByUs(socketInfo, uid)) {\n\t\t\t\ttally.skipped.foreignSocketUid++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tsessionIdsWithSocket.add(sessionId);\n\n\t\t\tlet lockInfo: Stats | null;\n\t\t\ttry {\n\t\t\t\tlockInfo = await lstat(lockPath);\n\t\t\t} catch {\n\t\t\t\tlockInfo = null;\n\t\t\t}\n\n\t\t\tif (lockInfo === null) {\n\t\t\t\t// Debris class (i): a socket with no lock. Never a normal transient — the\n\t\t\t\t// lock is claimed before the bind, and teardown removes the socket first.\n\t\t\t\tif (olderThanGrace(socketInfo, now)) {\n\t\t\t\t\tawait reapStaleSession(socketPath);\n\t\t\t\t\ttally.reaped.locklessSocket++;\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// A lock that is not a plain file, or is not ours, is not evidence about a\n\t\t\t// session of ours. Left strictly alone.\n\t\t\tif (!lockInfo.isFile() || !ownedByUs(lockInfo, uid)) {\n\t\t\t\tif (!ownedByUs(lockInfo, uid)) tally.skipped.foreignLockUid++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst lock = await readLock(lockPath);\n\t\t\t// Unreadable or half-written: ownership unknown, never guess.\n\t\t\tif (!lock) continue;\n\n\t\t\tconst ownership = pidOwnership(lock.pid);\n\t\t\tif (ownership === \"dead\" || lockIsPreBootDebris(lock, bootMs)) {\n\t\t\t\tawait reapStaleSession(socketPath, lockPath);\n\t\t\t\t// Two files, and counted as two: this number is compared against a\n\t\t\t\t// directory listing, which cannot see pairs.\n\t\t\t\tif (ownership === \"dead\") tally.reaped.deadPid += 2;\n\t\t\t\telse tally.reaped.preBootLock += 2;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\t// Alive, but another user's process: never listed (O1), never reaped (O2).\n\t\t\tif (ownership === \"foreign\") {\n\t\t\t\ttally.skipped.foreignPid++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tsessions.push({\n\t\t\t\tsessionId,\n\t\t\t\tsocketPath,\n\t\t\t\tpid: lock.pid,\n\t\t\t\tcwd: lock.cwd,\n\t\t\t\tcreatedAt: lock.createdAt,\n\t\t\t});\n\t\t}\n\n\t\tawait reapOrphanedLocks(socketDir, entries, sessionIdsWithSocket, uid, bootMs, tally);\n\t\trecordReapTally(socketDir, tally, entries.length, sessions.length);\n\t} catch {\n\t\t// Directory not readable - return empty\n\t\treturn [];\n\t}\n\n\treturn sessions;\n}\n\n/**\n * Remove the files of a session that can never accept a connection again.\n *\n * Best effort: a concurrent reaper or a permission problem must never turn a\n * discovery call into a failure.\n */\nasync function reapStaleSession(...paths: string[]): Promise<void> {\n\tfor (const target of paths) {\n\t\ttry {\n\t\t\tawait rm(target, { force: true });\n\t\t} catch {}\n\t}\n}\n\n/**\n * Remove `.lock` files whose `.sock` is already gone and whose owner is provably\n * gone with it.\n *\n * Such locks are invisible to the `.sock` scan above, so without this they accumulate\n * forever. A lock with no socket is also the normal state for a moment during startup -\n * the lock is claimed before the socket is bound - so a lock whose PID is alive, or\n * whose PID cannot be read at all, is always left alone. A lock belonging to another\n * uid, or naming another user's live process, is left alone too (O1, O2).\n */\nasync function reapOrphanedLocks(\n\tsocketDir: string,\n\tentries: string[],\n\tsessionIdsWithSocket: Set<string>,\n\tuid: number | null,\n\tbootMs: number,\n\ttally: ReapTally,\n): Promise<void> {\n\tfor (const entry of entries) {\n\t\tif (!entry.endsWith(\".lock\")) continue;\n\t\tif (sessionIdsWithSocket.has(entry.slice(0, -\".lock\".length))) continue;\n\n\t\tconst lockPath = path.join(socketDir, entry);\n\t\ttry {\n\t\t\tconst info = await lstat(lockPath);\n\t\t\tif (!info.isFile() || !ownedByUs(info, uid)) {\n\t\t\t\tif (!ownedByUs(info, uid)) tally.skipped.foreignLockUid++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst lock = await readLock(lockPath);\n\t\t\t// Unreadable ownership: never guess, leave it alone.\n\t\t\tif (!lock) continue;\n\t\t\tconst ownership = pidOwnership(lock.pid);\n\t\t\tif (ownership === \"dead\" || lockIsPreBootDebris(lock, bootMs)) {\n\t\t\t\tawait rm(lockPath, { force: true });\n\t\t\t\tif (ownership === \"dead\") tally.reaped.orphanLockDeadPid++;\n\t\t\t\telse tally.reaped.orphanLockPreBoot++;\n\t\t\t} else if (ownership === \"foreign\") {\n\t\t\t\ttally.skipped.foreignPid++;\n\t\t\t}\n\t\t} catch {}\n\t}\n}\n"]}
@@ -3,11 +3,17 @@
3
3
  *
4
4
  * Enables tmux-style multi-client attachment to draht sessions.
5
5
  */
6
- export { discoverSocketSessions } from "./discovery.js";
7
- export type { AttachableSessionOptions } from "./session-integration.js";
8
- export { makeSessionAttachable } from "./session-integration.js";
6
+ export { discoverSocketSessions, isProcessRunning } from "./discovery.js";
7
+ export type { DeliverableAsk, PermissionDeliveryOptions } from "./permission-delivery.js";
8
+ export { PermissionDelivery } from "./permission-delivery.js";
9
+ export type { PermissionEntry, PermissionInsert, PermissionRegistryOptions, RegisteredOption, SettleResult, TerminalDecision, } from "./permission-registry.js";
10
+ export { DEFAULT_PERMISSION_EXPIRY_MS, MAX_PERMISSION_EXPIRY_MS, MIN_PERMISSION_EXPIRY_MS, PERMISSION_EXPIRY_ENV, PermissionRegistry, resolvePermissionExpiryMs, } from "./permission-registry.js";
11
+ export type { PermissionRecorder, PermissionSocketServer, SocketPermissionRelay, SocketPermissionRelayOptions, } from "./permission-relay.js";
12
+ export { createSocketPermissionRelay } from "./permission-relay.js";
13
+ export type { AttachableSession, AttachableSessionOptions } from "./session-integration.js";
14
+ export { makeSessionAttachable, registerAttachableSessionCleanup } from "./session-integration.js";
9
15
  export { SocketClient } from "./socket-client.js";
10
16
  export type { SocketServerOptions } from "./socket-server.js";
11
- export { SocketServer } from "./socket-server.js";
17
+ export { DEFAULT_MAX_LIVE_SOCKETS, SocketCapReachedError, SocketDirectoryUnsafeError, SocketServer, SocketSessionBusyError, } from "./socket-server.js";
12
18
  export * from "./types.js";
13
19
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/socket-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EACX,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACN,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,sBAAsB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}
@@ -3,9 +3,12 @@
3
3
  *
4
4
  * Enables tmux-style multi-client attachment to draht sessions.
5
5
  */
6
- export { discoverSocketSessions } from "./discovery.js";
7
- export { makeSessionAttachable } from "./session-integration.js";
6
+ export { discoverSocketSessions, isProcessRunning } from "./discovery.js";
7
+ export { PermissionDelivery } from "./permission-delivery.js";
8
+ export { DEFAULT_PERMISSION_EXPIRY_MS, MAX_PERMISSION_EXPIRY_MS, MIN_PERMISSION_EXPIRY_MS, PERMISSION_EXPIRY_ENV, PermissionRegistry, resolvePermissionExpiryMs, } from "./permission-registry.js";
9
+ export { createSocketPermissionRelay } from "./permission-relay.js";
10
+ export { makeSessionAttachable, registerAttachableSessionCleanup } from "./session-integration.js";
8
11
  export { SocketClient } from "./socket-client.js";
9
- export { SocketServer } from "./socket-server.js";
12
+ export { DEFAULT_MAX_LIVE_SOCKETS, SocketCapReachedError, SocketDirectoryUnsafeError, SocketServer, SocketSessionBusyError, } from "./socket-server.js";
10
13
  export * from "./types.js";
11
14
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/socket-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,cAAc,YAAY,CAAC","sourcesContent":["/**\n * Socket Server - Attachable session infrastructure\n *\n * Enables tmux-style multi-client attachment to draht sessions.\n */\n\nexport { discoverSocketSessions } from \"./discovery.js\";\nexport type { AttachableSessionOptions } from \"./session-integration.js\";\nexport { makeSessionAttachable } from \"./session-integration.js\";\nexport { SocketClient } from \"./socket-client.js\";\nexport type { SocketServerOptions } from \"./socket-server.js\";\nexport { SocketServer } from \"./socket-server.js\";\nexport * from \"./types.js\";\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/socket-server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAS9D,OAAO,EACN,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACN,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,sBAAsB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC","sourcesContent":["/**\n * Socket Server - Attachable session infrastructure\n *\n * Enables tmux-style multi-client attachment to draht sessions.\n */\n\nexport { discoverSocketSessions, isProcessRunning } from \"./discovery.js\";\nexport type { DeliverableAsk, PermissionDeliveryOptions } from \"./permission-delivery.js\";\nexport { PermissionDelivery } from \"./permission-delivery.js\";\nexport type {\n\tPermissionEntry,\n\tPermissionInsert,\n\tPermissionRegistryOptions,\n\tRegisteredOption,\n\tSettleResult,\n\tTerminalDecision,\n} from \"./permission-registry.js\";\nexport {\n\tDEFAULT_PERMISSION_EXPIRY_MS,\n\tMAX_PERMISSION_EXPIRY_MS,\n\tMIN_PERMISSION_EXPIRY_MS,\n\tPERMISSION_EXPIRY_ENV,\n\tPermissionRegistry,\n\tresolvePermissionExpiryMs,\n} from \"./permission-registry.js\";\nexport type {\n\tPermissionRecorder,\n\tPermissionSocketServer,\n\tSocketPermissionRelay,\n\tSocketPermissionRelayOptions,\n} from \"./permission-relay.js\";\nexport { createSocketPermissionRelay } from \"./permission-relay.js\";\nexport type { AttachableSession, AttachableSessionOptions } from \"./session-integration.js\";\nexport { makeSessionAttachable, registerAttachableSessionCleanup } from \"./session-integration.js\";\nexport { SocketClient } from \"./socket-client.js\";\nexport type { SocketServerOptions } from \"./socket-server.js\";\nexport {\n\tDEFAULT_MAX_LIVE_SOCKETS,\n\tSocketCapReachedError,\n\tSocketDirectoryUnsafeError,\n\tSocketServer,\n\tSocketSessionBusyError,\n} from \"./socket-server.js\";\nexport * from \"./types.js\";\n"]}