@punch-bot/cli 0.85.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1147) hide show
  1. package/CHANGELOG.md +5709 -0
  2. package/README.md +718 -0
  3. package/dist/bun/cli.d.ts +5 -0
  4. package/dist/bun/cli.d.ts.map +1 -0
  5. package/dist/bun/cli.js +5 -0
  6. package/dist/bun/cli.js.map +1 -0
  7. package/dist/bun/restore-sandbox-env.d.ts +17 -0
  8. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  9. package/dist/bun/restore-sandbox-env.js +36 -0
  10. package/dist/bun/restore-sandbox-env.js.map +1 -0
  11. package/dist/bun/runtime-setup.d.ts +2 -0
  12. package/dist/bun/runtime-setup.d.ts.map +1 -0
  13. package/dist/bun/runtime-setup.js +9 -0
  14. package/dist/bun/runtime-setup.js.map +1 -0
  15. package/dist/bun/sandbox-env-setup.d.ts +2 -0
  16. package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
  17. package/dist/bun/sandbox-env-setup.js +4 -0
  18. package/dist/bun/sandbox-env-setup.js.map +1 -0
  19. package/dist/bundle/chunks/anthropic-messages-ASRU76PT.js +6 -0
  20. package/dist/bundle/chunks/anthropic.js +75 -0
  21. package/dist/bundle/chunks/azure-openai-responses-UGF6LMEX.js +2 -0
  22. package/dist/bundle/chunks/bedrock-converse-stream.js +77 -0
  23. package/dist/bundle/chunks/chunk-3DNTDXPG.js +44 -0
  24. package/dist/bundle/chunks/chunk-4L3WN2XY.js +2 -0
  25. package/dist/bundle/chunks/chunk-5PRUVL6W.js +1770 -0
  26. package/dist/bundle/chunks/chunk-6CYCI3EJ.js +12 -0
  27. package/dist/bundle/chunks/chunk-6R7UI4IY.js +2 -0
  28. package/dist/bundle/chunks/chunk-A3JYRWB6.js +2 -0
  29. package/dist/bundle/chunks/chunk-CHB3CEFP.js +2 -0
  30. package/dist/bundle/chunks/chunk-DRQDKNXA.js +2 -0
  31. package/dist/bundle/chunks/chunk-ELBMWBDG.js +11 -0
  32. package/dist/bundle/chunks/chunk-GMWCTUPB.js +2 -0
  33. package/dist/bundle/chunks/chunk-GTBU4EAF.js +2 -0
  34. package/dist/bundle/chunks/chunk-L2ZPNLYD.js +2 -0
  35. package/dist/bundle/chunks/chunk-NUHFSC37.js +25 -0
  36. package/dist/bundle/chunks/chunk-PATAL4PO.js +2 -0
  37. package/dist/bundle/chunks/chunk-PGXDEOVV.js +2 -0
  38. package/dist/bundle/chunks/chunk-PJACZCIR.js +2 -0
  39. package/dist/bundle/chunks/chunk-PRRNXB7S.js +2 -0
  40. package/dist/bundle/chunks/chunk-QQO2NSV6.js +6 -0
  41. package/dist/bundle/chunks/chunk-TEPMHNKQ.js +2 -0
  42. package/dist/bundle/chunks/chunk-TRDNDS6A.js +4 -0
  43. package/dist/bundle/chunks/chunk-UIWY7TU5.js +42 -0
  44. package/dist/bundle/chunks/chunk-USJZMAIR.js +2 -0
  45. package/dist/bundle/chunks/chunk-XDUWOHPL.js +6 -0
  46. package/dist/bundle/chunks/chunk-XNGRGP62.js +2 -0
  47. package/dist/bundle/chunks/github-copilot.js +2 -0
  48. package/dist/bundle/chunks/google-generative-ai-VCD2PGIY.js +2 -0
  49. package/dist/bundle/chunks/google-vertex-L6U34ZRC.js +2 -0
  50. package/dist/bundle/chunks/https-proxy-agent-US7JVRJG.js +9 -0
  51. package/dist/bundle/chunks/image-resize-worker.js +2 -0
  52. package/dist/bundle/chunks/kimi-coding.js +2 -0
  53. package/dist/bundle/chunks/lib-HGQMNYVT.js +9 -0
  54. package/dist/bundle/chunks/mistral-conversations-IXWQ2YKN.js +5 -0
  55. package/dist/bundle/chunks/multipart-parser-SQ6GDJL7.js +3 -0
  56. package/dist/bundle/chunks/node-4PXJTSWH.js +2 -0
  57. package/dist/bundle/chunks/node-5YXRXMVN.js +16 -0
  58. package/dist/bundle/chunks/openai-codex-responses-P7HKQLIT.js +10 -0
  59. package/dist/bundle/chunks/openai-codex.js +75 -0
  60. package/dist/bundle/chunks/openai-completions-O7BFLP3U.js +7 -0
  61. package/dist/bundle/chunks/openai-responses-QAKWAYVG.js +2 -0
  62. package/dist/bundle/chunks/openrouter-images-N4XVVFSD.js +2 -0
  63. package/dist/bundle/chunks/openrouter.js +75 -0
  64. package/dist/bundle/chunks/pi-messages-ZRYGTSON.js +8 -0
  65. package/dist/bundle/chunks/radius.js +75 -0
  66. package/dist/bundle/chunks/src-UK77SYZE.js +4 -0
  67. package/dist/bundle/chunks/xai.js +2 -0
  68. package/dist/bundle/cli.js +3 -0
  69. package/dist/bundle/index.js +2 -0
  70. package/dist/bundle/rpc-entry.js +3 -0
  71. package/dist/cli/args.d.ts +61 -0
  72. package/dist/cli/args.d.ts.map +1 -0
  73. package/dist/cli/args.js +439 -0
  74. package/dist/cli/args.js.map +1 -0
  75. package/dist/cli/auth-check.d.ts +19 -0
  76. package/dist/cli/auth-check.d.ts.map +1 -0
  77. package/dist/cli/auth-check.js +50 -0
  78. package/dist/cli/auth-check.js.map +1 -0
  79. package/dist/cli/auth-command.d.ts +24 -0
  80. package/dist/cli/auth-command.d.ts.map +1 -0
  81. package/dist/cli/auth-command.js +103 -0
  82. package/dist/cli/auth-command.js.map +1 -0
  83. package/dist/cli/config-selector.d.ts +16 -0
  84. package/dist/cli/config-selector.d.ts.map +1 -0
  85. package/dist/cli/config-selector.js +32 -0
  86. package/dist/cli/config-selector.js.map +1 -0
  87. package/dist/cli/credential-print.d.ts +13 -0
  88. package/dist/cli/credential-print.d.ts.map +1 -0
  89. package/dist/cli/credential-print.js +76 -0
  90. package/dist/cli/credential-print.js.map +1 -0
  91. package/dist/cli/file-processor.d.ts +15 -0
  92. package/dist/cli/file-processor.d.ts.map +1 -0
  93. package/dist/cli/file-processor.js +71 -0
  94. package/dist/cli/file-processor.js.map +1 -0
  95. package/dist/cli/initial-message.d.ts +18 -0
  96. package/dist/cli/initial-message.d.ts.map +1 -0
  97. package/dist/cli/initial-message.js +22 -0
  98. package/dist/cli/initial-message.js.map +1 -0
  99. package/dist/cli/list-models.d.ts +9 -0
  100. package/dist/cli/list-models.d.ts.map +1 -0
  101. package/dist/cli/list-models.js +98 -0
  102. package/dist/cli/list-models.js.map +1 -0
  103. package/dist/cli/project-trust.d.ts +10 -0
  104. package/dist/cli/project-trust.d.ts.map +1 -0
  105. package/dist/cli/project-trust.js +48 -0
  106. package/dist/cli/project-trust.js.map +1 -0
  107. package/dist/cli/session-picker.d.ts +10 -0
  108. package/dist/cli/session-picker.d.ts.map +1 -0
  109. package/dist/cli/session-picker.js +36 -0
  110. package/dist/cli/session-picker.js.map +1 -0
  111. package/dist/cli/setup.d.ts +2 -0
  112. package/dist/cli/setup.d.ts.map +1 -0
  113. package/dist/cli/setup.js +12 -0
  114. package/dist/cli/setup.js.map +1 -0
  115. package/dist/cli/startup-ui.d.ts +20 -0
  116. package/dist/cli/startup-ui.d.ts.map +1 -0
  117. package/dist/cli/startup-ui.js +185 -0
  118. package/dist/cli/startup-ui.js.map +1 -0
  119. package/dist/cli.d.ts +3 -0
  120. package/dist/cli.d.ts.map +1 -0
  121. package/dist/cli.js +6 -0
  122. package/dist/cli.js.map +1 -0
  123. package/dist/config.d.ts +98 -0
  124. package/dist/config.d.ts.map +1 -0
  125. package/dist/config.js +464 -0
  126. package/dist/config.js.map +1 -0
  127. package/dist/core/agent-session-runtime.d.ts +119 -0
  128. package/dist/core/agent-session-runtime.d.ts.map +1 -0
  129. package/dist/core/agent-session-runtime.js +317 -0
  130. package/dist/core/agent-session-runtime.js.map +1 -0
  131. package/dist/core/agent-session-services.d.ts +86 -0
  132. package/dist/core/agent-session-services.d.ts.map +1 -0
  133. package/dist/core/agent-session-services.js +134 -0
  134. package/dist/core/agent-session-services.js.map +1 -0
  135. package/dist/core/agent-session.d.ts +683 -0
  136. package/dist/core/agent-session.d.ts.map +1 -0
  137. package/dist/core/agent-session.js +2843 -0
  138. package/dist/core/agent-session.js.map +1 -0
  139. package/dist/core/auth-guidance.d.ts +5 -0
  140. package/dist/core/auth-guidance.d.ts.map +1 -0
  141. package/dist/core/auth-guidance.js +21 -0
  142. package/dist/core/auth-guidance.js.map +1 -0
  143. package/dist/core/auth-storage.d.ts +72 -0
  144. package/dist/core/auth-storage.d.ts.map +1 -0
  145. package/dist/core/auth-storage.js +426 -0
  146. package/dist/core/auth-storage.js.map +1 -0
  147. package/dist/core/bash-executor.d.ts +32 -0
  148. package/dist/core/bash-executor.d.ts.map +1 -0
  149. package/dist/core/bash-executor.js +111 -0
  150. package/dist/core/bash-executor.js.map +1 -0
  151. package/dist/core/cache-stats.d.ts +49 -0
  152. package/dist/core/cache-stats.d.ts.map +1 -0
  153. package/dist/core/cache-stats.js +101 -0
  154. package/dist/core/cache-stats.js.map +1 -0
  155. package/dist/core/compaction/branch-summarization.d.ts +98 -0
  156. package/dist/core/compaction/branch-summarization.d.ts.map +1 -0
  157. package/dist/core/compaction/branch-summarization.js +251 -0
  158. package/dist/core/compaction/branch-summarization.js.map +1 -0
  159. package/dist/core/compaction/compaction.d.ts +143 -0
  160. package/dist/core/compaction/compaction.d.ts.map +1 -0
  161. package/dist/core/compaction/compaction.js +668 -0
  162. package/dist/core/compaction/compaction.js.map +1 -0
  163. package/dist/core/compaction/index.d.ts +7 -0
  164. package/dist/core/compaction/index.d.ts.map +1 -0
  165. package/dist/core/compaction/index.js +7 -0
  166. package/dist/core/compaction/index.js.map +1 -0
  167. package/dist/core/compaction/utils.d.ts +38 -0
  168. package/dist/core/compaction/utils.d.ts.map +1 -0
  169. package/dist/core/compaction/utils.js +142 -0
  170. package/dist/core/compaction/utils.js.map +1 -0
  171. package/dist/core/defaults.d.ts +4 -0
  172. package/dist/core/defaults.d.ts.map +1 -0
  173. package/dist/core/defaults.js +11 -0
  174. package/dist/core/defaults.js.map +1 -0
  175. package/dist/core/delivery.d.ts +82 -0
  176. package/dist/core/delivery.d.ts.map +1 -0
  177. package/dist/core/delivery.js +207 -0
  178. package/dist/core/delivery.js.map +1 -0
  179. package/dist/core/diagnostics.d.ts +15 -0
  180. package/dist/core/diagnostics.d.ts.map +1 -0
  181. package/dist/core/diagnostics.js +2 -0
  182. package/dist/core/diagnostics.js.map +1 -0
  183. package/dist/core/event-bus.d.ts +9 -0
  184. package/dist/core/event-bus.d.ts.map +1 -0
  185. package/dist/core/event-bus.js +25 -0
  186. package/dist/core/event-bus.js.map +1 -0
  187. package/dist/core/exec.d.ts +29 -0
  188. package/dist/core/exec.d.ts.map +1 -0
  189. package/dist/core/exec.js +75 -0
  190. package/dist/core/exec.js.map +1 -0
  191. package/dist/core/experimental.d.ts +2 -0
  192. package/dist/core/experimental.d.ts.map +1 -0
  193. package/dist/core/experimental.js +4 -0
  194. package/dist/core/experimental.js.map +1 -0
  195. package/dist/core/export-html/ansi-to-html.d.ts +22 -0
  196. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -0
  197. package/dist/core/export-html/ansi-to-html.js +249 -0
  198. package/dist/core/export-html/ansi-to-html.js.map +1 -0
  199. package/dist/core/export-html/index.d.ts +37 -0
  200. package/dist/core/export-html/index.d.ts.map +1 -0
  201. package/dist/core/export-html/index.js +226 -0
  202. package/dist/core/export-html/index.js.map +1 -0
  203. package/dist/core/export-html/template.css +1066 -0
  204. package/dist/core/export-html/template.html +55 -0
  205. package/dist/core/export-html/template.js +1864 -0
  206. package/dist/core/export-html/tool-renderer.d.ts +34 -0
  207. package/dist/core/export-html/tool-renderer.d.ts.map +1 -0
  208. package/dist/core/export-html/tool-renderer.js +108 -0
  209. package/dist/core/export-html/tool-renderer.js.map +1 -0
  210. package/dist/core/export-html/vendor/highlight.min.js +1213 -0
  211. package/dist/core/export-html/vendor/marked.min.js +78 -0
  212. package/dist/core/extensions/index.d.ts +12 -0
  213. package/dist/core/extensions/index.d.ts.map +1 -0
  214. package/dist/core/extensions/index.js +9 -0
  215. package/dist/core/extensions/index.js.map +1 -0
  216. package/dist/core/extensions/loader.d.ts +23 -0
  217. package/dist/core/extensions/loader.d.ts.map +1 -0
  218. package/dist/core/extensions/loader.js +650 -0
  219. package/dist/core/extensions/loader.js.map +1 -0
  220. package/dist/core/extensions/runner.d.ts +178 -0
  221. package/dist/core/extensions/runner.d.ts.map +1 -0
  222. package/dist/core/extensions/runner.js +1011 -0
  223. package/dist/core/extensions/runner.js.map +1 -0
  224. package/dist/core/extensions/types.d.ts +1351 -0
  225. package/dist/core/extensions/types.d.ts.map +1 -0
  226. package/dist/core/extensions/types.js +48 -0
  227. package/dist/core/extensions/types.js.map +1 -0
  228. package/dist/core/extensions/wrapper.d.ts +20 -0
  229. package/dist/core/extensions/wrapper.d.ts.map +1 -0
  230. package/dist/core/extensions/wrapper.js +41 -0
  231. package/dist/core/extensions/wrapper.js.map +1 -0
  232. package/dist/core/footer-data-provider.d.ts +64 -0
  233. package/dist/core/footer-data-provider.d.ts.map +1 -0
  234. package/dist/core/footer-data-provider.js +338 -0
  235. package/dist/core/footer-data-provider.js.map +1 -0
  236. package/dist/core/http-dispatcher.d.ts +22 -0
  237. package/dist/core/http-dispatcher.d.ts.map +1 -0
  238. package/dist/core/http-dispatcher.js +98 -0
  239. package/dist/core/http-dispatcher.js.map +1 -0
  240. package/dist/core/index.d.ts +14 -0
  241. package/dist/core/index.d.ts.map +1 -0
  242. package/dist/core/index.js +14 -0
  243. package/dist/core/index.js.map +1 -0
  244. package/dist/core/keybindings.d.ts +428 -0
  245. package/dist/core/keybindings.d.ts.map +1 -0
  246. package/dist/core/keybindings.js +321 -0
  247. package/dist/core/keybindings.js.map +1 -0
  248. package/dist/core/messages.d.ts +77 -0
  249. package/dist/core/messages.d.ts.map +1 -0
  250. package/dist/core/messages.js +123 -0
  251. package/dist/core/messages.js.map +1 -0
  252. package/dist/core/model-config.d.ts +591 -0
  253. package/dist/core/model-config.d.ts.map +1 -0
  254. package/dist/core/model-config.js +259 -0
  255. package/dist/core/model-config.js.map +1 -0
  256. package/dist/core/model-registry.d.ts +49 -0
  257. package/dist/core/model-registry.d.ts.map +1 -0
  258. package/dist/core/model-registry.js +115 -0
  259. package/dist/core/model-registry.js.map +1 -0
  260. package/dist/core/model-resolver.d.ts +124 -0
  261. package/dist/core/model-resolver.d.ts.map +1 -0
  262. package/dist/core/model-resolver.js +589 -0
  263. package/dist/core/model-resolver.js.map +1 -0
  264. package/dist/core/model-runtime.d.ts +101 -0
  265. package/dist/core/model-runtime.d.ts.map +1 -0
  266. package/dist/core/model-runtime.js +602 -0
  267. package/dist/core/model-runtime.js.map +1 -0
  268. package/dist/core/models-store.d.ts +22 -0
  269. package/dist/core/models-store.d.ts.map +1 -0
  270. package/dist/core/models-store.js +115 -0
  271. package/dist/core/models-store.js.map +1 -0
  272. package/dist/core/output-guard.d.ts +7 -0
  273. package/dist/core/output-guard.d.ts.map +1 -0
  274. package/dist/core/output-guard.js +89 -0
  275. package/dist/core/output-guard.js.map +1 -0
  276. package/dist/core/package-manager.d.ts +213 -0
  277. package/dist/core/package-manager.d.ts.map +1 -0
  278. package/dist/core/package-manager.js +2177 -0
  279. package/dist/core/package-manager.js.map +1 -0
  280. package/dist/core/pi-manifest.d.ts +8 -0
  281. package/dist/core/pi-manifest.d.ts.map +1 -0
  282. package/dist/core/pi-manifest.js +26 -0
  283. package/dist/core/pi-manifest.js.map +1 -0
  284. package/dist/core/project-trust.d.ts +15 -0
  285. package/dist/core/project-trust.d.ts.map +1 -0
  286. package/dist/core/project-trust.js +59 -0
  287. package/dist/core/project-trust.js.map +1 -0
  288. package/dist/core/prompt-templates.d.ts +54 -0
  289. package/dist/core/prompt-templates.d.ts.map +1 -0
  290. package/dist/core/prompt-templates.js +236 -0
  291. package/dist/core/prompt-templates.js.map +1 -0
  292. package/dist/core/provider-attribution.d.ts +4 -0
  293. package/dist/core/provider-attribution.d.ts.map +1 -0
  294. package/dist/core/provider-attribution.js +72 -0
  295. package/dist/core/provider-attribution.js.map +1 -0
  296. package/dist/core/provider-composer.d.ts +58 -0
  297. package/dist/core/provider-composer.d.ts.map +1 -0
  298. package/dist/core/provider-composer.js +402 -0
  299. package/dist/core/provider-composer.js.map +1 -0
  300. package/dist/core/radius.d.ts +2 -0
  301. package/dist/core/radius.d.ts.map +1 -0
  302. package/dist/core/radius.js +2 -0
  303. package/dist/core/radius.js.map +1 -0
  304. package/dist/core/remote-catalog-provider.d.ts +5 -0
  305. package/dist/core/remote-catalog-provider.d.ts.map +1 -0
  306. package/dist/core/remote-catalog-provider.js +122 -0
  307. package/dist/core/remote-catalog-provider.js.map +1 -0
  308. package/dist/core/resolve-config-value.d.ts +30 -0
  309. package/dist/core/resolve-config-value.d.ts.map +1 -0
  310. package/dist/core/resolve-config-value.js +247 -0
  311. package/dist/core/resolve-config-value.js.map +1 -0
  312. package/dist/core/resource-loader.d.ts +221 -0
  313. package/dist/core/resource-loader.d.ts.map +1 -0
  314. package/dist/core/resource-loader.js +875 -0
  315. package/dist/core/resource-loader.js.map +1 -0
  316. package/dist/core/runtime-credentials.d.ts +15 -0
  317. package/dist/core/runtime-credentials.d.ts.map +1 -0
  318. package/dist/core/runtime-credentials.js +39 -0
  319. package/dist/core/runtime-credentials.js.map +1 -0
  320. package/dist/core/sdk.d.ts +108 -0
  321. package/dist/core/sdk.d.ts.map +1 -0
  322. package/dist/core/sdk.js +275 -0
  323. package/dist/core/sdk.js.map +1 -0
  324. package/dist/core/session-cwd.d.ts +19 -0
  325. package/dist/core/session-cwd.d.ts.map +1 -0
  326. package/dist/core/session-cwd.js +38 -0
  327. package/dist/core/session-cwd.js.map +1 -0
  328. package/dist/core/session-export.d.ts +4 -0
  329. package/dist/core/session-export.d.ts.map +1 -0
  330. package/dist/core/session-export.js +32 -0
  331. package/dist/core/session-export.js.map +1 -0
  332. package/dist/core/session-manager.d.ts +357 -0
  333. package/dist/core/session-manager.d.ts.map +1 -0
  334. package/dist/core/session-manager.js +1370 -0
  335. package/dist/core/session-manager.js.map +1 -0
  336. package/dist/core/settings-diagnostics.d.ts +9 -0
  337. package/dist/core/settings-diagnostics.d.ts.map +1 -0
  338. package/dist/core/settings-diagnostics.js +21 -0
  339. package/dist/core/settings-diagnostics.js.map +1 -0
  340. package/dist/core/settings-manager.d.ts +340 -0
  341. package/dist/core/settings-manager.d.ts.map +1 -0
  342. package/dist/core/settings-manager.js +1021 -0
  343. package/dist/core/settings-manager.js.map +1 -0
  344. package/dist/core/skills.d.ts +60 -0
  345. package/dist/core/skills.d.ts.map +1 -0
  346. package/dist/core/skills.js +407 -0
  347. package/dist/core/skills.js.map +1 -0
  348. package/dist/core/slash-commands.d.ts +15 -0
  349. package/dist/core/slash-commands.d.ts.map +1 -0
  350. package/dist/core/slash-commands.js +27 -0
  351. package/dist/core/slash-commands.js.map +1 -0
  352. package/dist/core/source-info.d.ts +18 -0
  353. package/dist/core/source-info.d.ts.map +1 -0
  354. package/dist/core/source-info.js +19 -0
  355. package/dist/core/source-info.js.map +1 -0
  356. package/dist/core/system-prompt.d.ts +28 -0
  357. package/dist/core/system-prompt.d.ts.map +1 -0
  358. package/dist/core/system-prompt.js +177 -0
  359. package/dist/core/system-prompt.js.map +1 -0
  360. package/dist/core/telemetry.d.ts +3 -0
  361. package/dist/core/telemetry.d.ts.map +1 -0
  362. package/dist/core/telemetry.js +9 -0
  363. package/dist/core/telemetry.js.map +1 -0
  364. package/dist/core/timings.d.ts +10 -0
  365. package/dist/core/timings.d.ts.map +1 -0
  366. package/dist/core/timings.js +41 -0
  367. package/dist/core/timings.js.map +1 -0
  368. package/dist/core/tools/bash.d.ts +87 -0
  369. package/dist/core/tools/bash.d.ts.map +1 -0
  370. package/dist/core/tools/bash.js +295 -0
  371. package/dist/core/tools/bash.js.map +1 -0
  372. package/dist/core/tools/edit-diff.d.ts +101 -0
  373. package/dist/core/tools/edit-diff.d.ts.map +1 -0
  374. package/dist/core/tools/edit-diff.js +421 -0
  375. package/dist/core/tools/edit-diff.js.map +1 -0
  376. package/dist/core/tools/edit.d.ts +44 -0
  377. package/dist/core/tools/edit.d.ts.map +1 -0
  378. package/dist/core/tools/edit.js +147 -0
  379. package/dist/core/tools/edit.js.map +1 -0
  380. package/dist/core/tools/file-mutation-queue.d.ts +6 -0
  381. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -0
  382. package/dist/core/tools/file-mutation-queue.js +52 -0
  383. package/dist/core/tools/file-mutation-queue.js.map +1 -0
  384. package/dist/core/tools/find.d.ts +42 -0
  385. package/dist/core/tools/find.d.ts.map +1 -0
  386. package/dist/core/tools/find.js +251 -0
  387. package/dist/core/tools/find.js.map +1 -0
  388. package/dist/core/tools/grep.d.ts +41 -0
  389. package/dist/core/tools/grep.d.ts.map +1 -0
  390. package/dist/core/tools/grep.js +252 -0
  391. package/dist/core/tools/grep.js.map +1 -0
  392. package/dist/core/tools/index.d.ts +43 -0
  393. package/dist/core/tools/index.d.ts.map +1 -0
  394. package/dist/core/tools/index.js +129 -0
  395. package/dist/core/tools/index.js.map +1 -0
  396. package/dist/core/tools/ls.d.ts +41 -0
  397. package/dist/core/tools/ls.d.ts.map +1 -0
  398. package/dist/core/tools/ls.js +126 -0
  399. package/dist/core/tools/ls.js.map +1 -0
  400. package/dist/core/tools/output-accumulator.d.ts +52 -0
  401. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  402. package/dist/core/tools/output-accumulator.js +184 -0
  403. package/dist/core/tools/output-accumulator.js.map +1 -0
  404. package/dist/core/tools/path-utils.d.ts +10 -0
  405. package/dist/core/tools/path-utils.d.ts.map +1 -0
  406. package/dist/core/tools/path-utils.js +99 -0
  407. package/dist/core/tools/path-utils.js.map +1 -0
  408. package/dist/core/tools/powershell.d.ts +16 -0
  409. package/dist/core/tools/powershell.d.ts.map +1 -0
  410. package/dist/core/tools/powershell.js +39 -0
  411. package/dist/core/tools/powershell.js.map +1 -0
  412. package/dist/core/tools/read.d.ts +39 -0
  413. package/dist/core/tools/read.d.ts.map +1 -0
  414. package/dist/core/tools/read.js +165 -0
  415. package/dist/core/tools/read.js.map +1 -0
  416. package/dist/core/tools/render-utils.d.ts +24 -0
  417. package/dist/core/tools/render-utils.d.ts.map +1 -0
  418. package/dist/core/tools/render-utils.js +65 -0
  419. package/dist/core/tools/render-utils.js.map +1 -0
  420. package/dist/core/tools/renderers/bash.d.ts +12 -0
  421. package/dist/core/tools/renderers/bash.d.ts.map +1 -0
  422. package/dist/core/tools/renderers/bash.js +130 -0
  423. package/dist/core/tools/renderers/bash.js.map +1 -0
  424. package/dist/core/tools/renderers/edit.d.ts +23 -0
  425. package/dist/core/tools/renderers/edit.d.ts.map +1 -0
  426. package/dist/core/tools/renderers/edit.js +167 -0
  427. package/dist/core/tools/renderers/edit.js.map +1 -0
  428. package/dist/core/tools/renderers/find.d.ts +10 -0
  429. package/dist/core/tools/renderers/find.d.ts.map +1 -0
  430. package/dist/core/tools/renderers/find.js +64 -0
  431. package/dist/core/tools/renderers/find.js.map +1 -0
  432. package/dist/core/tools/renderers/grep.d.ts +10 -0
  433. package/dist/core/tools/renderers/grep.d.ts.map +1 -0
  434. package/dist/core/tools/renderers/grep.js +69 -0
  435. package/dist/core/tools/renderers/grep.js.map +1 -0
  436. package/dist/core/tools/renderers/index.d.ts +28 -0
  437. package/dist/core/tools/renderers/index.d.ts.map +1 -0
  438. package/dist/core/tools/renderers/index.js +47 -0
  439. package/dist/core/tools/renderers/index.js.map +1 -0
  440. package/dist/core/tools/renderers/ls.d.ts +10 -0
  441. package/dist/core/tools/renderers/ls.d.ts.map +1 -0
  442. package/dist/core/tools/renderers/ls.js +58 -0
  443. package/dist/core/tools/renderers/ls.js.map +1 -0
  444. package/dist/core/tools/renderers/read.d.ts +11 -0
  445. package/dist/core/tools/renderers/read.d.ts.map +1 -0
  446. package/dist/core/tools/renderers/read.js +129 -0
  447. package/dist/core/tools/renderers/read.js.map +1 -0
  448. package/dist/core/tools/renderers/write.d.ts +10 -0
  449. package/dist/core/tools/renderers/write.d.ts.map +1 -0
  450. package/dist/core/tools/renderers/write.js +153 -0
  451. package/dist/core/tools/renderers/write.js.map +1 -0
  452. package/dist/core/tools/tool-definition-wrapper.d.ts +14 -0
  453. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -0
  454. package/dist/core/tools/tool-definition-wrapper.js +36 -0
  455. package/dist/core/tools/tool-definition-wrapper.js.map +1 -0
  456. package/dist/core/tools/truncate.d.ts +70 -0
  457. package/dist/core/tools/truncate.d.ts.map +1 -0
  458. package/dist/core/tools/truncate.js +215 -0
  459. package/dist/core/tools/truncate.js.map +1 -0
  460. package/dist/core/tools/write.d.ts +30 -0
  461. package/dist/core/tools/write.d.ts.map +1 -0
  462. package/dist/core/tools/write.js +61 -0
  463. package/dist/core/tools/write.js.map +1 -0
  464. package/dist/core/trust-manager.d.ts +36 -0
  465. package/dist/core/trust-manager.d.ts.map +1 -0
  466. package/dist/core/trust-manager.js +203 -0
  467. package/dist/core/trust-manager.js.map +1 -0
  468. package/dist/core/usage-totals.d.ts +19 -0
  469. package/dist/core/usage-totals.d.ts.map +1 -0
  470. package/dist/core/usage-totals.js +52 -0
  471. package/dist/core/usage-totals.js.map +1 -0
  472. package/dist/extensions/browser/index.d.ts +3 -0
  473. package/dist/extensions/browser/index.d.ts.map +1 -0
  474. package/dist/extensions/browser/index.js +208 -0
  475. package/dist/extensions/browser/index.js.map +1 -0
  476. package/dist/extensions/context-pruning/compress_context.d.ts +3 -0
  477. package/dist/extensions/context-pruning/compress_context.d.ts.map +1 -0
  478. package/dist/extensions/context-pruning/compress_context.js +241 -0
  479. package/dist/extensions/context-pruning/compress_context.js.map +1 -0
  480. package/dist/extensions/context-pruning/context-pruning-state.d.ts +60 -0
  481. package/dist/extensions/context-pruning/context-pruning-state.d.ts.map +1 -0
  482. package/dist/extensions/context-pruning/context-pruning-state.js +238 -0
  483. package/dist/extensions/context-pruning/context-pruning-state.js.map +1 -0
  484. package/dist/extensions/index.d.ts +3 -0
  485. package/dist/extensions/index.d.ts.map +1 -0
  486. package/dist/extensions/index.js +19 -0
  487. package/dist/extensions/index.js.map +1 -0
  488. package/dist/extensions/llama/client.d.ts +67 -0
  489. package/dist/extensions/llama/client.d.ts.map +1 -0
  490. package/dist/extensions/llama/client.js +309 -0
  491. package/dist/extensions/llama/client.js.map +1 -0
  492. package/dist/extensions/llama/huggingface.d.ts +23 -0
  493. package/dist/extensions/llama/huggingface.d.ts.map +1 -0
  494. package/dist/extensions/llama/huggingface.js +141 -0
  495. package/dist/extensions/llama/huggingface.js.map +1 -0
  496. package/dist/extensions/llama/index.d.ts +3 -0
  497. package/dist/extensions/llama/index.d.ts.map +1 -0
  498. package/dist/extensions/llama/index.js +219 -0
  499. package/dist/extensions/llama/index.js.map +1 -0
  500. package/dist/extensions/llama/provider.d.ts +12 -0
  501. package/dist/extensions/llama/provider.d.ts.map +1 -0
  502. package/dist/extensions/llama/provider.js +146 -0
  503. package/dist/extensions/llama/provider.js.map +1 -0
  504. package/dist/extensions/llama/ui.d.ts +42 -0
  505. package/dist/extensions/llama/ui.d.ts.map +1 -0
  506. package/dist/extensions/llama/ui.js +416 -0
  507. package/dist/extensions/llama/ui.js.map +1 -0
  508. package/dist/extensions/mcp/index.d.ts +3 -0
  509. package/dist/extensions/mcp/index.d.ts.map +1 -0
  510. package/dist/extensions/mcp/index.js +147 -0
  511. package/dist/extensions/mcp/index.js.map +1 -0
  512. package/dist/extensions/mcp/mcp-client.d.ts +31 -0
  513. package/dist/extensions/mcp/mcp-client.d.ts.map +1 -0
  514. package/dist/extensions/mcp/mcp-client.js +149 -0
  515. package/dist/extensions/mcp/mcp-client.js.map +1 -0
  516. package/dist/extensions/mcp/mcp-config.d.ts +47 -0
  517. package/dist/extensions/mcp/mcp-config.d.ts.map +1 -0
  518. package/dist/extensions/mcp/mcp-config.js +281 -0
  519. package/dist/extensions/mcp/mcp-config.js.map +1 -0
  520. package/dist/extensions/mcp/mcp-transport.d.ts +65 -0
  521. package/dist/extensions/mcp/mcp-transport.d.ts.map +1 -0
  522. package/dist/extensions/mcp/mcp-transport.js +278 -0
  523. package/dist/extensions/mcp/mcp-transport.js.map +1 -0
  524. package/dist/extensions/punch/auth.d.ts +12 -0
  525. package/dist/extensions/punch/auth.d.ts.map +1 -0
  526. package/dist/extensions/punch/auth.js +135 -0
  527. package/dist/extensions/punch/auth.js.map +1 -0
  528. package/dist/extensions/punch/collabs.d.ts +46 -0
  529. package/dist/extensions/punch/collabs.d.ts.map +1 -0
  530. package/dist/extensions/punch/collabs.js +299 -0
  531. package/dist/extensions/punch/collabs.js.map +1 -0
  532. package/dist/extensions/punch/index.d.ts +3 -0
  533. package/dist/extensions/punch/index.d.ts.map +1 -0
  534. package/dist/extensions/punch/index.js +256 -0
  535. package/dist/extensions/punch/index.js.map +1 -0
  536. package/dist/extensions/punch/routines.d.ts +63 -0
  537. package/dist/extensions/punch/routines.d.ts.map +1 -0
  538. package/dist/extensions/punch/routines.js +422 -0
  539. package/dist/extensions/punch/routines.js.map +1 -0
  540. package/dist/extensions/punch/server.d.ts +2 -0
  541. package/dist/extensions/punch/server.d.ts.map +1 -0
  542. package/dist/extensions/punch/server.js +156 -0
  543. package/dist/extensions/punch/server.js.map +1 -0
  544. package/dist/extensions/punch/timezone.d.ts +24 -0
  545. package/dist/extensions/punch/timezone.d.ts.map +1 -0
  546. package/dist/extensions/punch/timezone.js +106 -0
  547. package/dist/extensions/punch/timezone.js.map +1 -0
  548. package/dist/extensions/punch/todos.d.ts +46 -0
  549. package/dist/extensions/punch/todos.d.ts.map +1 -0
  550. package/dist/extensions/punch/todos.js +242 -0
  551. package/dist/extensions/punch/todos.js.map +1 -0
  552. package/dist/extensions/report-progress/index.d.ts +3 -0
  553. package/dist/extensions/report-progress/index.d.ts.map +1 -0
  554. package/dist/extensions/report-progress/index.js +25 -0
  555. package/dist/extensions/report-progress/index.js.map +1 -0
  556. package/dist/extensions/subagent/agents.d.ts +24 -0
  557. package/dist/extensions/subagent/agents.d.ts.map +1 -0
  558. package/dist/extensions/subagent/agents.js +126 -0
  559. package/dist/extensions/subagent/agents.js.map +1 -0
  560. package/dist/extensions/subagent/index.d.ts +16 -0
  561. package/dist/extensions/subagent/index.d.ts.map +1 -0
  562. package/dist/extensions/subagent/index.js +890 -0
  563. package/dist/extensions/subagent/index.js.map +1 -0
  564. package/dist/extensions/webfetch/index.d.ts +3 -0
  565. package/dist/extensions/webfetch/index.d.ts.map +1 -0
  566. package/dist/extensions/webfetch/index.js +233 -0
  567. package/dist/extensions/webfetch/index.js.map +1 -0
  568. package/dist/extensions/websearch/index.d.ts +3 -0
  569. package/dist/extensions/websearch/index.d.ts.map +1 -0
  570. package/dist/extensions/websearch/index.js +37 -0
  571. package/dist/extensions/websearch/index.js.map +1 -0
  572. package/dist/index.d.ts +36 -0
  573. package/dist/index.d.ts.map +1 -0
  574. package/dist/index.js +48 -0
  575. package/dist/index.js.map +1 -0
  576. package/dist/main.d.ts +16 -0
  577. package/dist/main.d.ts.map +1 -0
  578. package/dist/main.js +804 -0
  579. package/dist/main.js.map +1 -0
  580. package/dist/migrations.d.ts +33 -0
  581. package/dist/migrations.d.ts.map +1 -0
  582. package/dist/migrations.js +282 -0
  583. package/dist/migrations.js.map +1 -0
  584. package/dist/modes/index.d.ts +10 -0
  585. package/dist/modes/index.d.ts.map +1 -0
  586. package/dist/modes/index.js +8 -0
  587. package/dist/modes/index.js.map +1 -0
  588. package/dist/modes/interactive/assets/clankolas.png +0 -0
  589. package/dist/modes/interactive/chat-viewport.d.ts +20 -0
  590. package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
  591. package/dist/modes/interactive/chat-viewport.js +28 -0
  592. package/dist/modes/interactive/chat-viewport.js.map +1 -0
  593. package/dist/modes/interactive/components/armin.d.ts +34 -0
  594. package/dist/modes/interactive/components/armin.d.ts.map +1 -0
  595. package/dist/modes/interactive/components/armin.js +333 -0
  596. package/dist/modes/interactive/components/armin.js.map +1 -0
  597. package/dist/modes/interactive/components/assistant-message.d.ts +26 -0
  598. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -0
  599. package/dist/modes/interactive/components/assistant-message.js +158 -0
  600. package/dist/modes/interactive/components/assistant-message.js.map +1 -0
  601. package/dist/modes/interactive/components/bash-execution.d.ts +34 -0
  602. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -0
  603. package/dist/modes/interactive/components/bash-execution.js +175 -0
  604. package/dist/modes/interactive/components/bash-execution.js.map +1 -0
  605. package/dist/modes/interactive/components/bordered-loader.d.ts +16 -0
  606. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -0
  607. package/dist/modes/interactive/components/bordered-loader.js +54 -0
  608. package/dist/modes/interactive/components/bordered-loader.js.map +1 -0
  609. package/dist/modes/interactive/components/branch-summary-message.d.ts +16 -0
  610. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -0
  611. package/dist/modes/interactive/components/branch-summary-message.js +44 -0
  612. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -0
  613. package/dist/modes/interactive/components/compaction-summary-message.d.ts +16 -0
  614. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -0
  615. package/dist/modes/interactive/components/compaction-summary-message.js +45 -0
  616. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -0
  617. package/dist/modes/interactive/components/config-selector.d.ts +102 -0
  618. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -0
  619. package/dist/modes/interactive/components/config-selector.js +761 -0
  620. package/dist/modes/interactive/components/config-selector.js.map +1 -0
  621. package/dist/modes/interactive/components/countdown-timer.d.ts +14 -0
  622. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -0
  623. package/dist/modes/interactive/components/countdown-timer.js +33 -0
  624. package/dist/modes/interactive/components/countdown-timer.js.map +1 -0
  625. package/dist/modes/interactive/components/custom-editor.d.ts +30 -0
  626. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -0
  627. package/dist/modes/interactive/components/custom-editor.js +115 -0
  628. package/dist/modes/interactive/components/custom-editor.js.map +1 -0
  629. package/dist/modes/interactive/components/custom-entry.d.ts +19 -0
  630. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -0
  631. package/dist/modes/interactive/components/custom-entry.js +52 -0
  632. package/dist/modes/interactive/components/custom-entry.js.map +1 -0
  633. package/dist/modes/interactive/components/custom-message.d.ts +22 -0
  634. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -0
  635. package/dist/modes/interactive/components/custom-message.js +87 -0
  636. package/dist/modes/interactive/components/custom-message.js.map +1 -0
  637. package/dist/modes/interactive/components/daxnuts.d.ts +23 -0
  638. package/dist/modes/interactive/components/daxnuts.d.ts.map +1 -0
  639. package/dist/modes/interactive/components/daxnuts.js +140 -0
  640. package/dist/modes/interactive/components/daxnuts.js.map +1 -0
  641. package/dist/modes/interactive/components/diff.d.ts +12 -0
  642. package/dist/modes/interactive/components/diff.d.ts.map +1 -0
  643. package/dist/modes/interactive/components/diff.js +133 -0
  644. package/dist/modes/interactive/components/diff.js.map +1 -0
  645. package/dist/modes/interactive/components/dynamic-border.d.ts +15 -0
  646. package/dist/modes/interactive/components/dynamic-border.d.ts.map +1 -0
  647. package/dist/modes/interactive/components/dynamic-border.js +21 -0
  648. package/dist/modes/interactive/components/dynamic-border.js.map +1 -0
  649. package/dist/modes/interactive/components/earendil-announcement.d.ts +5 -0
  650. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -0
  651. package/dist/modes/interactive/components/earendil-announcement.js +40 -0
  652. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -0
  653. package/dist/modes/interactive/components/extension-editor.d.ts +21 -0
  654. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -0
  655. package/dist/modes/interactive/components/extension-editor.js +98 -0
  656. package/dist/modes/interactive/components/extension-editor.js.map +1 -0
  657. package/dist/modes/interactive/components/extension-input.d.ts +23 -0
  658. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -0
  659. package/dist/modes/interactive/components/extension-input.js +61 -0
  660. package/dist/modes/interactive/components/extension-input.js.map +1 -0
  661. package/dist/modes/interactive/components/extension-selector.d.ts +26 -0
  662. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -0
  663. package/dist/modes/interactive/components/extension-selector.js +83 -0
  664. package/dist/modes/interactive/components/extension-selector.js.map +1 -0
  665. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  666. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  667. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  668. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  669. package/dist/modes/interactive/components/footer.d.ts +32 -0
  670. package/dist/modes/interactive/components/footer.d.ts.map +1 -0
  671. package/dist/modes/interactive/components/footer.js +222 -0
  672. package/dist/modes/interactive/components/footer.js.map +1 -0
  673. package/dist/modes/interactive/components/index.d.ts +34 -0
  674. package/dist/modes/interactive/components/index.d.ts.map +1 -0
  675. package/dist/modes/interactive/components/index.js +35 -0
  676. package/dist/modes/interactive/components/index.js.map +1 -0
  677. package/dist/modes/interactive/components/keybinding-hints.d.ts +13 -0
  678. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -0
  679. package/dist/modes/interactive/components/keybinding-hints.js +36 -0
  680. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -0
  681. package/dist/modes/interactive/components/login-dialog.d.ts +52 -0
  682. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -0
  683. package/dist/modes/interactive/components/login-dialog.js +188 -0
  684. package/dist/modes/interactive/components/login-dialog.js.map +1 -0
  685. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  686. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  687. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  688. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  689. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  690. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  691. package/dist/modes/interactive/components/mermaid.js +75 -0
  692. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  693. package/dist/modes/interactive/components/model-selector.d.ts +60 -0
  694. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -0
  695. package/dist/modes/interactive/components/model-selector.js +361 -0
  696. package/dist/modes/interactive/components/model-selector.js.map +1 -0
  697. package/dist/modes/interactive/components/oauth-selector.d.ts +33 -0
  698. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -0
  699. package/dist/modes/interactive/components/oauth-selector.js +163 -0
  700. package/dist/modes/interactive/components/oauth-selector.js.map +1 -0
  701. package/dist/modes/interactive/components/question-selector.d.ts +24 -0
  702. package/dist/modes/interactive/components/question-selector.d.ts.map +1 -0
  703. package/dist/modes/interactive/components/question-selector.js +158 -0
  704. package/dist/modes/interactive/components/question-selector.js.map +1 -0
  705. package/dist/modes/interactive/components/scoped-models-selector.d.ts +46 -0
  706. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -0
  707. package/dist/modes/interactive/components/scoped-models-selector.js +326 -0
  708. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -0
  709. package/dist/modes/interactive/components/session-selector-search.d.ts +23 -0
  710. package/dist/modes/interactive/components/session-selector-search.d.ts.map +1 -0
  711. package/dist/modes/interactive/components/session-selector-search.js +155 -0
  712. package/dist/modes/interactive/components/session-selector-search.js.map +1 -0
  713. package/dist/modes/interactive/components/session-selector.d.ts +95 -0
  714. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -0
  715. package/dist/modes/interactive/components/session-selector.js +867 -0
  716. package/dist/modes/interactive/components/session-selector.js.map +1 -0
  717. package/dist/modes/interactive/components/settings-selector.d.ts +92 -0
  718. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -0
  719. package/dist/modes/interactive/components/settings-selector.js +709 -0
  720. package/dist/modes/interactive/components/settings-selector.js.map +1 -0
  721. package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
  722. package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
  723. package/dist/modes/interactive/components/settings-submenu.js +165 -0
  724. package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
  725. package/dist/modes/interactive/components/show-images-selector.d.ts +10 -0
  726. package/dist/modes/interactive/components/show-images-selector.d.ts.map +1 -0
  727. package/dist/modes/interactive/components/show-images-selector.js +39 -0
  728. package/dist/modes/interactive/components/show-images-selector.js.map +1 -0
  729. package/dist/modes/interactive/components/skill-invocation-message.d.ts +17 -0
  730. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -0
  731. package/dist/modes/interactive/components/skill-invocation-message.js +47 -0
  732. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -0
  733. package/dist/modes/interactive/components/status-indicator.d.ts +30 -0
  734. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -0
  735. package/dist/modes/interactive/components/status-indicator.js +67 -0
  736. package/dist/modes/interactive/components/status-indicator.js.map +1 -0
  737. package/dist/modes/interactive/components/theme-selector.d.ts +11 -0
  738. package/dist/modes/interactive/components/theme-selector.d.ts.map +1 -0
  739. package/dist/modes/interactive/components/theme-selector.js +50 -0
  740. package/dist/modes/interactive/components/theme-selector.js.map +1 -0
  741. package/dist/modes/interactive/components/thinking-selector.d.ts +23 -0
  742. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -0
  743. package/dist/modes/interactive/components/thinking-selector.js +109 -0
  744. package/dist/modes/interactive/components/thinking-selector.js.map +1 -0
  745. package/dist/modes/interactive/components/tool-execution.d.ts +80 -0
  746. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -0
  747. package/dist/modes/interactive/components/tool-execution.js +328 -0
  748. package/dist/modes/interactive/components/tool-execution.js.map +1 -0
  749. package/dist/modes/interactive/components/tree-selector.d.ts +94 -0
  750. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -0
  751. package/dist/modes/interactive/components/tree-selector.js +1245 -0
  752. package/dist/modes/interactive/components/tree-selector.js.map +1 -0
  753. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  754. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  755. package/dist/modes/interactive/components/trust-selector.js +91 -0
  756. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  757. package/dist/modes/interactive/components/user-message-selector.d.ts +30 -0
  758. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -0
  759. package/dist/modes/interactive/components/user-message-selector.js +114 -0
  760. package/dist/modes/interactive/components/user-message-selector.js.map +1 -0
  761. package/dist/modes/interactive/components/user-message.d.ts +16 -0
  762. package/dist/modes/interactive/components/user-message.d.ts.map +1 -0
  763. package/dist/modes/interactive/components/user-message.js +49 -0
  764. package/dist/modes/interactive/components/user-message.js.map +1 -0
  765. package/dist/modes/interactive/components/visual-truncate.d.ts +24 -0
  766. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -0
  767. package/dist/modes/interactive/components/visual-truncate.js +33 -0
  768. package/dist/modes/interactive/components/visual-truncate.js.map +1 -0
  769. package/dist/modes/interactive/external-editor.d.ts +12 -0
  770. package/dist/modes/interactive/external-editor.d.ts.map +1 -0
  771. package/dist/modes/interactive/external-editor.js +38 -0
  772. package/dist/modes/interactive/external-editor.js.map +1 -0
  773. package/dist/modes/interactive/interactive-mode.d.ts +443 -0
  774. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -0
  775. package/dist/modes/interactive/interactive-mode.js +5604 -0
  776. package/dist/modes/interactive/interactive-mode.js.map +1 -0
  777. package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
  778. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
  779. package/dist/modes/interactive/model-catalog-refresh.js +34 -0
  780. package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
  781. package/dist/modes/interactive/model-search.d.ts +12 -0
  782. package/dist/modes/interactive/model-search.d.ts.map +1 -0
  783. package/dist/modes/interactive/model-search.js +15 -0
  784. package/dist/modes/interactive/model-search.js.map +1 -0
  785. package/dist/modes/interactive/session-share.d.ts +16 -0
  786. package/dist/modes/interactive/session-share.d.ts.map +1 -0
  787. package/dist/modes/interactive/session-share.js +184 -0
  788. package/dist/modes/interactive/session-share.js.map +1 -0
  789. package/dist/modes/interactive/theme/dark.json +91 -0
  790. package/dist/modes/interactive/theme/light.json +90 -0
  791. package/dist/modes/interactive/theme/theme-controller.d.ts +41 -0
  792. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -0
  793. package/dist/modes/interactive/theme/theme-controller.js +130 -0
  794. package/dist/modes/interactive/theme/theme-controller.js.map +1 -0
  795. package/dist/modes/interactive/theme/theme-json.d.ts +84 -0
  796. package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
  797. package/dist/modes/interactive/theme/theme-json.js +130 -0
  798. package/dist/modes/interactive/theme/theme-json.js.map +1 -0
  799. package/dist/modes/interactive/theme/theme-schema.json +356 -0
  800. package/dist/modes/interactive/theme/theme.d.ts +131 -0
  801. package/dist/modes/interactive/theme/theme.d.ts.map +1 -0
  802. package/dist/modes/interactive/theme/theme.js +994 -0
  803. package/dist/modes/interactive/theme/theme.js.map +1 -0
  804. package/dist/modes/interactive/tui-renderer.d.ts +21 -0
  805. package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
  806. package/dist/modes/interactive/tui-renderer.js +66 -0
  807. package/dist/modes/interactive/tui-renderer.js.map +1 -0
  808. package/dist/modes/json-event.d.ts +34 -0
  809. package/dist/modes/json-event.d.ts.map +1 -0
  810. package/dist/modes/json-event.js +29 -0
  811. package/dist/modes/json-event.js.map +1 -0
  812. package/dist/modes/print-mode.d.ts +28 -0
  813. package/dist/modes/print-mode.d.ts.map +1 -0
  814. package/dist/modes/print-mode.js +142 -0
  815. package/dist/modes/print-mode.js.map +1 -0
  816. package/dist/modes/rpc/jsonl.d.ts +17 -0
  817. package/dist/modes/rpc/jsonl.d.ts.map +1 -0
  818. package/dist/modes/rpc/jsonl.js +49 -0
  819. package/dist/modes/rpc/jsonl.js.map +1 -0
  820. package/dist/modes/rpc/rpc-client.d.ts +254 -0
  821. package/dist/modes/rpc/rpc-client.d.ts.map +1 -0
  822. package/dist/modes/rpc/rpc-client.js +495 -0
  823. package/dist/modes/rpc/rpc-client.js.map +1 -0
  824. package/dist/modes/rpc/rpc-mode.d.ts +23 -0
  825. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -0
  826. package/dist/modes/rpc/rpc-mode.js +728 -0
  827. package/dist/modes/rpc/rpc-mode.js.map +1 -0
  828. package/dist/modes/rpc/rpc-types.d.ts +492 -0
  829. package/dist/modes/rpc/rpc-types.d.ts.map +1 -0
  830. package/dist/modes/rpc/rpc-types.js +8 -0
  831. package/dist/modes/rpc/rpc-types.js.map +1 -0
  832. package/dist/package-manager-cli.d.ts +9 -0
  833. package/dist/package-manager-cli.d.ts.map +1 -0
  834. package/dist/package-manager-cli.js +961 -0
  835. package/dist/package-manager-cli.js.map +1 -0
  836. package/dist/rpc-entry.d.ts +3 -0
  837. package/dist/rpc-entry.d.ts.map +1 -0
  838. package/dist/rpc-entry.js +11 -0
  839. package/dist/rpc-entry.js.map +1 -0
  840. package/dist/server/a2a/harness-runner.d.ts +8 -0
  841. package/dist/server/a2a/harness-runner.d.ts.map +1 -0
  842. package/dist/server/a2a/harness-runner.js +116 -0
  843. package/dist/server/a2a/harness-runner.js.map +1 -0
  844. package/dist/server/a2a/run-server.d.ts +13 -0
  845. package/dist/server/a2a/run-server.d.ts.map +1 -0
  846. package/dist/server/a2a/run-server.js +19 -0
  847. package/dist/server/a2a/run-server.js.map +1 -0
  848. package/dist/utils/abort.d.ts +5 -0
  849. package/dist/utils/abort.d.ts.map +1 -0
  850. package/dist/utils/abort.js +48 -0
  851. package/dist/utils/abort.js.map +1 -0
  852. package/dist/utils/ansi.d.ts +2 -0
  853. package/dist/utils/ansi.d.ts.map +1 -0
  854. package/dist/utils/ansi.js +52 -0
  855. package/dist/utils/ansi.js.map +1 -0
  856. package/dist/utils/changelog.d.ts +22 -0
  857. package/dist/utils/changelog.d.ts.map +1 -0
  858. package/dist/utils/changelog.js +165 -0
  859. package/dist/utils/changelog.js.map +1 -0
  860. package/dist/utils/child-process.d.ts +18 -0
  861. package/dist/utils/child-process.d.ts.map +1 -0
  862. package/dist/utils/child-process.js +106 -0
  863. package/dist/utils/child-process.js.map +1 -0
  864. package/dist/utils/clipboard-command.d.ts +7 -0
  865. package/dist/utils/clipboard-command.d.ts.map +1 -0
  866. package/dist/utils/clipboard-command.js +45 -0
  867. package/dist/utils/clipboard-command.js.map +1 -0
  868. package/dist/utils/clipboard-image.d.ts +11 -0
  869. package/dist/utils/clipboard-image.d.ts.map +1 -0
  870. package/dist/utils/clipboard-image.js +228 -0
  871. package/dist/utils/clipboard-image.js.map +1 -0
  872. package/dist/utils/clipboard.d.ts +4 -0
  873. package/dist/utils/clipboard.d.ts.map +1 -0
  874. package/dist/utils/clipboard.js +84 -0
  875. package/dist/utils/clipboard.js.map +1 -0
  876. package/dist/utils/deprecation.d.ts +4 -0
  877. package/dist/utils/deprecation.d.ts.map +1 -0
  878. package/dist/utils/deprecation.js +13 -0
  879. package/dist/utils/deprecation.js.map +1 -0
  880. package/dist/utils/exif-orientation.d.ts +5 -0
  881. package/dist/utils/exif-orientation.d.ts.map +1 -0
  882. package/dist/utils/exif-orientation.js +157 -0
  883. package/dist/utils/exif-orientation.js.map +1 -0
  884. package/dist/utils/frontmatter.d.ts +8 -0
  885. package/dist/utils/frontmatter.d.ts.map +1 -0
  886. package/dist/utils/frontmatter.js +27 -0
  887. package/dist/utils/frontmatter.js.map +1 -0
  888. package/dist/utils/fs-watch.d.ts +5 -0
  889. package/dist/utils/fs-watch.d.ts.map +1 -0
  890. package/dist/utils/fs-watch.js +25 -0
  891. package/dist/utils/fs-watch.js.map +1 -0
  892. package/dist/utils/git.d.ts +26 -0
  893. package/dist/utils/git.d.ts.map +1 -0
  894. package/dist/utils/git.js +195 -0
  895. package/dist/utils/git.js.map +1 -0
  896. package/dist/utils/html.d.ts +7 -0
  897. package/dist/utils/html.d.ts.map +1 -0
  898. package/dist/utils/html.js +40 -0
  899. package/dist/utils/html.js.map +1 -0
  900. package/dist/utils/image-convert.d.ts +10 -0
  901. package/dist/utils/image-convert.d.ts.map +1 -0
  902. package/dist/utils/image-convert.js +45 -0
  903. package/dist/utils/image-convert.js.map +1 -0
  904. package/dist/utils/image-process.d.ts +18 -0
  905. package/dist/utils/image-process.d.ts.map +1 -0
  906. package/dist/utils/image-process.js +83 -0
  907. package/dist/utils/image-process.js.map +1 -0
  908. package/dist/utils/image-resize-core.d.ts +30 -0
  909. package/dist/utils/image-resize-core.d.ts.map +1 -0
  910. package/dist/utils/image-resize-core.js +124 -0
  911. package/dist/utils/image-resize-core.js.map +1 -0
  912. package/dist/utils/image-resize-worker.d.ts +2 -0
  913. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  914. package/dist/utils/image-resize-worker.js +31 -0
  915. package/dist/utils/image-resize-worker.js.map +1 -0
  916. package/dist/utils/image-resize.d.ts +16 -0
  917. package/dist/utils/image-resize.d.ts.map +1 -0
  918. package/dist/utils/image-resize.js +97 -0
  919. package/dist/utils/image-resize.js.map +1 -0
  920. package/dist/utils/json.d.ts +3 -0
  921. package/dist/utils/json.d.ts.map +1 -0
  922. package/dist/utils/json.js +7 -0
  923. package/dist/utils/json.js.map +1 -0
  924. package/dist/utils/management-http.d.ts +25 -0
  925. package/dist/utils/management-http.d.ts.map +1 -0
  926. package/dist/utils/management-http.js +54 -0
  927. package/dist/utils/management-http.js.map +1 -0
  928. package/dist/utils/mime.d.ts +3 -0
  929. package/dist/utils/mime.d.ts.map +1 -0
  930. package/dist/utils/mime.js +110 -0
  931. package/dist/utils/mime.js.map +1 -0
  932. package/dist/utils/open-browser.d.ts +9 -0
  933. package/dist/utils/open-browser.d.ts.map +1 -0
  934. package/dist/utils/open-browser.js +22 -0
  935. package/dist/utils/open-browser.js.map +1 -0
  936. package/dist/utils/paths.d.ts +34 -0
  937. package/dist/utils/paths.d.ts.map +1 -0
  938. package/dist/utils/paths.js +114 -0
  939. package/dist/utils/paths.js.map +1 -0
  940. package/dist/utils/photon.d.ts +21 -0
  941. package/dist/utils/photon.d.ts.map +1 -0
  942. package/dist/utils/photon.js +121 -0
  943. package/dist/utils/photon.js.map +1 -0
  944. package/dist/utils/pi-user-agent.d.ts +2 -0
  945. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  946. package/dist/utils/pi-user-agent.js +5 -0
  947. package/dist/utils/pi-user-agent.js.map +1 -0
  948. package/dist/utils/shell.d.ts +34 -0
  949. package/dist/utils/shell.d.ts.map +1 -0
  950. package/dist/utils/shell.js +216 -0
  951. package/dist/utils/shell.js.map +1 -0
  952. package/dist/utils/sleep.d.ts +5 -0
  953. package/dist/utils/sleep.d.ts.map +1 -0
  954. package/dist/utils/sleep.js +17 -0
  955. package/dist/utils/sleep.js.map +1 -0
  956. package/dist/utils/syntax-highlight.d.ts +13 -0
  957. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  958. package/dist/utils/syntax-highlight.js +177 -0
  959. package/dist/utils/syntax-highlight.js.map +1 -0
  960. package/dist/utils/text.d.ts +8 -0
  961. package/dist/utils/text.d.ts.map +1 -0
  962. package/dist/utils/text.js +9 -0
  963. package/dist/utils/text.js.map +1 -0
  964. package/dist/utils/tool-result-images.d.ts +19 -0
  965. package/dist/utils/tool-result-images.d.ts.map +1 -0
  966. package/dist/utils/tool-result-images.js +45 -0
  967. package/dist/utils/tool-result-images.js.map +1 -0
  968. package/dist/utils/tools-manager.d.ts +13 -0
  969. package/dist/utils/tools-manager.d.ts.map +1 -0
  970. package/dist/utils/tools-manager.js +343 -0
  971. package/dist/utils/tools-manager.js.map +1 -0
  972. package/dist/utils/version-check.d.ts +19 -0
  973. package/dist/utils/version-check.d.ts.map +1 -0
  974. package/dist/utils/version-check.js +79 -0
  975. package/dist/utils/version-check.js.map +1 -0
  976. package/dist/utils/windows-self-update.d.ts +3 -0
  977. package/dist/utils/windows-self-update.d.ts.map +1 -0
  978. package/dist/utils/windows-self-update.js +77 -0
  979. package/dist/utils/windows-self-update.js.map +1 -0
  980. package/docs/compaction.md +444 -0
  981. package/docs/containerization.md +156 -0
  982. package/docs/custom-provider.md +777 -0
  983. package/docs/development.md +90 -0
  984. package/docs/docs.json +160 -0
  985. package/docs/environment-variables.md +99 -0
  986. package/docs/extensions.md +3033 -0
  987. package/docs/images/doom-extension.png +0 -0
  988. package/docs/images/exy.png +0 -0
  989. package/docs/images/interactive-mode.png +0 -0
  990. package/docs/images/tree-view.png +0 -0
  991. package/docs/index.md +84 -0
  992. package/docs/json.md +98 -0
  993. package/docs/keybindings.md +239 -0
  994. package/docs/llama-cpp.md +101 -0
  995. package/docs/models.md +574 -0
  996. package/docs/packages.md +228 -0
  997. package/docs/prompt-templates.md +96 -0
  998. package/docs/providers.md +317 -0
  999. package/docs/quickstart.md +167 -0
  1000. package/docs/rpc.md +1618 -0
  1001. package/docs/sdk.md +1226 -0
  1002. package/docs/security.md +59 -0
  1003. package/docs/session-format.md +450 -0
  1004. package/docs/sessions.md +145 -0
  1005. package/docs/settings.md +405 -0
  1006. package/docs/shell-aliases.md +13 -0
  1007. package/docs/skills.md +232 -0
  1008. package/docs/subagents.md +43 -0
  1009. package/docs/terminal-setup.md +192 -0
  1010. package/docs/termux.md +126 -0
  1011. package/docs/themes.md +322 -0
  1012. package/docs/tmux.md +63 -0
  1013. package/docs/tui.md +961 -0
  1014. package/docs/usage.md +311 -0
  1015. package/docs/windows.md +39 -0
  1016. package/examples/README.md +28 -0
  1017. package/examples/extensions/README.md +213 -0
  1018. package/examples/extensions/auto-commit-on-exit.ts +49 -0
  1019. package/examples/extensions/bash-spawn-hook.ts +30 -0
  1020. package/examples/extensions/bookmark.ts +50 -0
  1021. package/examples/extensions/border-status-editor.ts +145 -0
  1022. package/examples/extensions/built-in-tool-renderer.ts +249 -0
  1023. package/examples/extensions/claude-rules.ts +86 -0
  1024. package/examples/extensions/commands.ts +72 -0
  1025. package/examples/extensions/confirm-destructive.ts +59 -0
  1026. package/examples/extensions/custom-compaction.ts +117 -0
  1027. package/examples/extensions/custom-footer.ts +64 -0
  1028. package/examples/extensions/custom-header.ts +73 -0
  1029. package/examples/extensions/custom-provider-anthropic/index.ts +611 -0
  1030. package/examples/extensions/custom-provider-anthropic/package-lock.json +24 -0
  1031. package/examples/extensions/custom-provider-anthropic/package.json +19 -0
  1032. package/examples/extensions/custom-provider-gitlab-duo/index.ts +405 -0
  1033. package/examples/extensions/custom-provider-gitlab-duo/package.json +16 -0
  1034. package/examples/extensions/custom-provider-gitlab-duo/test.ts +82 -0
  1035. package/examples/extensions/dirty-repo-guard.ts +56 -0
  1036. package/examples/extensions/doom-overlay/README.md +46 -0
  1037. package/examples/extensions/doom-overlay/doom/build/doom.js +21 -0
  1038. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  1039. package/examples/extensions/doom-overlay/doom/build.sh +152 -0
  1040. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +72 -0
  1041. package/examples/extensions/doom-overlay/doom-component.ts +132 -0
  1042. package/examples/extensions/doom-overlay/doom-engine.ts +173 -0
  1043. package/examples/extensions/doom-overlay/doom-keys.ts +104 -0
  1044. package/examples/extensions/doom-overlay/index.ts +74 -0
  1045. package/examples/extensions/doom-overlay/wad-finder.ts +55 -0
  1046. package/examples/extensions/dynamic-resources/SKILL.md +8 -0
  1047. package/examples/extensions/dynamic-resources/dynamic.json +81 -0
  1048. package/examples/extensions/dynamic-resources/dynamic.md +5 -0
  1049. package/examples/extensions/dynamic-resources/index.ts +15 -0
  1050. package/examples/extensions/dynamic-tools.ts +74 -0
  1051. package/examples/extensions/entry-renderer.ts +41 -0
  1052. package/examples/extensions/event-bus.ts +43 -0
  1053. package/examples/extensions/file-trigger.ts +41 -0
  1054. package/examples/extensions/git-checkpoint.ts +53 -0
  1055. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  1056. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  1057. package/examples/extensions/gondolin/index.ts +531 -0
  1058. package/examples/extensions/gondolin/package-lock.json +185 -0
  1059. package/examples/extensions/gondolin/package.json +19 -0
  1060. package/examples/extensions/handoff.ts +190 -0
  1061. package/examples/extensions/hello.ts +26 -0
  1062. package/examples/extensions/hidden-thinking-label.ts +53 -0
  1063. package/examples/extensions/inline-bash.ts +94 -0
  1064. package/examples/extensions/input-transform-streaming.ts +39 -0
  1065. package/examples/extensions/input-transform.ts +43 -0
  1066. package/examples/extensions/interactive-shell.ts +196 -0
  1067. package/examples/extensions/kimi-deferred-tools.ts +61 -0
  1068. package/examples/extensions/mac-system-theme.ts +47 -0
  1069. package/examples/extensions/message-renderer.ts +59 -0
  1070. package/examples/extensions/minimal-mode.ts +426 -0
  1071. package/examples/extensions/modal-editor.ts +85 -0
  1072. package/examples/extensions/model-status.ts +31 -0
  1073. package/examples/extensions/notify.ts +57 -0
  1074. package/examples/extensions/overlay-qa-tests.ts +1450 -0
  1075. package/examples/extensions/overlay-test.ts +153 -0
  1076. package/examples/extensions/permission-gate.ts +34 -0
  1077. package/examples/extensions/pirate.ts +47 -0
  1078. package/examples/extensions/plan-mode/README.md +66 -0
  1079. package/examples/extensions/plan-mode/index.ts +390 -0
  1080. package/examples/extensions/plan-mode/utils.ts +168 -0
  1081. package/examples/extensions/preset.ts +436 -0
  1082. package/examples/extensions/project-trust.ts +64 -0
  1083. package/examples/extensions/prompt-customizer.ts +97 -0
  1084. package/examples/extensions/protected-paths.ts +30 -0
  1085. package/examples/extensions/provider-payload.ts +18 -0
  1086. package/examples/extensions/qna.ts +118 -0
  1087. package/examples/extensions/question.ts +278 -0
  1088. package/examples/extensions/questionnaire.ts +440 -0
  1089. package/examples/extensions/rainbow-editor.ts +88 -0
  1090. package/examples/extensions/reload-runtime.ts +37 -0
  1091. package/examples/extensions/rpc-demo.ts +118 -0
  1092. package/examples/extensions/sandbox/index.ts +321 -0
  1093. package/examples/extensions/sandbox/package-lock.json +92 -0
  1094. package/examples/extensions/sandbox/package.json +19 -0
  1095. package/examples/extensions/send-user-message.ts +97 -0
  1096. package/examples/extensions/session-name.ts +27 -0
  1097. package/examples/extensions/shutdown-command.ts +63 -0
  1098. package/examples/extensions/snake.ts +343 -0
  1099. package/examples/extensions/space-invaders.ts +560 -0
  1100. package/examples/extensions/ssh.ts +220 -0
  1101. package/examples/extensions/status-line.ts +32 -0
  1102. package/examples/extensions/structured-output.ts +65 -0
  1103. package/examples/extensions/subagent/README.md +167 -0
  1104. package/examples/extensions/subagent/agents/planner.md +37 -0
  1105. package/examples/extensions/subagent/agents/reviewer.md +35 -0
  1106. package/examples/extensions/subagent/agents/scout.md +50 -0
  1107. package/examples/extensions/subagent/agents/worker.md +24 -0
  1108. package/examples/extensions/subagent/prompts/implement-and-review.md +10 -0
  1109. package/examples/extensions/subagent/prompts/implement.md +10 -0
  1110. package/examples/extensions/subagent/prompts/scout-and-plan.md +9 -0
  1111. package/examples/extensions/summarize.ts +199 -0
  1112. package/examples/extensions/system-prompt-header.ts +17 -0
  1113. package/examples/extensions/tic-tac-toe.ts +1008 -0
  1114. package/examples/extensions/timed-confirm.ts +70 -0
  1115. package/examples/extensions/titlebar-spinner.ts +58 -0
  1116. package/examples/extensions/todo.ts +297 -0
  1117. package/examples/extensions/tool-override.ts +144 -0
  1118. package/examples/extensions/tools.ts +146 -0
  1119. package/examples/extensions/trigger-compact.ts +50 -0
  1120. package/examples/extensions/truncated-tool.ts +195 -0
  1121. package/examples/extensions/widget-placement.ts +9 -0
  1122. package/examples/extensions/with-deps/index.ts +32 -0
  1123. package/examples/extensions/with-deps/package-lock.json +31 -0
  1124. package/examples/extensions/with-deps/package.json +22 -0
  1125. package/examples/extensions/working-indicator.ts +123 -0
  1126. package/examples/extensions/working-message-test.ts +25 -0
  1127. package/examples/plugins/pi-example-plugin/README.md +38 -0
  1128. package/examples/plugins/pi-example-plugin/package.json +10 -0
  1129. package/examples/plugins/pi-example-plugin/src/contract.ts +13 -0
  1130. package/examples/plugins/pi-example-plugin/src/session.ts +23 -0
  1131. package/examples/plugins/pi-example-plugin/src/tui.ts +31 -0
  1132. package/examples/rpc-extension-ui.ts +641 -0
  1133. package/examples/sdk/01-minimal.ts +26 -0
  1134. package/examples/sdk/02-custom-model.ts +49 -0
  1135. package/examples/sdk/03-custom-prompt.ts +70 -0
  1136. package/examples/sdk/04-skills.ts +55 -0
  1137. package/examples/sdk/05-tools.ts +48 -0
  1138. package/examples/sdk/06-extensions.ts +94 -0
  1139. package/examples/sdk/07-context-files.ts +42 -0
  1140. package/examples/sdk/08-prompt-templates.ts +51 -0
  1141. package/examples/sdk/09-api-keys-and-oauth.ts +34 -0
  1142. package/examples/sdk/10-settings.ts +53 -0
  1143. package/examples/sdk/11-sessions.ts +52 -0
  1144. package/examples/sdk/12-full-control.ts +74 -0
  1145. package/examples/sdk/13-session-runtime.ts +67 -0
  1146. package/examples/sdk/README.md +140 -0
  1147. package/package.json +111 -0
@@ -0,0 +1,299 @@
1
+ import { execFileSync } from "node:child_process";
2
+ import { randomUUID } from "node:crypto";
3
+ import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
4
+ import * as path from "node:path";
5
+ const ID_PATTERN = /^col_[a-f0-9]{12}$/;
6
+ const SHA_PATTERN = /^[a-f0-9]{40,64}$/;
7
+ let records = [];
8
+ export function collabStateFile() {
9
+ return path.join(process.cwd(), ".pi", "collabs.json");
10
+ }
11
+ function load() {
12
+ let raw;
13
+ try {
14
+ raw = readFileSync(collabStateFile(), "utf8");
15
+ }
16
+ catch (err) {
17
+ if (err.code === "ENOENT") {
18
+ records = [];
19
+ return;
20
+ }
21
+ throw err;
22
+ }
23
+ const parsed = JSON.parse(raw);
24
+ if (!Array.isArray(parsed))
25
+ throw new Error("collabs.json must contain an array");
26
+ records = parsed;
27
+ }
28
+ function reload() {
29
+ load();
30
+ }
31
+ function save() {
32
+ const file = collabStateFile();
33
+ mkdirSync(path.dirname(file), { recursive: true });
34
+ const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
35
+ writeFileSync(tmp, JSON.stringify(records, null, 2), { mode: 0o600 });
36
+ renameSync(tmp, file);
37
+ }
38
+ function collabOrThrow(id) {
39
+ if (!ID_PATTERN.test(id))
40
+ throw new Error("Invalid collaboration ID.");
41
+ const collab = records.find((c) => c.id === id);
42
+ if (!collab)
43
+ throw new Error("Collaboration not found.");
44
+ return collab;
45
+ }
46
+ function canonicalParticipant(collab, actor) {
47
+ const participant = collab.participants.find((p) => p.toLowerCase() === actor.toLowerCase());
48
+ if (!participant)
49
+ throw new Error("Sandbox is not a collaboration participant.");
50
+ return participant;
51
+ }
52
+ function requireParticipant(collab, actor) {
53
+ canonicalParticipant(collab, actor);
54
+ }
55
+ function write(collab) {
56
+ reload();
57
+ const index = records.findIndex((c) => c.id === collab.id);
58
+ if (index === -1)
59
+ throw new Error("Collaboration not found.");
60
+ records[index] = collab;
61
+ save();
62
+ }
63
+ function workspaceRoot() {
64
+ return process.env.PI_WORKSPACE_ROOT || process.cwd();
65
+ }
66
+ function safeWorkspace(p) {
67
+ if (typeof p !== "string")
68
+ throw new Error("Workspace must be an absolute path under the workspace root.");
69
+ if (p.includes("\0"))
70
+ throw new Error("Workspace must be an absolute path under the workspace root.");
71
+ if (!path.isAbsolute(p))
72
+ throw new Error("Workspace must be an absolute path under the workspace root.");
73
+ const resolved = path.resolve(p).replace(/\/+$/, "");
74
+ const root = path.resolve(workspaceRoot()).replace(/\/+$/, "");
75
+ if (!resolved.startsWith(root + path.sep) || resolved === root) {
76
+ throw new Error("Workspace must be an absolute path under the workspace root.");
77
+ }
78
+ let realRoot;
79
+ try {
80
+ realRoot = realpathSync(root);
81
+ }
82
+ catch {
83
+ return resolved;
84
+ }
85
+ let existing = resolved;
86
+ while (true) {
87
+ let realExisting = null;
88
+ try {
89
+ realExisting = realpathSync(existing);
90
+ }
91
+ catch { }
92
+ if (realExisting !== null) {
93
+ if (realExisting !== realRoot && !realExisting.startsWith(realRoot + path.sep)) {
94
+ throw new Error("Workspace must be an absolute path under the workspace root.");
95
+ }
96
+ const suffix = resolved.slice(existing.length);
97
+ const fullReal = `${realExisting}${suffix}`;
98
+ if (!fullReal.startsWith(realRoot + path.sep)) {
99
+ throw new Error("Workspace must be an absolute path under the workspace root.");
100
+ }
101
+ return resolved;
102
+ }
103
+ const parent = path.dirname(existing);
104
+ if (parent === existing) {
105
+ return resolved;
106
+ }
107
+ existing = parent;
108
+ }
109
+ }
110
+ function git(args, cwd) {
111
+ return execFileSync("git", args, { encoding: "utf8", cwd }).trim();
112
+ }
113
+ function bareHead(collab, branch) {
114
+ return git(["--git-dir", collab.repo, "rev-parse", `refs/heads/${branch}`]).toLowerCase();
115
+ }
116
+ export function validateCollabWorkspace(workspace) {
117
+ return safeWorkspace(workspace);
118
+ }
119
+ export function collabDir() {
120
+ const configured = process.env.PI_COLLAB_DIR;
121
+ if (configured)
122
+ return path.resolve(configured);
123
+ return path.join(process.cwd(), ".pi", "collab");
124
+ }
125
+ export function listFor(actor) {
126
+ reload();
127
+ const lowered = actor.toLowerCase();
128
+ return records.filter((collab) => collab.participants.some((participant) => participant.toLowerCase() === lowered));
129
+ }
130
+ export function getFor(id, actor) {
131
+ reload();
132
+ const collab = collabOrThrow(id);
133
+ requireParticipant(collab, actor);
134
+ return collab;
135
+ }
136
+ export function create(opts) {
137
+ const owner = opts.owner;
138
+ const reviewer = opts.reviewer;
139
+ if (!reviewer || reviewer.toLowerCase() === owner.toLowerCase()) {
140
+ throw new Error("reviewer must be a different sandbox");
141
+ }
142
+ const source = safeWorkspace(opts.workspace);
143
+ const id = `col_${randomUUID().replace(/-/g, "").slice(0, 12)}`;
144
+ const repo = path.join(collabDir(), `${id}.git`);
145
+ const clonePath = path.join(collabDir(), id);
146
+ if (!existsSync(path.join(source, ".git"))) {
147
+ git(["init", "--initial-branch=main", source]);
148
+ }
149
+ let hasHead = true;
150
+ try {
151
+ git(["rev-parse", "--verify", "HEAD"], source);
152
+ }
153
+ catch {
154
+ hasHead = false;
155
+ }
156
+ if (!hasHead) {
157
+ git(["config", "user.name", `Punch ${owner}`], source);
158
+ git(["config", "user.email", `${owner}@punch.local`], source);
159
+ git(["add", "--all"], source);
160
+ git(["commit", "--allow-empty", "--message", "Initialize collaboration"], source);
161
+ }
162
+ mkdirSync(path.dirname(repo), { recursive: true });
163
+ git(["clone", "--bare", source, repo]);
164
+ const base = git(["--git-dir", repo, "rev-parse", "HEAD"]).toLowerCase();
165
+ git(["--git-dir", repo, "update-ref", "refs/heads/main", base]);
166
+ git(["--git-dir", repo, "symbolic-ref", "HEAD", "refs/heads/main"]);
167
+ try {
168
+ git(["remote", "remove", "punch-collab"], source);
169
+ }
170
+ catch { }
171
+ git(["remote", "add", "punch-collab", repo], source);
172
+ mkdirSync(clonePath, { recursive: true });
173
+ git(["clone", repo, clonePath]);
174
+ const collab = {
175
+ id,
176
+ owner,
177
+ participants: [owner, reviewer],
178
+ repo,
179
+ baseRef: "main",
180
+ base,
181
+ workspaces: { [owner]: source, [reviewer]: clonePath },
182
+ proposal: null,
183
+ createdAt: Date.now(),
184
+ updatedAt: Date.now(),
185
+ };
186
+ reload();
187
+ records.push(collab);
188
+ save();
189
+ return collab;
190
+ }
191
+ export function propose(opts) {
192
+ reload();
193
+ if (!SHA_PATTERN.test(opts.head))
194
+ throw new Error("Invalid proposal SHA.");
195
+ const collab = collabOrThrow(opts.id);
196
+ requireParticipant(collab, opts.actor);
197
+ const branch = `changes/${opts.id}`;
198
+ const remoteHead = bareHead(collab, branch);
199
+ if (remoteHead !== opts.head.toLowerCase())
200
+ throw new Error("Proposal SHA is not current collaboration branch head.");
201
+ try {
202
+ git(["--git-dir", collab.repo, "merge-base", "--is-ancestor", collab.base, remoteHead]);
203
+ }
204
+ catch {
205
+ throw new Error("Proposal does not descend from canonical main.");
206
+ }
207
+ const author = canonicalParticipant(collab, opts.actor);
208
+ const reviewer = collab.participants.find((p) => p.toLowerCase() !== author.toLowerCase());
209
+ if (!reviewer)
210
+ throw new Error("No reviewer participant.");
211
+ const previous = collab.proposal;
212
+ if (previous?.status === "changes_requested") {
213
+ const rejectedHead = previous.reviewedHead ?? previous.head;
214
+ if (rejectedHead === remoteHead) {
215
+ throw new Error("Proposal unchanged since changes were requested; push new commits before reproposing.");
216
+ }
217
+ }
218
+ collab.proposal = {
219
+ branch,
220
+ author,
221
+ reviewer,
222
+ head: remoteHead,
223
+ authorApprovedAt: Date.now(),
224
+ reviewerApprovedAt: null,
225
+ reviewedHead: null,
226
+ reviewNotes: "",
227
+ status: "pending_review",
228
+ };
229
+ collab.updatedAt = Date.now();
230
+ write(collab);
231
+ return collab;
232
+ }
233
+ export function review(opts) {
234
+ reload();
235
+ const collab = collabOrThrow(opts.id);
236
+ requireParticipant(collab, opts.actor);
237
+ const proposal = collab.proposal;
238
+ if (!proposal || proposal.status === "merged")
239
+ throw new Error("No proposal awaiting review.");
240
+ if (proposal.status === "changes_requested") {
241
+ throw new Error("Proposal has changes requested; author must propose a new SHA before review.");
242
+ }
243
+ if (proposal.reviewer.toLowerCase() !== canonicalParticipant(collab, opts.actor).toLowerCase()) {
244
+ throw new Error("Only other participant may review this proposal.");
245
+ }
246
+ const remoteHead = bareHead(collab, proposal.branch);
247
+ if (remoteHead !== proposal.head)
248
+ throw new Error("Branch changed. Author must propose new SHA again.");
249
+ proposal.reviewNotes = String(opts.notes || "").slice(0, 4000);
250
+ proposal.reviewedHead = remoteHead;
251
+ if (!opts.approve) {
252
+ proposal.reviewerApprovedAt = null;
253
+ proposal.status = "changes_requested";
254
+ collab.updatedAt = Date.now();
255
+ write(collab);
256
+ return collab;
257
+ }
258
+ proposal.reviewerApprovedAt = Date.now();
259
+ try {
260
+ if (mergeIfApproved(collab))
261
+ return collabOrThrow(collab.id);
262
+ proposal.status = "approved";
263
+ collab.updatedAt = Date.now();
264
+ write(collab);
265
+ return collab;
266
+ }
267
+ catch (err) {
268
+ proposal.reviewerApprovedAt = null;
269
+ proposal.reviewedHead = null;
270
+ throw err;
271
+ }
272
+ }
273
+ function mergeIfApproved(collab) {
274
+ const proposal = collab.proposal;
275
+ if (!proposal)
276
+ return false;
277
+ if (!proposal.authorApprovedAt || !proposal.reviewerApprovedAt)
278
+ return false;
279
+ if (proposal.reviewedHead !== proposal.head)
280
+ return false;
281
+ const remoteHead = bareHead(collab, proposal.branch);
282
+ if (remoteHead !== proposal.head)
283
+ return false;
284
+ try {
285
+ git(["--git-dir", collab.repo, "merge-base", "--is-ancestor", collab.base, remoteHead]);
286
+ }
287
+ catch {
288
+ throw new Error("Cannot auto-merge: canonical main and proposal diverged.");
289
+ }
290
+ git(["--git-dir", collab.repo, "update-ref", "refs/heads/main", remoteHead, collab.base]);
291
+ collab.base = remoteHead;
292
+ proposal.status = "merged";
293
+ proposal.mergedAt = Date.now();
294
+ collab.updatedAt = Date.now();
295
+ write(collab);
296
+ return true;
297
+ }
298
+ load();
299
+ //# sourceMappingURL=collabs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collabs.js","sourceRoot":"","sources":["../../../src/extensions/punch/collabs.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from \"node:fs\";\nimport * as path from \"node:path\";\n\nexport interface CollabProposal {\n\tbranch: string;\n\tauthor: string;\n\treviewer: string;\n\thead: string;\n\tauthorApprovedAt: number | null;\n\treviewerApprovedAt: number | null;\n\treviewedHead: string | null;\n\treviewNotes: string;\n\tstatus: \"pending_review\" | \"approved\" | \"changes_requested\" | \"merged\";\n\tmergedAt?: number;\n}\n\nexport interface Collab {\n\tid: string;\n\towner: string;\n\tparticipants: string[];\n\trepo: string;\n\tbaseRef: string;\n\tbase: string;\n\tworkspaces: Record<string, string>;\n\tproposal: CollabProposal | null;\n\tcreatedAt: number;\n\tupdatedAt: number;\n}\n\nconst ID_PATTERN = /^col_[a-f0-9]{12}$/;\nconst SHA_PATTERN = /^[a-f0-9]{40,64}$/;\n\nlet records: Collab[] = [];\n\nexport function collabStateFile(): string {\n\treturn path.join(process.cwd(), \".pi\", \"collabs.json\");\n}\n\nfunction load(): void {\n\tlet raw: string;\n\ttry {\n\t\traw = readFileSync(collabStateFile(), \"utf8\");\n\t} catch (err) {\n\t\tif ((err as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\t\trecords = [];\n\t\t\treturn;\n\t\t}\n\t\tthrow err;\n\t}\n\tconst parsed = JSON.parse(raw);\n\tif (!Array.isArray(parsed)) throw new Error(\"collabs.json must contain an array\");\n\trecords = parsed;\n}\n\nfunction reload(): void {\n\tload();\n}\n\nfunction save(): void {\n\tconst file = collabStateFile();\n\tmkdirSync(path.dirname(file), { recursive: true });\n\tconst tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n\twriteFileSync(tmp, JSON.stringify(records, null, 2), { mode: 0o600 });\n\trenameSync(tmp, file);\n}\n\nfunction collabOrThrow(id: string): Collab {\n\tif (!ID_PATTERN.test(id)) throw new Error(\"Invalid collaboration ID.\");\n\tconst collab = records.find((c) => c.id === id);\n\tif (!collab) throw new Error(\"Collaboration not found.\");\n\treturn collab;\n}\n\nfunction canonicalParticipant(collab: Collab, actor: string): string {\n\tconst participant = collab.participants.find((p) => p.toLowerCase() === actor.toLowerCase());\n\tif (!participant) throw new Error(\"Sandbox is not a collaboration participant.\");\n\treturn participant;\n}\n\nfunction requireParticipant(collab: Collab, actor: string): void {\n\tcanonicalParticipant(collab, actor);\n}\n\nfunction write(collab: Collab): void {\n\treload();\n\tconst index = records.findIndex((c) => c.id === collab.id);\n\tif (index === -1) throw new Error(\"Collaboration not found.\");\n\trecords[index] = collab;\n\tsave();\n}\n\nfunction workspaceRoot(): string {\n\treturn process.env.PI_WORKSPACE_ROOT || process.cwd();\n}\n\nfunction safeWorkspace(p: unknown): string {\n\tif (typeof p !== \"string\") throw new Error(\"Workspace must be an absolute path under the workspace root.\");\n\tif (p.includes(\"\\0\")) throw new Error(\"Workspace must be an absolute path under the workspace root.\");\n\tif (!path.isAbsolute(p)) throw new Error(\"Workspace must be an absolute path under the workspace root.\");\n\tconst resolved = path.resolve(p).replace(/\\/+$/, \"\");\n\tconst root = path.resolve(workspaceRoot()).replace(/\\/+$/, \"\");\n\tif (!resolved.startsWith(root + path.sep) || resolved === root) {\n\t\tthrow new Error(\"Workspace must be an absolute path under the workspace root.\");\n\t}\n\tlet realRoot: string;\n\ttry {\n\t\trealRoot = realpathSync(root);\n\t} catch {\n\t\treturn resolved;\n\t}\n\tlet existing = resolved;\n\twhile (true) {\n\t\tlet realExisting: string | null = null;\n\t\ttry {\n\t\t\trealExisting = realpathSync(existing);\n\t\t} catch {}\n\t\tif (realExisting !== null) {\n\t\t\tif (realExisting !== realRoot && !realExisting.startsWith(realRoot + path.sep)) {\n\t\t\t\tthrow new Error(\"Workspace must be an absolute path under the workspace root.\");\n\t\t\t}\n\t\t\tconst suffix = resolved.slice(existing.length);\n\t\t\tconst fullReal = `${realExisting}${suffix}`;\n\t\t\tif (!fullReal.startsWith(realRoot + path.sep)) {\n\t\t\t\tthrow new Error(\"Workspace must be an absolute path under the workspace root.\");\n\t\t\t}\n\t\t\treturn resolved;\n\t\t}\n\t\tconst parent = path.dirname(existing);\n\t\tif (parent === existing) {\n\t\t\treturn resolved;\n\t\t}\n\t\texisting = parent;\n\t}\n}\n\nfunction git(args: string[], cwd?: string): string {\n\treturn execFileSync(\"git\", args, { encoding: \"utf8\", cwd }).trim();\n}\n\nfunction bareHead(collab: Collab, branch: string): string {\n\treturn git([\"--git-dir\", collab.repo, \"rev-parse\", `refs/heads/${branch}`]).toLowerCase();\n}\n\nexport function validateCollabWorkspace(workspace: string): string {\n\treturn safeWorkspace(workspace);\n}\n\nexport function collabDir(): string {\n\tconst configured = process.env.PI_COLLAB_DIR;\n\tif (configured) return path.resolve(configured);\n\treturn path.join(process.cwd(), \".pi\", \"collab\");\n}\n\nexport function listFor(actor: string): Collab[] {\n\treload();\n\tconst lowered = actor.toLowerCase();\n\treturn records.filter((collab) => collab.participants.some((participant) => participant.toLowerCase() === lowered));\n}\n\nexport function getFor(id: string, actor: string): Collab {\n\treload();\n\tconst collab = collabOrThrow(id);\n\trequireParticipant(collab, actor);\n\treturn collab;\n}\n\nexport function create(opts: { owner: string; reviewer: string; workspace: string }): Collab {\n\tconst owner = opts.owner;\n\tconst reviewer = opts.reviewer;\n\tif (!reviewer || reviewer.toLowerCase() === owner.toLowerCase()) {\n\t\tthrow new Error(\"reviewer must be a different sandbox\");\n\t}\n\tconst source = safeWorkspace(opts.workspace);\n\tconst id = `col_${randomUUID().replace(/-/g, \"\").slice(0, 12)}`;\n\tconst repo = path.join(collabDir(), `${id}.git`);\n\tconst clonePath = path.join(collabDir(), id);\n\tif (!existsSync(path.join(source, \".git\"))) {\n\t\tgit([\"init\", \"--initial-branch=main\", source]);\n\t}\n\tlet hasHead = true;\n\ttry {\n\t\tgit([\"rev-parse\", \"--verify\", \"HEAD\"], source);\n\t} catch {\n\t\thasHead = false;\n\t}\n\tif (!hasHead) {\n\t\tgit([\"config\", \"user.name\", `Punch ${owner}`], source);\n\t\tgit([\"config\", \"user.email\", `${owner}@punch.local`], source);\n\t\tgit([\"add\", \"--all\"], source);\n\t\tgit([\"commit\", \"--allow-empty\", \"--message\", \"Initialize collaboration\"], source);\n\t}\n\tmkdirSync(path.dirname(repo), { recursive: true });\n\tgit([\"clone\", \"--bare\", source, repo]);\n\tconst base = git([\"--git-dir\", repo, \"rev-parse\", \"HEAD\"]).toLowerCase();\n\tgit([\"--git-dir\", repo, \"update-ref\", \"refs/heads/main\", base]);\n\tgit([\"--git-dir\", repo, \"symbolic-ref\", \"HEAD\", \"refs/heads/main\"]);\n\ttry {\n\t\tgit([\"remote\", \"remove\", \"punch-collab\"], source);\n\t} catch {}\n\tgit([\"remote\", \"add\", \"punch-collab\", repo], source);\n\tmkdirSync(clonePath, { recursive: true });\n\tgit([\"clone\", repo, clonePath]);\n\tconst collab: Collab = {\n\t\tid,\n\t\towner,\n\t\tparticipants: [owner, reviewer],\n\t\trepo,\n\t\tbaseRef: \"main\",\n\t\tbase,\n\t\tworkspaces: { [owner]: source, [reviewer]: clonePath },\n\t\tproposal: null,\n\t\tcreatedAt: Date.now(),\n\t\tupdatedAt: Date.now(),\n\t};\n\treload();\n\trecords.push(collab);\n\tsave();\n\treturn collab;\n}\n\nexport function propose(opts: { id: string; actor: string; head: string }): Collab {\n\treload();\n\tif (!SHA_PATTERN.test(opts.head)) throw new Error(\"Invalid proposal SHA.\");\n\tconst collab = collabOrThrow(opts.id);\n\trequireParticipant(collab, opts.actor);\n\tconst branch = `changes/${opts.id}`;\n\tconst remoteHead = bareHead(collab, branch);\n\tif (remoteHead !== opts.head.toLowerCase())\n\t\tthrow new Error(\"Proposal SHA is not current collaboration branch head.\");\n\ttry {\n\t\tgit([\"--git-dir\", collab.repo, \"merge-base\", \"--is-ancestor\", collab.base, remoteHead]);\n\t} catch {\n\t\tthrow new Error(\"Proposal does not descend from canonical main.\");\n\t}\n\tconst author = canonicalParticipant(collab, opts.actor);\n\tconst reviewer = collab.participants.find((p) => p.toLowerCase() !== author.toLowerCase());\n\tif (!reviewer) throw new Error(\"No reviewer participant.\");\n\tconst previous = collab.proposal;\n\tif (previous?.status === \"changes_requested\") {\n\t\tconst rejectedHead = previous.reviewedHead ?? previous.head;\n\t\tif (rejectedHead === remoteHead) {\n\t\t\tthrow new Error(\"Proposal unchanged since changes were requested; push new commits before reproposing.\");\n\t\t}\n\t}\n\tcollab.proposal = {\n\t\tbranch,\n\t\tauthor,\n\t\treviewer,\n\t\thead: remoteHead,\n\t\tauthorApprovedAt: Date.now(),\n\t\treviewerApprovedAt: null,\n\t\treviewedHead: null,\n\t\treviewNotes: \"\",\n\t\tstatus: \"pending_review\",\n\t};\n\tcollab.updatedAt = Date.now();\n\twrite(collab);\n\treturn collab;\n}\n\nexport function review(opts: { id: string; actor: string; approve: boolean; notes?: string }): Collab {\n\treload();\n\tconst collab = collabOrThrow(opts.id);\n\trequireParticipant(collab, opts.actor);\n\tconst proposal = collab.proposal;\n\tif (!proposal || proposal.status === \"merged\") throw new Error(\"No proposal awaiting review.\");\n\tif (proposal.status === \"changes_requested\") {\n\t\tthrow new Error(\"Proposal has changes requested; author must propose a new SHA before review.\");\n\t}\n\tif (proposal.reviewer.toLowerCase() !== canonicalParticipant(collab, opts.actor).toLowerCase()) {\n\t\tthrow new Error(\"Only other participant may review this proposal.\");\n\t}\n\tconst remoteHead = bareHead(collab, proposal.branch);\n\tif (remoteHead !== proposal.head) throw new Error(\"Branch changed. Author must propose new SHA again.\");\n\tproposal.reviewNotes = String(opts.notes || \"\").slice(0, 4000);\n\tproposal.reviewedHead = remoteHead;\n\tif (!opts.approve) {\n\t\tproposal.reviewerApprovedAt = null;\n\t\tproposal.status = \"changes_requested\";\n\t\tcollab.updatedAt = Date.now();\n\t\twrite(collab);\n\t\treturn collab;\n\t}\n\tproposal.reviewerApprovedAt = Date.now();\n\ttry {\n\t\tif (mergeIfApproved(collab)) return collabOrThrow(collab.id);\n\t\tproposal.status = \"approved\";\n\t\tcollab.updatedAt = Date.now();\n\t\twrite(collab);\n\t\treturn collab;\n\t} catch (err) {\n\t\tproposal.reviewerApprovedAt = null;\n\t\tproposal.reviewedHead = null;\n\t\tthrow err;\n\t}\n}\n\nfunction mergeIfApproved(collab: Collab): boolean {\n\tconst proposal = collab.proposal;\n\tif (!proposal) return false;\n\tif (!proposal.authorApprovedAt || !proposal.reviewerApprovedAt) return false;\n\tif (proposal.reviewedHead !== proposal.head) return false;\n\tconst remoteHead = bareHead(collab, proposal.branch);\n\tif (remoteHead !== proposal.head) return false;\n\ttry {\n\t\tgit([\"--git-dir\", collab.repo, \"merge-base\", \"--is-ancestor\", collab.base, remoteHead]);\n\t} catch {\n\t\tthrow new Error(\"Cannot auto-merge: canonical main and proposal diverged.\");\n\t}\n\tgit([\"--git-dir\", collab.repo, \"update-ref\", \"refs/heads/main\", remoteHead, collab.base]);\n\tcollab.base = remoteHead;\n\tproposal.status = \"merged\";\n\tproposal.mergedAt = Date.now();\n\tcollab.updatedAt = Date.now();\n\twrite(collab);\n\treturn true;\n}\n\nload();\n"]}
@@ -0,0 +1,3 @@
1
+ import type { ExtensionAPI } from "../../core/extensions/types.ts";
2
+ export default function punchExtension(pi: ExtensionAPI): void;
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/punch/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAkEnE,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA8L7D","sourcesContent":["import { execFileSync } from \"node:child_process\";\n\nimport { StringEnum } from \"@punch-bot/ai\";\nimport { Type } from \"typebox\";\n\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\nimport { getAuthHeader, isAuthConfigured } from \"./auth.ts\";\nimport { validateCollabWorkspace } from \"./collabs.ts\";\nimport { startScheduler } from \"./routines.ts\";\nimport { startPunchServer } from \"./server.ts\";\nimport { installTodos } from \"./todos.ts\";\n\nconst PORT = Number(process.env.PI_BOT_PORT) || 4098;\nconst BOT_URL = process.env.PUNCH_BOT_URL || `http://localhost:${PORT}`;\n\nfunction authHeader(): string {\n\tconst envUser = process.env.PI_SERVER_USERNAME || process.env.OPENCODE_SERVER_USERNAME || \"opencode\";\n\tconst envPass = process.env.PI_SERVER_PASSWORD || process.env.OPENCODE_SERVER_PASSWORD || \"\";\n\tif (envPass) return `Basic ${Buffer.from(`${envUser}:${envPass}`).toString(\"base64\")}`;\n\treturn getAuthHeader() ?? `Basic ${Buffer.from(`${envUser}:`).toString(\"base64\")}`;\n}\n\nfunction safeBotUrl(): string | null {\n\tconst url = BOT_URL;\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\tif (parsed.protocol === \"https:\") return url;\n\t\tif (\n\t\t\tparsed.protocol === \"http:\" &&\n\t\t\t(parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\" || parsed.hostname === \"::1\")\n\t\t)\n\t\t\treturn url;\n\t} catch {}\n\treturn null;\n}\n\nasync function botFetch(path: string, init: RequestInit = {}): Promise<Record<string, unknown>> {\n\tconst url = safeBotUrl();\n\tif (!url) throw new Error(\"PUNCH_BOT_URL must use https or a localhost http endpoint\");\n\tconst response = await fetch(`${url}${path}`, {\n\t\t...init,\n\t\theaders: { \"content-type\": \"application/json\", authorization: authHeader(), ...(init.headers ?? {}) },\n\t});\n\tconst text = await response.text();\n\tlet data: unknown;\n\ttry {\n\t\tdata = JSON.parse(text);\n\t} catch {\n\t\tdata = { raw: text };\n\t}\n\tif (!response.ok) throw new Error((data as { error?: string }).error || `${response.status} ${text}`);\n\treturn (data ?? {}) as Record<string, unknown>;\n}\n\nfunction git(workspace: string, args: string[]): string {\n\treturn execFileSync(\"git\", [\"-C\", workspace, ...args], { encoding: \"utf8\" }).trim();\n}\n\nfunction sandboxActor(): string {\n\treturn (process.env.PI_SERVER_USERNAME || process.env.OPENCODE_SERVER_USERNAME || \"opencode\").toLowerCase();\n}\n\nfunction workspaceFor(collab: { workspaces: Record<string, string> }, actorKey: string): string | undefined {\n\tconst normalized = actorKey.toLowerCase();\n\tif (collab.workspaces[normalized]) return collab.workspaces[normalized];\n\tfor (const [key, value] of Object.entries(collab.workspaces)) {\n\t\tif (key.toLowerCase() === normalized) return value;\n\t}\n\treturn undefined;\n}\n\nexport default function punchExtension(pi: ExtensionAPI): void {\n\tif (process.env.PUNCH_EMBEDDED_SERVER !== \"0\") {\n\t\tstartScheduler(async (routine) => {\n\t\t\tswitch (routine.type) {\n\t\t\t\tcase \"message\":\n\t\t\t\t\tpi.sendUserMessage(routine.payload);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"heartbeat\":\n\t\t\t\t\tpi.sendUserMessage(`heartbeat: ${routine.payload}`);\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"llm\":\n\t\t\t\t\tpi.sendUserMessage(routine.payload);\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t});\n\t\tif (!isAuthConfigured()) {\n\t\t\tconsole.warn(\"punch server disabled: no auth credentials configured\");\n\t\t}\n\t\tstartPunchServer();\n\t}\n\tinstallTodos(pi);\n\n\tpi.registerTool({\n\t\tname: \"collab\",\n\t\tlabel: \"Punch collaboration\",\n\t\tdescription:\n\t\t\t\"Propose, fetch, and review a two-agent Git collaboration. Canonical main auto-merges only after both agents approve the same SHA.\",\n\t\tpromptSnippet: \"Use collab for shared cross-sandbox code review\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before approving, fetch exact proposed SHA, inspect diff, and run relevant tests.\",\n\t\t\t\"Any change needs a new proposal and a fresh review.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\taction: StringEnum([\"start\", \"list\", \"status\", \"propose\", \"review\"] as const),\n\t\t\tid: Type.Optional(Type.String({ description: \"Collaboration ID\" })),\n\t\t\treviewer: Type.Optional(Type.String({ description: \"Other registered sandbox name, for start\" })),\n\t\t\tworkspace: Type.Optional(Type.String({ description: \"Local collaboration workspace\" })),\n\t\t\ttask: Type.Optional(Type.String({ description: \"Work request sent to peer agent, for start\" })),\n\t\t\tapprove: Type.Optional(Type.Boolean({ description: \"For review: true to approve, false to request changes\" })),\n\t\t\tnotes: Type.Optional(Type.String({ description: \"Review findings or approval summary\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args) {\n\t\t\tif (args.action === \"start\") {\n\t\t\t\tif (!args.reviewer || !args.workspace) throw new Error(\"reviewer and workspace are required to start\");\n\t\t\t\tconst data = await botFetch(\"/collabs/create\", {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tbody: JSON.stringify({ reviewer: args.reviewer, workspace: args.workspace, task: args.task || \"\" }),\n\t\t\t\t});\n\t\t\t\tconst collab = data.collab as { id: string; workspaces: Record<string, string> };\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Started ${collab.id}. Git repository ready at ${args.workspace}; peer clone: ${collab.workspaces[String(args.reviewer)] || \"created\"}.`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (args.action === \"list\") {\n\t\t\t\tconst data = await botFetch(\"/collabs\");\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data.collabs, null, 2) }], details: {} };\n\t\t\t}\n\t\t\tif (!args.id) throw new Error(\"id is required\");\n\t\t\tif (args.action === \"status\") {\n\t\t\t\tconst data = await botFetch(`/collabs/${encodeURIComponent(args.id)}`);\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data.collab, null, 2) }], details: {} };\n\t\t\t}\n\t\t\tconst status = await botFetch(`/collabs/${encodeURIComponent(args.id)}`);\n\t\t\tconst collab = status.collab as {\n\t\t\t\trepo: string;\n\t\t\t\tworkspaces: Record<string, string>;\n\t\t\t\tproposal?: { reviewer?: string; status?: string };\n\t\t\t};\n\t\t\tconst workspace = args.workspace\n\t\t\t\t? validateCollabWorkspace(args.workspace)\n\t\t\t\t: workspaceFor(collab, process.env.SANDBOX_NAME || sandboxActor());\n\t\t\tif (!workspace) throw new Error(\"workspace is required\");\n\t\t\tconst branch = `changes/${args.id}`;\n\t\t\tif (args.action === \"propose\") {\n\t\t\t\ttry {\n\t\t\t\t\tgit(workspace, [\"remote\", \"set-url\", \"punch-collab\", collab.repo]);\n\t\t\t\t} catch {\n\t\t\t\t\tgit(workspace, [\"remote\", \"add\", \"punch-collab\", collab.repo]);\n\t\t\t\t}\n\t\t\t\tconst head = git(workspace, [\"rev-parse\", \"HEAD\"]);\n\t\t\t\tgit(workspace, [\"push\", \"punch-collab\", `HEAD:refs/heads/${branch}`]);\n\t\t\t\tconst data = await botFetch(`/collabs/${encodeURIComponent(args.id)}/propose`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tbody: JSON.stringify({ head }),\n\t\t\t\t});\n\t\t\t\tconst proposal = (data.collab as { proposal?: { reviewer?: string } }).proposal;\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{ type: \"text\", text: `Proposed ${head}. Review requested from ${proposal?.reviewer ?? \"\"}.` },\n\t\t\t\t\t],\n\t\t\t\t\tdetails: {},\n\t\t\t\t};\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tgit(workspace, [\"remote\", \"set-url\", \"punch-collab\", collab.repo]);\n\t\t\t} catch {\n\t\t\t\tgit(workspace, [\"remote\", \"add\", \"punch-collab\", collab.repo]);\n\t\t\t}\n\t\t\tgit(workspace, [\"fetch\", \"punch-collab\", branch]);\n\t\t\tconst data = await botFetch(`/collabs/${encodeURIComponent(args.id)}/review`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({ approve: args.approve === true, notes: args.notes || \"\" }),\n\t\t\t});\n\t\t\tconst proposal = (data.collab as { proposal?: { status?: string } }).proposal;\n\t\t\tconst text =\n\t\t\t\tproposal?.status === \"merged\"\n\t\t\t\t\t? \"Approved. Matching approvals auto-merged into main.\"\n\t\t\t\t\t: args.approve\n\t\t\t\t\t\t? \"Approved. Awaiting auto-merge.\"\n\t\t\t\t\t\t: \"Changes requested.\";\n\t\t\treturn { content: [{ type: \"text\", text }], details: {} };\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"routines\",\n\t\tlabel: \"Punch routines\",\n\t\tdescription: \"Schedule reminders, automations, and heartbeat routines\",\n\t\tpromptSnippet: \"Create/list/pause reminders and heartbeat routines\",\n\t\tpromptGuidelines: [\"Use routines when the user asks for a reminder, recurring ping, or heartbeat automation.\"],\n\t\tparameters: Type.Object({\n\t\t\taction: StringEnum([\"create\", \"list\", \"remove\", \"pause\", \"resume\"] as const),\n\t\t\tuserId: Type.String({ description: \"User ID owning the routine\" }),\n\t\t\tchannelId: Type.Optional(\n\t\t\t\tType.String({ description: \"Channel ID where the routine was requested (required for message/llm types)\" }),\n\t\t\t),\n\t\t\ttype: Type.Optional(StringEnum([\"message\", \"llm\", \"heartbeat\"] as const)),\n\t\t\twhen: Type.Optional(Type.String({ description: \"When to run (e.g. 30m, tomorrow 9am, every 6h)\" })),\n\t\t\ttext: Type.Optional(Type.String({ description: \"Reminder text or prompt\" })),\n\t\t\trecurrence: Type.Optional(\n\t\t\t\tType.String({ description: \"once, daily, weekly, every 30m, every 2h, or cron expression\" }),\n\t\t\t),\n\t\t\ttimezone: Type.Optional(Type.String({ description: \"IANA timezone for interpreting when\" })),\n\t\t\tid: Type.Optional(Type.String({ description: \"Routine id for remove/pause/resume\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args) {\n\t\t\tif (args.action === \"list\") {\n\t\t\t\tconst data = await botFetch(`/routines/list?userId=${encodeURIComponent(args.userId)}`);\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data.routines || [], null, 2) }], details: {} };\n\t\t\t}\n\t\t\tif (args.action === \"remove\") {\n\t\t\t\tif (!args.id) throw new Error(\"id is required for remove\");\n\t\t\t\tconst data = await botFetch(`/routines/${encodeURIComponent(args.id)}`, {\n\t\t\t\t\tmethod: \"DELETE\",\n\t\t\t\t\tbody: JSON.stringify({ userId: args.userId }),\n\t\t\t\t});\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data, null, 2) }], details: {} };\n\t\t\t}\n\t\t\tif (args.action === \"pause\") {\n\t\t\t\tif (!args.id) throw new Error(\"id is required for pause\");\n\t\t\t\tconst data = await botFetch(`/routines/${encodeURIComponent(args.id)}/pause`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tbody: JSON.stringify({ userId: args.userId }),\n\t\t\t\t});\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data, null, 2) }], details: {} };\n\t\t\t}\n\t\t\tif (args.action === \"resume\") {\n\t\t\t\tif (!args.id) throw new Error(\"id is required for resume\");\n\t\t\t\tconst data = await botFetch(`/routines/${encodeURIComponent(args.id)}/resume`, {\n\t\t\t\t\tmethod: \"POST\",\n\t\t\t\t\tbody: JSON.stringify({ userId: args.userId }),\n\t\t\t\t});\n\t\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data, null, 2) }], details: {} };\n\t\t\t}\n\t\t\tconst routineType = args.type || \"message\";\n\t\t\tif (routineType !== \"heartbeat\" && !args.channelId)\n\t\t\t\tthrow new Error(\"channelId is required for create (except heartbeat type)\");\n\t\t\tif (!args.text) throw new Error(\"text is required for create\");\n\t\t\tif (!args.when) throw new Error(\"when is required for create\");\n\t\t\tconst data = await botFetch(\"/routines/create\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tuserId: args.userId,\n\t\t\t\t\tchannelId: args.channelId || null,\n\t\t\t\t\ttype: routineType,\n\t\t\t\t\tpayload: args.text,\n\t\t\t\t\twhen: args.when,\n\t\t\t\t\trecurrence: args.recurrence || \"once\",\n\t\t\t\t\ttimezone: args.timezone || null,\n\t\t\t\t}),\n\t\t\t});\n\t\t\treturn { content: [{ type: \"text\", text: JSON.stringify(data.routine, null, 2) }], details: {} };\n\t\t},\n\t});\n}\n"]}
@@ -0,0 +1,256 @@
1
+ import { execFileSync } from "node:child_process";
2
+ import { StringEnum } from "@punch-bot/ai";
3
+ import { Type } from "typebox";
4
+ import { getAuthHeader, isAuthConfigured } from "./auth.js";
5
+ import { validateCollabWorkspace } from "./collabs.js";
6
+ import { startScheduler } from "./routines.js";
7
+ import { startPunchServer } from "./server.js";
8
+ import { installTodos } from "./todos.js";
9
+ const PORT = Number(process.env.PI_BOT_PORT) || 4098;
10
+ const BOT_URL = process.env.PUNCH_BOT_URL || `http://localhost:${PORT}`;
11
+ function authHeader() {
12
+ const envUser = process.env.PI_SERVER_USERNAME || process.env.OPENCODE_SERVER_USERNAME || "opencode";
13
+ const envPass = process.env.PI_SERVER_PASSWORD || process.env.OPENCODE_SERVER_PASSWORD || "";
14
+ if (envPass)
15
+ return `Basic ${Buffer.from(`${envUser}:${envPass}`).toString("base64")}`;
16
+ return getAuthHeader() ?? `Basic ${Buffer.from(`${envUser}:`).toString("base64")}`;
17
+ }
18
+ function safeBotUrl() {
19
+ const url = BOT_URL;
20
+ try {
21
+ const parsed = new URL(url);
22
+ if (parsed.protocol === "https:")
23
+ return url;
24
+ if (parsed.protocol === "http:" &&
25
+ (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "::1"))
26
+ return url;
27
+ }
28
+ catch { }
29
+ return null;
30
+ }
31
+ async function botFetch(path, init = {}) {
32
+ const url = safeBotUrl();
33
+ if (!url)
34
+ throw new Error("PUNCH_BOT_URL must use https or a localhost http endpoint");
35
+ const response = await fetch(`${url}${path}`, {
36
+ ...init,
37
+ headers: { "content-type": "application/json", authorization: authHeader(), ...(init.headers ?? {}) },
38
+ });
39
+ const text = await response.text();
40
+ let data;
41
+ try {
42
+ data = JSON.parse(text);
43
+ }
44
+ catch {
45
+ data = { raw: text };
46
+ }
47
+ if (!response.ok)
48
+ throw new Error(data.error || `${response.status} ${text}`);
49
+ return (data ?? {});
50
+ }
51
+ function git(workspace, args) {
52
+ return execFileSync("git", ["-C", workspace, ...args], { encoding: "utf8" }).trim();
53
+ }
54
+ function sandboxActor() {
55
+ return (process.env.PI_SERVER_USERNAME || process.env.OPENCODE_SERVER_USERNAME || "opencode").toLowerCase();
56
+ }
57
+ function workspaceFor(collab, actorKey) {
58
+ const normalized = actorKey.toLowerCase();
59
+ if (collab.workspaces[normalized])
60
+ return collab.workspaces[normalized];
61
+ for (const [key, value] of Object.entries(collab.workspaces)) {
62
+ if (key.toLowerCase() === normalized)
63
+ return value;
64
+ }
65
+ return undefined;
66
+ }
67
+ export default function punchExtension(pi) {
68
+ if (process.env.PUNCH_EMBEDDED_SERVER !== "0") {
69
+ startScheduler(async (routine) => {
70
+ switch (routine.type) {
71
+ case "message":
72
+ pi.sendUserMessage(routine.payload);
73
+ break;
74
+ case "heartbeat":
75
+ pi.sendUserMessage(`heartbeat: ${routine.payload}`);
76
+ break;
77
+ case "llm":
78
+ pi.sendUserMessage(routine.payload);
79
+ break;
80
+ }
81
+ });
82
+ if (!isAuthConfigured()) {
83
+ console.warn("punch server disabled: no auth credentials configured");
84
+ }
85
+ startPunchServer();
86
+ }
87
+ installTodos(pi);
88
+ pi.registerTool({
89
+ name: "collab",
90
+ label: "Punch collaboration",
91
+ description: "Propose, fetch, and review a two-agent Git collaboration. Canonical main auto-merges only after both agents approve the same SHA.",
92
+ promptSnippet: "Use collab for shared cross-sandbox code review",
93
+ promptGuidelines: [
94
+ "Before approving, fetch exact proposed SHA, inspect diff, and run relevant tests.",
95
+ "Any change needs a new proposal and a fresh review.",
96
+ ],
97
+ parameters: Type.Object({
98
+ action: StringEnum(["start", "list", "status", "propose", "review"]),
99
+ id: Type.Optional(Type.String({ description: "Collaboration ID" })),
100
+ reviewer: Type.Optional(Type.String({ description: "Other registered sandbox name, for start" })),
101
+ workspace: Type.Optional(Type.String({ description: "Local collaboration workspace" })),
102
+ task: Type.Optional(Type.String({ description: "Work request sent to peer agent, for start" })),
103
+ approve: Type.Optional(Type.Boolean({ description: "For review: true to approve, false to request changes" })),
104
+ notes: Type.Optional(Type.String({ description: "Review findings or approval summary" })),
105
+ }),
106
+ async execute(_toolCallId, args) {
107
+ if (args.action === "start") {
108
+ if (!args.reviewer || !args.workspace)
109
+ throw new Error("reviewer and workspace are required to start");
110
+ const data = await botFetch("/collabs/create", {
111
+ method: "POST",
112
+ body: JSON.stringify({ reviewer: args.reviewer, workspace: args.workspace, task: args.task || "" }),
113
+ });
114
+ const collab = data.collab;
115
+ return {
116
+ content: [
117
+ {
118
+ type: "text",
119
+ text: `Started ${collab.id}. Git repository ready at ${args.workspace}; peer clone: ${collab.workspaces[String(args.reviewer)] || "created"}.`,
120
+ },
121
+ ],
122
+ details: {},
123
+ };
124
+ }
125
+ if (args.action === "list") {
126
+ const data = await botFetch("/collabs");
127
+ return { content: [{ type: "text", text: JSON.stringify(data.collabs, null, 2) }], details: {} };
128
+ }
129
+ if (!args.id)
130
+ throw new Error("id is required");
131
+ if (args.action === "status") {
132
+ const data = await botFetch(`/collabs/${encodeURIComponent(args.id)}`);
133
+ return { content: [{ type: "text", text: JSON.stringify(data.collab, null, 2) }], details: {} };
134
+ }
135
+ const status = await botFetch(`/collabs/${encodeURIComponent(args.id)}`);
136
+ const collab = status.collab;
137
+ const workspace = args.workspace
138
+ ? validateCollabWorkspace(args.workspace)
139
+ : workspaceFor(collab, process.env.SANDBOX_NAME || sandboxActor());
140
+ if (!workspace)
141
+ throw new Error("workspace is required");
142
+ const branch = `changes/${args.id}`;
143
+ if (args.action === "propose") {
144
+ try {
145
+ git(workspace, ["remote", "set-url", "punch-collab", collab.repo]);
146
+ }
147
+ catch {
148
+ git(workspace, ["remote", "add", "punch-collab", collab.repo]);
149
+ }
150
+ const head = git(workspace, ["rev-parse", "HEAD"]);
151
+ git(workspace, ["push", "punch-collab", `HEAD:refs/heads/${branch}`]);
152
+ const data = await botFetch(`/collabs/${encodeURIComponent(args.id)}/propose`, {
153
+ method: "POST",
154
+ body: JSON.stringify({ head }),
155
+ });
156
+ const proposal = data.collab.proposal;
157
+ return {
158
+ content: [
159
+ { type: "text", text: `Proposed ${head}. Review requested from ${proposal?.reviewer ?? ""}.` },
160
+ ],
161
+ details: {},
162
+ };
163
+ }
164
+ try {
165
+ git(workspace, ["remote", "set-url", "punch-collab", collab.repo]);
166
+ }
167
+ catch {
168
+ git(workspace, ["remote", "add", "punch-collab", collab.repo]);
169
+ }
170
+ git(workspace, ["fetch", "punch-collab", branch]);
171
+ const data = await botFetch(`/collabs/${encodeURIComponent(args.id)}/review`, {
172
+ method: "POST",
173
+ body: JSON.stringify({ approve: args.approve === true, notes: args.notes || "" }),
174
+ });
175
+ const proposal = data.collab.proposal;
176
+ const text = proposal?.status === "merged"
177
+ ? "Approved. Matching approvals auto-merged into main."
178
+ : args.approve
179
+ ? "Approved. Awaiting auto-merge."
180
+ : "Changes requested.";
181
+ return { content: [{ type: "text", text }], details: {} };
182
+ },
183
+ });
184
+ pi.registerTool({
185
+ name: "routines",
186
+ label: "Punch routines",
187
+ description: "Schedule reminders, automations, and heartbeat routines",
188
+ promptSnippet: "Create/list/pause reminders and heartbeat routines",
189
+ promptGuidelines: ["Use routines when the user asks for a reminder, recurring ping, or heartbeat automation."],
190
+ parameters: Type.Object({
191
+ action: StringEnum(["create", "list", "remove", "pause", "resume"]),
192
+ userId: Type.String({ description: "User ID owning the routine" }),
193
+ channelId: Type.Optional(Type.String({ description: "Channel ID where the routine was requested (required for message/llm types)" })),
194
+ type: Type.Optional(StringEnum(["message", "llm", "heartbeat"])),
195
+ when: Type.Optional(Type.String({ description: "When to run (e.g. 30m, tomorrow 9am, every 6h)" })),
196
+ text: Type.Optional(Type.String({ description: "Reminder text or prompt" })),
197
+ recurrence: Type.Optional(Type.String({ description: "once, daily, weekly, every 30m, every 2h, or cron expression" })),
198
+ timezone: Type.Optional(Type.String({ description: "IANA timezone for interpreting when" })),
199
+ id: Type.Optional(Type.String({ description: "Routine id for remove/pause/resume" })),
200
+ }),
201
+ async execute(_toolCallId, args) {
202
+ if (args.action === "list") {
203
+ const data = await botFetch(`/routines/list?userId=${encodeURIComponent(args.userId)}`);
204
+ return { content: [{ type: "text", text: JSON.stringify(data.routines || [], null, 2) }], details: {} };
205
+ }
206
+ if (args.action === "remove") {
207
+ if (!args.id)
208
+ throw new Error("id is required for remove");
209
+ const data = await botFetch(`/routines/${encodeURIComponent(args.id)}`, {
210
+ method: "DELETE",
211
+ body: JSON.stringify({ userId: args.userId }),
212
+ });
213
+ return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }], details: {} };
214
+ }
215
+ if (args.action === "pause") {
216
+ if (!args.id)
217
+ throw new Error("id is required for pause");
218
+ const data = await botFetch(`/routines/${encodeURIComponent(args.id)}/pause`, {
219
+ method: "POST",
220
+ body: JSON.stringify({ userId: args.userId }),
221
+ });
222
+ return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }], details: {} };
223
+ }
224
+ if (args.action === "resume") {
225
+ if (!args.id)
226
+ throw new Error("id is required for resume");
227
+ const data = await botFetch(`/routines/${encodeURIComponent(args.id)}/resume`, {
228
+ method: "POST",
229
+ body: JSON.stringify({ userId: args.userId }),
230
+ });
231
+ return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }], details: {} };
232
+ }
233
+ const routineType = args.type || "message";
234
+ if (routineType !== "heartbeat" && !args.channelId)
235
+ throw new Error("channelId is required for create (except heartbeat type)");
236
+ if (!args.text)
237
+ throw new Error("text is required for create");
238
+ if (!args.when)
239
+ throw new Error("when is required for create");
240
+ const data = await botFetch("/routines/create", {
241
+ method: "POST",
242
+ body: JSON.stringify({
243
+ userId: args.userId,
244
+ channelId: args.channelId || null,
245
+ type: routineType,
246
+ payload: args.text,
247
+ when: args.when,
248
+ recurrence: args.recurrence || "once",
249
+ timezone: args.timezone || null,
250
+ }),
251
+ });
252
+ return { content: [{ type: "text", text: JSON.stringify(data.routine, null, 2) }], details: {} };
253
+ },
254
+ });
255
+ }
256
+ //# sourceMappingURL=index.js.map