@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,220 @@
1
+ /**
2
+ * SSH Remote Execution Example
3
+ *
4
+ * Demonstrates delegating tool operations to a remote machine via SSH.
5
+ * When --ssh is provided, read/write/edit/bash run on the remote.
6
+ *
7
+ * Usage:
8
+ * pi -e ./ssh.ts --ssh user@host
9
+ * pi -e ./ssh.ts --ssh user@host:/remote/path
10
+ *
11
+ * Requirements:
12
+ * - SSH key-based auth (no password prompts)
13
+ * - bash on remote
14
+ */
15
+
16
+ import { spawn } from "node:child_process";
17
+ import type { ExtensionAPI } from "@punch-bot/cli";
18
+ import {
19
+ type BashOperations,
20
+ createBashTool,
21
+ createEditTool,
22
+ createReadTool,
23
+ createWriteTool,
24
+ type EditOperations,
25
+ type ReadOperations,
26
+ type WriteOperations,
27
+ } from "@punch-bot/cli";
28
+
29
+ function sshExec(remote: string, command: string): Promise<Buffer> {
30
+ return new Promise((resolve, reject) => {
31
+ const child = spawn("ssh", [remote, command], { stdio: ["ignore", "pipe", "pipe"] });
32
+ const chunks: Buffer[] = [];
33
+ const errChunks: Buffer[] = [];
34
+ child.stdout.on("data", (data) => chunks.push(data));
35
+ child.stderr.on("data", (data) => errChunks.push(data));
36
+ child.on("error", reject);
37
+ child.on("close", (code) => {
38
+ if (code !== 0) {
39
+ reject(new Error(`SSH failed (${code}): ${Buffer.concat(errChunks).toString()}`));
40
+ } else {
41
+ resolve(Buffer.concat(chunks));
42
+ }
43
+ });
44
+ });
45
+ }
46
+
47
+ function createRemoteReadOps(remote: string, remoteCwd: string, localCwd: string): ReadOperations {
48
+ const toRemote = (p: string) => p.replace(localCwd, remoteCwd);
49
+ return {
50
+ readFile: (p) => sshExec(remote, `cat ${JSON.stringify(toRemote(p))}`),
51
+ access: (p) => sshExec(remote, `test -r ${JSON.stringify(toRemote(p))}`).then(() => {}),
52
+ detectImageMimeType: async (p) => {
53
+ try {
54
+ const r = await sshExec(remote, `file --mime-type -b ${JSON.stringify(toRemote(p))}`);
55
+ const m = r.toString().trim();
56
+ return ["image/jpeg", "image/png", "image/gif", "image/webp"].includes(m) ? m : null;
57
+ } catch {
58
+ return null;
59
+ }
60
+ },
61
+ };
62
+ }
63
+
64
+ function createRemoteWriteOps(remote: string, remoteCwd: string, localCwd: string): WriteOperations {
65
+ const toRemote = (p: string) => p.replace(localCwd, remoteCwd);
66
+ return {
67
+ writeFile: async (p, content) => {
68
+ const b64 = Buffer.from(content).toString("base64");
69
+ await sshExec(remote, `echo ${JSON.stringify(b64)} | base64 -d > ${JSON.stringify(toRemote(p))}`);
70
+ },
71
+ mkdir: (dir) => sshExec(remote, `mkdir -p ${JSON.stringify(toRemote(dir))}`).then(() => {}),
72
+ };
73
+ }
74
+
75
+ function createRemoteEditOps(remote: string, remoteCwd: string, localCwd: string): EditOperations {
76
+ const r = createRemoteReadOps(remote, remoteCwd, localCwd);
77
+ const w = createRemoteWriteOps(remote, remoteCwd, localCwd);
78
+ return { readFile: r.readFile, access: r.access, writeFile: w.writeFile };
79
+ }
80
+
81
+ function createRemoteBashOps(remote: string, remoteCwd: string, localCwd: string): BashOperations {
82
+ const toRemote = (p: string) => p.replace(localCwd, remoteCwd);
83
+ return {
84
+ exec: (command, cwd, { onData, signal, timeout }) =>
85
+ new Promise((resolve, reject) => {
86
+ const cmd = `cd ${JSON.stringify(toRemote(cwd))} && ${command}`;
87
+ const child = spawn("ssh", [remote, cmd], { stdio: ["ignore", "pipe", "pipe"] });
88
+ let timedOut = false;
89
+ const timer = timeout
90
+ ? setTimeout(() => {
91
+ timedOut = true;
92
+ child.kill();
93
+ }, timeout * 1000)
94
+ : undefined;
95
+ child.stdout.on("data", onData);
96
+ child.stderr.on("data", onData);
97
+ child.on("error", (e) => {
98
+ if (timer) clearTimeout(timer);
99
+ reject(e);
100
+ });
101
+ const onAbort = () => child.kill();
102
+ signal?.addEventListener("abort", onAbort, { once: true });
103
+ child.on("close", (code) => {
104
+ if (timer) clearTimeout(timer);
105
+ signal?.removeEventListener("abort", onAbort);
106
+ if (signal?.aborted) reject(new Error("aborted"));
107
+ else if (timedOut) reject(new Error(`timeout:${timeout}`));
108
+ else resolve({ exitCode: code });
109
+ });
110
+ }),
111
+ };
112
+ }
113
+
114
+ export default function (pi: ExtensionAPI) {
115
+ pi.registerFlag("ssh", { description: "SSH remote: user@host or user@host:/path", type: "string" });
116
+
117
+ const localCwd = process.cwd();
118
+ const localRead = createReadTool(localCwd);
119
+ const localWrite = createWriteTool(localCwd);
120
+ const localEdit = createEditTool(localCwd);
121
+ const localBash = createBashTool(localCwd);
122
+
123
+ // Resolved lazily on session_start (CLI flags not available during factory)
124
+ let resolvedSsh: { remote: string; remoteCwd: string } | null = null;
125
+
126
+ const getSsh = () => resolvedSsh;
127
+
128
+ pi.registerTool({
129
+ ...localRead,
130
+ async execute(id, params, signal, onUpdate, _ctx) {
131
+ const ssh = getSsh();
132
+ if (ssh) {
133
+ const tool = createReadTool(localCwd, {
134
+ operations: createRemoteReadOps(ssh.remote, ssh.remoteCwd, localCwd),
135
+ });
136
+ return tool.execute(id, params, signal, onUpdate);
137
+ }
138
+ return localRead.execute(id, params, signal, onUpdate);
139
+ },
140
+ });
141
+
142
+ pi.registerTool({
143
+ ...localWrite,
144
+ async execute(id, params, signal, onUpdate, _ctx) {
145
+ const ssh = getSsh();
146
+ if (ssh) {
147
+ const tool = createWriteTool(localCwd, {
148
+ operations: createRemoteWriteOps(ssh.remote, ssh.remoteCwd, localCwd),
149
+ });
150
+ return tool.execute(id, params, signal, onUpdate);
151
+ }
152
+ return localWrite.execute(id, params, signal, onUpdate);
153
+ },
154
+ });
155
+
156
+ pi.registerTool({
157
+ ...localEdit,
158
+ async execute(id, params, signal, onUpdate, _ctx) {
159
+ const ssh = getSsh();
160
+ if (ssh) {
161
+ const tool = createEditTool(localCwd, {
162
+ operations: createRemoteEditOps(ssh.remote, ssh.remoteCwd, localCwd),
163
+ });
164
+ return tool.execute(id, params, signal, onUpdate);
165
+ }
166
+ return localEdit.execute(id, params, signal, onUpdate);
167
+ },
168
+ });
169
+
170
+ pi.registerTool({
171
+ ...localBash,
172
+ async execute(id, params, signal, onUpdate, _ctx) {
173
+ const ssh = getSsh();
174
+ if (ssh) {
175
+ const tool = createBashTool(localCwd, {
176
+ operations: createRemoteBashOps(ssh.remote, ssh.remoteCwd, localCwd),
177
+ });
178
+ return tool.execute(id, params, signal, onUpdate);
179
+ }
180
+ return localBash.execute(id, params, signal, onUpdate);
181
+ },
182
+ });
183
+
184
+ pi.on("session_start", async (_event, ctx) => {
185
+ // Resolve SSH config now that CLI flags are available
186
+ const arg = pi.getFlag("ssh") as string | undefined;
187
+ if (arg) {
188
+ if (arg.includes(":")) {
189
+ const [remote, path] = arg.split(":");
190
+ resolvedSsh = { remote, remoteCwd: path };
191
+ } else {
192
+ // No path given, evaluate pwd on remote
193
+ const remote = arg;
194
+ const pwd = (await sshExec(remote, "pwd")).toString().trim();
195
+ resolvedSsh = { remote, remoteCwd: pwd };
196
+ }
197
+ ctx.ui.setStatus("ssh", ctx.ui.theme.fg("accent", `SSH: ${resolvedSsh.remote}:${resolvedSsh.remoteCwd}`));
198
+ ctx.ui.notify(`SSH mode: ${resolvedSsh.remote}:${resolvedSsh.remoteCwd}`, "info");
199
+ }
200
+ });
201
+
202
+ // Handle user ! commands via SSH
203
+ pi.on("user_bash", (_event) => {
204
+ const ssh = getSsh();
205
+ if (!ssh) return; // No SSH, use local execution
206
+ return { operations: createRemoteBashOps(ssh.remote, ssh.remoteCwd, localCwd) };
207
+ });
208
+
209
+ // Replace local cwd with remote cwd in system prompt
210
+ pi.on("before_agent_start", async (event) => {
211
+ const ssh = getSsh();
212
+ if (ssh) {
213
+ const modified = event.systemPrompt.replace(
214
+ `Current working directory: ${localCwd}`,
215
+ `Current working directory: ${ssh.remoteCwd} (via SSH: ${ssh.remote})`,
216
+ );
217
+ return { systemPrompt: modified };
218
+ }
219
+ });
220
+ }
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Status Line Extension
3
+ *
4
+ * Demonstrates ctx.ui.setStatus() for displaying persistent status text in the footer.
5
+ * Shows turn progress with themed colors.
6
+ */
7
+
8
+ import type { ExtensionAPI } from "@punch-bot/cli";
9
+
10
+ export default function (pi: ExtensionAPI) {
11
+ let turnCount = 0;
12
+
13
+ pi.on("session_start", async (_event, ctx) => {
14
+ const theme = ctx.ui.theme;
15
+ ctx.ui.setStatus("status-demo", theme.fg("dim", "Ready"));
16
+ });
17
+
18
+ pi.on("turn_start", async (_event, ctx) => {
19
+ turnCount++;
20
+ const theme = ctx.ui.theme;
21
+ const spinner = theme.fg("accent", "●");
22
+ const text = theme.fg("dim", ` Turn ${turnCount}...`);
23
+ ctx.ui.setStatus("status-demo", spinner + text);
24
+ });
25
+
26
+ pi.on("turn_end", async (_event, ctx) => {
27
+ const theme = ctx.ui.theme;
28
+ const check = theme.fg("success", "✓");
29
+ const text = theme.fg("dim", ` Turn ${turnCount} complete`);
30
+ ctx.ui.setStatus("status-demo", check + text);
31
+ });
32
+ }
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Structured Output Tool
3
+ *
4
+ * Demonstrates `terminate: true` so the agent can end on a tool call
5
+ * without paying for an extra follow-up LLM turn.
6
+ */
7
+
8
+ import { defineTool, type ExtensionAPI } from "@punch-bot/cli";
9
+ import { Text } from "@punch-bot/tui";
10
+ import { Type } from "typebox";
11
+
12
+ interface StructuredOutputDetails {
13
+ headline: string;
14
+ summary: string;
15
+ actionItems: string[];
16
+ }
17
+
18
+ const structuredOutputTool = defineTool({
19
+ name: "structured_output",
20
+ label: "Structured Output",
21
+ description:
22
+ "Return a final structured answer. Use this as your last action when the user asks for structured output or a machine-readable summary.",
23
+ promptSnippet: "Emit a final structured answer as a terminating tool result",
24
+ promptGuidelines: [
25
+ "Use structured_output as your final action when the user asks for structured output, JSON-like output, or a machine-readable summary.",
26
+ "After calling structured_output, do not emit another assistant response in the same turn.",
27
+ ],
28
+ parameters: Type.Object({
29
+ headline: Type.String({ description: "Short title for the result" }),
30
+ summary: Type.String({ description: "One-paragraph summary" }),
31
+ actionItems: Type.Array(Type.String(), { description: "Concrete next steps or key bullets" }),
32
+ }),
33
+
34
+ async execute(_toolCallId, params) {
35
+ return {
36
+ content: [{ type: "text", text: `Saved structured output: ${params.headline}` }],
37
+ details: {
38
+ headline: params.headline,
39
+ summary: params.summary,
40
+ actionItems: params.actionItems,
41
+ } satisfies StructuredOutputDetails,
42
+ terminate: true,
43
+ };
44
+ },
45
+
46
+ renderResult(result, _options, theme) {
47
+ const details = result.details as StructuredOutputDetails | undefined;
48
+ if (!details) {
49
+ const text = result.content[0];
50
+ return new Text(text?.type === "text" ? text.text : "", 0, 0);
51
+ }
52
+
53
+ const lines = [
54
+ theme.fg("toolTitle", theme.bold(details.headline)),
55
+ theme.fg("text", details.summary),
56
+ "",
57
+ ...details.actionItems.map((item, index) => theme.fg("muted", `${index + 1}. ${item}`)),
58
+ ];
59
+ return new Text(lines.join("\n"), 0, 0);
60
+ },
61
+ });
62
+
63
+ export default function (pi: ExtensionAPI) {
64
+ pi.registerTool(structuredOutputTool);
65
+ }
@@ -0,0 +1,167 @@
1
+ # Subagents
2
+
3
+ Delegate tasks to specialized subagents with isolated context windows.
4
+
5
+ The `subagent` tool is built into Punch. The files in this directory provide the bundled agent definitions and optional workflow prompt templates.
6
+
7
+ ## Features
8
+
9
+ - **Isolated context**: Each subagent runs in a separate `pi` process, or over A2A when `a2aUrl` is configured
10
+ - **Streaming output**: See tool calls and progress as they happen
11
+ - **Parallel streaming**: All parallel tasks stream updates simultaneously
12
+ - **Markdown rendering**: Final output rendered with proper formatting (expanded view)
13
+ - **Usage tracking**: Shows turns, tokens, cost, and context usage per agent
14
+ - **Abort support**: Ctrl+C propagates to kill subagent processes
15
+
16
+ ## Structure
17
+
18
+ ```
19
+ subagent/
20
+ ├── README.md # This file
21
+ ├── agents/ # Sample agent definitions
22
+ │ ├── scout.md # Fast recon, returns compressed context
23
+ │ ├── planner.md # Creates implementation plans
24
+ │ ├── reviewer.md # Code review
25
+ │ └── worker.md # General-purpose (full capabilities)
26
+ └── prompts/ # Workflow presets (prompt templates)
27
+ ├── implement.md # scout -> planner -> worker
28
+ ├── scout-and-plan.md # scout -> planner (no implementation)
29
+ └── implement-and-review.md # worker -> reviewer -> worker
30
+ ```
31
+
32
+ ## Workflow prompt installation
33
+
34
+ The tool and the `scout`, `planner`, `reviewer`, and `worker` agents require no installation. To add the optional workflow prompts to your user configuration, copy them from the installed package:
35
+
36
+ ```bash
37
+ mkdir -p ~/.pi/agent/prompts
38
+ cp node_modules/@punch-bot/cli/examples/extensions/subagent/prompts/*.md ~/.pi/agent/prompts/
39
+ ```
40
+
41
+ ## Security Model
42
+
43
+ This tool executes a separate `pi` subprocess with a delegated system prompt and tool/model configuration.
44
+
45
+ **Project-local agents** (`.pi/agents/*.md`) are repo-controlled prompts that can instruct the model to read files, run bash commands, etc.
46
+
47
+ **Default behavior:** Loads bundled agents and **user-level agents** from `~/.pi/agent/agents`. User definitions override bundled definitions with the same name.
48
+
49
+ To enable project-local agents, pass `agentScope: "both"` (or `"project"`). Only do this for repositories you trust.
50
+
51
+ When running interactively, the tool prompts for confirmation before running project-local agents in untrusted projects. Trusted projects skip the additional prompt. Set `confirmProjectAgents: false` to disable confirmation.
52
+
53
+ ## Usage
54
+
55
+ ### Single agent
56
+ ```
57
+ Use scout to find all authentication code
58
+ ```
59
+
60
+ ### Parallel execution
61
+ ```
62
+ Run 2 scouts in parallel: one to find models, one to find providers
63
+ ```
64
+
65
+ ### Chained workflow
66
+ ```
67
+ Use a chain: first have scout find the read tool, then have planner suggest improvements
68
+ ```
69
+
70
+ ### Workflow prompts
71
+ ```
72
+ /implement add Redis caching to the session store
73
+ /scout-and-plan refactor auth to support OAuth
74
+ /implement-and-review add input validation to API endpoints
75
+ ```
76
+
77
+ ## Tool Modes
78
+
79
+ | Mode | Parameter | Description |
80
+ |------|-----------|-------------|
81
+ | Single | `{ agent, task }` | One agent, one task |
82
+ | Parallel | `{ tasks: [...] }` | Multiple agents run concurrently (max 8, 4 concurrent) |
83
+ | Chain | `{ chain: [...] }` | Sequential with `{previous}` placeholder |
84
+
85
+ ## Output Display
86
+
87
+ **Collapsed view** (default):
88
+ - Status icon (✓/✗/⏳) and agent name
89
+ - Last 5-10 items (tool calls and text)
90
+ - Usage stats: `3 turns ↑input ↓output RcacheRead WcacheWrite $cost ctx:contextTokens model`
91
+
92
+ **Expanded view** (Ctrl+O):
93
+ - Full task text
94
+ - All tool calls with formatted arguments
95
+ - Final output rendered as Markdown
96
+ - Per-task usage (for chain/parallel)
97
+
98
+ **Parallel mode streaming**:
99
+ - Shows all tasks with live status (⏳ running, ✓ done, ✗ failed)
100
+ - Updates as each task makes progress
101
+ - Shows "2/3 done, 1 running" status
102
+ - Returns each completed task's final output to the parent model, capped at 50 KB per task
103
+ - Returns failure diagnostics from stderr/error messages when a child exits before producing output
104
+
105
+ **Tool call formatting** (mimics built-in tools):
106
+ - `$ command` for bash
107
+ - `read ~/path:1-10` for read
108
+ - `grep /pattern/ in ~/path` for grep
109
+ - etc.
110
+
111
+ ## Agent Definitions
112
+
113
+ Agents are markdown files with YAML frontmatter:
114
+
115
+ ```markdown
116
+ ---
117
+ name: my-agent
118
+ description: What this agent does
119
+ tools: read, grep, find, ls
120
+ model: claude-haiku-4-5
121
+ a2aUrl: http://127.0.0.1:41241
122
+ ---
123
+
124
+ System prompt for the agent goes here.
125
+ ```
126
+
127
+ When `a2aUrl` is set, the subagent delegates to an external A2A agent (for example Hermes) instead of spawning a local `pi` subprocess.
128
+
129
+ When `model` is omitted, the subagent inherits the dispatching session's active model and thinking level.
130
+
131
+ **Locations:**
132
+ - Bundled `scout`, `planner`, `reviewer`, and `worker` definitions
133
+ - `~/.pi/agent/agents/*.md` - User-level (always loaded)
134
+ - `.pi/agents/*.md` - Project-level (only with `agentScope: "project"` or `"both"`)
135
+
136
+ User agents override bundled agents. Project agents override both with the same name when their scope is enabled.
137
+
138
+ ## Sample Agents
139
+
140
+ | Agent | Purpose | Model | Tools |
141
+ |-------|---------|-------|-------|
142
+ | `scout` | Fast codebase recon | Haiku | read, grep, find, ls, bash |
143
+ | `planner` | Implementation plans | Sonnet | read, grep, find, ls |
144
+ | `reviewer` | Code review | Sonnet | read, grep, find, ls, bash |
145
+ | `worker` | General-purpose | Sonnet | (all default) |
146
+
147
+ ## Workflow Prompts
148
+
149
+ | Prompt | Flow |
150
+ |--------|------|
151
+ | `/implement <query>` | scout → planner → worker |
152
+ | `/scout-and-plan <query>` | scout → planner |
153
+ | `/implement-and-review <query>` | worker → reviewer → worker |
154
+
155
+ ## Error Handling
156
+
157
+ - **Exit code != 0**: Tool returns error with stderr/output
158
+ - **stopReason "error"**: LLM error propagated with error message
159
+ - **stopReason "aborted"**: User abort (Ctrl+C) kills subprocess, throws error
160
+ - **Chain mode**: Stops at first failing step, reports which step failed
161
+
162
+ ## Limitations
163
+
164
+ - Output truncated to last 10 items in collapsed view (expand to see all)
165
+ - Parallel model-visible output is capped at 50 KB per task; full results remain in tool details
166
+ - Agents discovered fresh on each invocation (allows editing mid-session)
167
+ - Parallel mode limited to 8 tasks, 4 concurrent
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: planner
3
+ description: Creates implementation plans from context and requirements
4
+ tools: read, grep, find, ls
5
+ model: claude-sonnet-4-5
6
+ ---
7
+
8
+ You are a planning specialist. You receive context (from a scout) and requirements, then produce a clear implementation plan.
9
+
10
+ You must NOT make any changes. Only read, analyze, and plan.
11
+
12
+ Input format you'll receive:
13
+ - Context/findings from a scout agent
14
+ - Original query or requirements
15
+
16
+ Output format:
17
+
18
+ ## Goal
19
+ One sentence summary of what needs to be done.
20
+
21
+ ## Plan
22
+ Numbered steps, each small and actionable:
23
+ 1. Step one - specific file/function to modify
24
+ 2. Step two - what to add/change
25
+ 3. ...
26
+
27
+ ## Files to Modify
28
+ - `path/to/file.ts` - what changes
29
+ - `path/to/other.ts` - what changes
30
+
31
+ ## New Files (if any)
32
+ - `path/to/new.ts` - purpose
33
+
34
+ ## Risks
35
+ Anything to watch out for.
36
+
37
+ Keep the plan concrete. The worker agent will execute it verbatim.
@@ -0,0 +1,35 @@
1
+ ---
2
+ name: reviewer
3
+ description: Code review specialist for quality and security analysis
4
+ tools: read, grep, find, ls, bash
5
+ model: claude-sonnet-4-5
6
+ ---
7
+
8
+ You are a senior code reviewer. Analyze code for quality, security, and maintainability.
9
+
10
+ Bash is for read-only commands only: `git diff`, `git log`, `git show`. Do NOT modify files or run builds.
11
+ Assume tool permissions are not perfectly enforceable; keep all bash usage strictly read-only.
12
+
13
+ Strategy:
14
+ 1. Run `git diff` to see recent changes (if applicable)
15
+ 2. Read the modified files
16
+ 3. Check for bugs, security issues, code smells
17
+
18
+ Output format:
19
+
20
+ ## Files Reviewed
21
+ - `path/to/file.ts` (lines X-Y)
22
+
23
+ ## Critical (must fix)
24
+ - `file.ts:42` - Issue description
25
+
26
+ ## Warnings (should fix)
27
+ - `file.ts:100` - Issue description
28
+
29
+ ## Suggestions (consider)
30
+ - `file.ts:150` - Improvement idea
31
+
32
+ ## Summary
33
+ Overall assessment in 2-3 sentences.
34
+
35
+ Be specific with file paths and line numbers.
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: scout
3
+ description: Fast codebase recon that returns compressed context for handoff to other agents
4
+ tools: read, grep, find, ls, bash
5
+ model: claude-haiku-4-5
6
+ ---
7
+
8
+ You are a scout. Quickly investigate a codebase and return structured findings that another agent can use without re-reading everything.
9
+
10
+ Your output will be passed to an agent who has NOT seen the files you explored.
11
+
12
+ Thoroughness (infer from task, default medium):
13
+ - Quick: Targeted lookups, key files only
14
+ - Medium: Follow imports, read critical sections
15
+ - Thorough: Trace all dependencies, check tests/types
16
+
17
+ Strategy:
18
+ 1. grep/find to locate relevant code
19
+ 2. Read key sections (not entire files)
20
+ 3. Identify types, interfaces, key functions
21
+ 4. Note dependencies between files
22
+
23
+ Output format:
24
+
25
+ ## Files Retrieved
26
+ List with exact line ranges:
27
+ 1. `path/to/file.ts` (lines 10-50) - Description of what's here
28
+ 2. `path/to/other.ts` (lines 100-150) - Description
29
+ 3. ...
30
+
31
+ ## Key Code
32
+ Critical types, interfaces, or functions:
33
+
34
+ ```typescript
35
+ interface Example {
36
+ // actual code from the files
37
+ }
38
+ ```
39
+
40
+ ```typescript
41
+ function keyFunction() {
42
+ // actual implementation
43
+ }
44
+ ```
45
+
46
+ ## Architecture
47
+ Brief explanation of how the pieces connect.
48
+
49
+ ## Start Here
50
+ Which file to look at first and why.
@@ -0,0 +1,24 @@
1
+ ---
2
+ name: worker
3
+ description: General-purpose subagent with full capabilities, isolated context
4
+ model: claude-sonnet-4-5
5
+ ---
6
+
7
+ You are a worker agent with full capabilities. You operate in an isolated context window to handle delegated tasks without polluting the main conversation.
8
+
9
+ Work autonomously to complete the assigned task. Use all available tools as needed.
10
+
11
+ Output format when finished:
12
+
13
+ ## Completed
14
+ What was done.
15
+
16
+ ## Files Changed
17
+ - `path/to/file.ts` - what changed
18
+
19
+ ## Notes (if any)
20
+ Anything the main agent should know.
21
+
22
+ If handing off to another agent (e.g. reviewer), include:
23
+ - Exact file paths changed
24
+ - Key functions/types touched (short list)
@@ -0,0 +1,10 @@
1
+ ---
2
+ description: Worker implements, reviewer reviews, worker applies feedback
3
+ ---
4
+ Use the subagent tool with the chain parameter to execute this workflow:
5
+
6
+ 1. First, use the "worker" agent to implement: $@
7
+ 2. Then, use the "reviewer" agent to review the implementation from the previous step (use {previous} placeholder)
8
+ 3. Finally, use the "worker" agent to apply the feedback from the review (use {previous} placeholder)
9
+
10
+ Execute this as a chain, passing output between steps via {previous}.
@@ -0,0 +1,10 @@
1
+ ---
2
+ description: Full implementation workflow - scout gathers context, planner creates plan, worker implements
3
+ ---
4
+ Use the subagent tool with the chain parameter to execute this workflow:
5
+
6
+ 1. First, use the "scout" agent to find all code relevant to: $@
7
+ 2. Then, use the "planner" agent to create an implementation plan for "$@" using the context from the previous step (use {previous} placeholder)
8
+ 3. Finally, use the "worker" agent to implement the plan from the previous step (use {previous} placeholder)
9
+
10
+ Execute this as a chain, passing output between steps via {previous}.
@@ -0,0 +1,9 @@
1
+ ---
2
+ description: Scout gathers context, planner creates implementation plan (no implementation)
3
+ ---
4
+ Use the subagent tool with the chain parameter to execute this workflow:
5
+
6
+ 1. First, use the "scout" agent to find all code relevant to: $@
7
+ 2. Then, use the "planner" agent to create an implementation plan for "$@" using the context from the previous step (use {previous} placeholder)
8
+
9
+ Execute this as a chain, passing output between steps via {previous}. Do NOT implement - just return the plan.