@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,242 @@
1
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import { StringEnum } from "@punch-bot/ai";
4
+ import { Type } from "typebox";
5
+ const MAX_LOG = 10;
6
+ function emptyState() {
7
+ return { todos: [], nextId: 1, log: [] };
8
+ }
9
+ export function todosFile() {
10
+ return join(process.env.PI_DATA_DIR || join(process.cwd(), ".pi"), "todos.json");
11
+ }
12
+ export function loadTodos(file = todosFile()) {
13
+ try {
14
+ const parsed = JSON.parse(readFileSync(file, "utf8"));
15
+ if (!Array.isArray(parsed.todos) || !Array.isArray(parsed.log)) {
16
+ return emptyState();
17
+ }
18
+ const todos = [];
19
+ const seenIds = new Set();
20
+ for (const todo of parsed.todos) {
21
+ if (typeof todo !== "object" ||
22
+ todo === null ||
23
+ typeof todo.id !== "number" ||
24
+ !Number.isSafeInteger(todo.id) ||
25
+ typeof todo.text !== "string" ||
26
+ typeof todo.done !== "boolean" ||
27
+ typeof todo.createdAt !== "number" ||
28
+ !Number.isSafeInteger(todo.createdAt)) {
29
+ continue;
30
+ }
31
+ if (seenIds.has(todo.id))
32
+ continue;
33
+ seenIds.add(todo.id);
34
+ todos.push(todo);
35
+ }
36
+ const log = [];
37
+ for (const entry of parsed.log) {
38
+ if (typeof entry !== "object" ||
39
+ entry === null ||
40
+ typeof entry.at !== "number" ||
41
+ !Number.isSafeInteger(entry.at) ||
42
+ typeof entry.summary !== "string") {
43
+ continue;
44
+ }
45
+ log.push(entry);
46
+ }
47
+ const maxId = todos.reduce((max, todo) => Math.max(max, todo.id), 0);
48
+ const nextId = typeof parsed.nextId === "number" && Number.isSafeInteger(parsed.nextId)
49
+ ? Math.max(parsed.nextId, maxId + 1)
50
+ : maxId + 1;
51
+ return { todos, nextId, log: log.slice(0, MAX_LOG) };
52
+ }
53
+ catch {
54
+ return emptyState();
55
+ }
56
+ }
57
+ export function saveTodos(state, file = todosFile()) {
58
+ mkdirSync(dirname(file), { recursive: true });
59
+ const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
60
+ writeFileSync(tmp, JSON.stringify(state, null, 2), { mode: 0o600 });
61
+ renameSync(tmp, file);
62
+ }
63
+ function appendLog(state, summary) {
64
+ const log = [{ at: Date.now(), summary }, ...state.log].slice(0, MAX_LOG);
65
+ return { ...state, log };
66
+ }
67
+ function formatPlan(state) {
68
+ if (state.todos.length === 0)
69
+ return "Plan is empty.";
70
+ const pending = state.todos.filter((todo) => !todo.done);
71
+ const done = state.todos.filter((todo) => todo.done);
72
+ return [...pending, ...done].map((todo) => `${todo.done ? "[x]" : "[ ]"} #${todo.id} ${todo.text}`).join("\n");
73
+ }
74
+ function formatRecentChanges(state, limit = 3) {
75
+ if (state.log.length === 0)
76
+ return "";
77
+ return `Recent changes:\n${state.log
78
+ .slice(0, limit)
79
+ .map((entry) => `- ${entry.summary}`)
80
+ .join("\n")}`;
81
+ }
82
+ function contextInjection(state) {
83
+ const plan = formatPlan(state);
84
+ const changes = formatRecentChanges(state);
85
+ const directive = "Check this plan before your next action; update it with the todo tool when work is done or scope changes (add, split, or update).";
86
+ return changes ? `[Punch plan]\n${plan}\n\n${changes}\n\n${directive}` : `[Punch plan]\n${plan}\n\n${directive}`;
87
+ }
88
+ export function applyTodoAction(state, action) {
89
+ switch (action.action) {
90
+ case "list": {
91
+ return { state, text: formatPlan(state), changed: false };
92
+ }
93
+ case "add": {
94
+ const text = action.text.trim();
95
+ if (!text)
96
+ throw new Error("text is required for add");
97
+ const item = { id: state.nextId, text, done: false, createdAt: Date.now() };
98
+ const next = appendLog({ ...state, todos: [...state.todos, item], nextId: state.nextId + 1 }, `Added #${item.id}: ${text}`);
99
+ return { state: next, text: formatPlan(next), changed: true };
100
+ }
101
+ case "toggle": {
102
+ const index = state.todos.findIndex((todo) => todo.id === action.id);
103
+ if (index === -1)
104
+ throw new Error(`todo #${action.id} not found`);
105
+ const todos = [...state.todos];
106
+ todos[index] = { ...todos[index], done: !todos[index].done };
107
+ const item = todos[index];
108
+ const summary = item.done ? `Completed #${item.id}: ${item.text}` : `Reopened #${item.id}: ${item.text}`;
109
+ const next = appendLog({ ...state, todos }, summary);
110
+ return { state: next, text: formatPlan(next), changed: true };
111
+ }
112
+ case "update": {
113
+ const index = state.todos.findIndex((todo) => todo.id === action.id);
114
+ if (index === -1)
115
+ throw new Error(`todo #${action.id} not found`);
116
+ const text = action.text.trim();
117
+ if (!text)
118
+ throw new Error("text is required for update");
119
+ if (state.todos[index].text === text)
120
+ return { state, text: formatPlan(state), changed: false };
121
+ const todos = [...state.todos];
122
+ todos[index] = { ...todos[index], text };
123
+ const next = appendLog({ ...state, todos }, `Updated #${action.id}: ${text}`);
124
+ return { state: next, text: formatPlan(next), changed: true };
125
+ }
126
+ case "split": {
127
+ const index = state.todos.findIndex((todo) => todo.id === action.id);
128
+ if (index === -1)
129
+ throw new Error(`todo #${action.id} not found`);
130
+ const parts = action.parts.map((part) => part.trim()).filter(Boolean);
131
+ if (parts.length < 2)
132
+ throw new Error("split requires at least two parts");
133
+ const createdAt = Date.now();
134
+ const created = parts.map((part, offset) => ({
135
+ id: state.nextId + offset,
136
+ text: part,
137
+ done: false,
138
+ createdAt,
139
+ }));
140
+ const todos = [...state.todos.slice(0, index), ...created, ...state.todos.slice(index + 1)];
141
+ const next = appendLog({ ...state, todos, nextId: state.nextId + created.length }, `Split #${action.id} into ${created.length} items`);
142
+ return { state: next, text: formatPlan(next), changed: true };
143
+ }
144
+ case "clear": {
145
+ if (state.todos.length === 0)
146
+ return { state, text: formatPlan(state), changed: false };
147
+ const next = appendLog({ ...state, todos: [] }, "Cleared plan");
148
+ return { state: next, text: formatPlan(next), changed: true };
149
+ }
150
+ }
151
+ }
152
+ export function installTodos(pi) {
153
+ let state = loadTodos();
154
+ const syncWidget = (ctx) => {
155
+ if (!ctx.hasUI)
156
+ return;
157
+ if (state.todos.length === 0) {
158
+ ctx.ui.setWidget("punch-todos", undefined);
159
+ return;
160
+ }
161
+ const pending = state.todos.filter((todo) => !todo.done).map((todo) => `[ ] #${todo.id} ${todo.text}`);
162
+ const done = state.todos.filter((todo) => todo.done).map((todo) => `[x] #${todo.id} ${todo.text}`);
163
+ const lines = [...pending, ...done];
164
+ if (state.log[0])
165
+ lines.push(`last: ${state.log[0].summary}`);
166
+ ctx.ui.setWidget("punch-todos", lines);
167
+ };
168
+ pi.on("session_start", (_event, ctx) => {
169
+ state = loadTodos();
170
+ syncWidget(ctx);
171
+ });
172
+ pi.on("context", (event) => {
173
+ if (state.todos.length === 0)
174
+ return;
175
+ const message = {
176
+ role: "custom",
177
+ customType: "punch-todo-context",
178
+ content: contextInjection(state),
179
+ display: false,
180
+ timestamp: Date.now(),
181
+ };
182
+ return { messages: [...event.messages, message] };
183
+ });
184
+ pi.registerTool({
185
+ name: "todo",
186
+ label: "Punch to-do list",
187
+ description: "Maintain a live to-do plan: list, add, toggle, update, split, or clear items.",
188
+ promptSnippet: "Track your plan with the todo tool",
189
+ promptGuidelines: [
190
+ "Before starting a multi-step task, create a plan with todo (action=add) for each step.",
191
+ "Check the plan before every next action; keep it current.",
192
+ "Mark items done (action=toggle) as soon as they finish.",
193
+ "When scope changes, add, split, or update items.",
194
+ "Do not call todo when nothing changed.",
195
+ ],
196
+ parameters: Type.Object({
197
+ action: StringEnum(["list", "add", "toggle", "update", "split", "clear"]),
198
+ text: Type.Optional(Type.String({ description: "Item text for add or update" })),
199
+ id: Type.Optional(Type.Number({ description: "Item id for toggle, update, or split" })),
200
+ parts: Type.Optional(Type.Array(Type.String({ description: "New items for split" }))),
201
+ }),
202
+ async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
203
+ let action;
204
+ switch (args.action) {
205
+ case "list":
206
+ action = { action: "list" };
207
+ break;
208
+ case "add":
209
+ action = { action: "add", text: args.text ?? "" };
210
+ break;
211
+ case "toggle":
212
+ if (args.id === undefined)
213
+ throw new Error("id is required for toggle");
214
+ action = { action: "toggle", id: args.id };
215
+ break;
216
+ case "update":
217
+ if (args.id === undefined)
218
+ throw new Error("id is required for update");
219
+ action = { action: "update", id: args.id, text: args.text ?? "" };
220
+ break;
221
+ case "split":
222
+ if (args.id === undefined)
223
+ throw new Error("id is required for split");
224
+ action = { action: "split", id: args.id, parts: args.parts ?? [] };
225
+ break;
226
+ case "clear":
227
+ action = { action: "clear" };
228
+ break;
229
+ }
230
+ const result = applyTodoAction(state, action);
231
+ state = result.state;
232
+ if (result.changed) {
233
+ saveTodos(state);
234
+ syncWidget(ctx);
235
+ }
236
+ const changes = formatRecentChanges(result.state);
237
+ const text = changes ? `${result.text}\n\n${changes}` : result.text;
238
+ return { content: [{ type: "text", text }], details: {} };
239
+ },
240
+ });
241
+ }
242
+ //# sourceMappingURL=todos.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"todos.js","sourceRoot":"","sources":["../../../src/extensions/punch/todos.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nimport type { AgentMessage } from \"@punch-bot/agent\";\nimport { StringEnum } from \"@punch-bot/ai\";\nimport { Type } from \"typebox\";\n\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\n\nconst MAX_LOG = 10;\n\nexport interface TodoItem {\n\tid: number;\n\ttext: string;\n\tdone: boolean;\n\tcreatedAt: number;\n}\n\nexport interface TodoLogEntry {\n\tat: number;\n\tsummary: string;\n}\n\nexport interface TodoState {\n\ttodos: TodoItem[];\n\tnextId: number;\n\tlog: TodoLogEntry[];\n}\n\nexport type TodoAction =\n\t| { action: \"list\" }\n\t| { action: \"add\"; text: string }\n\t| { action: \"toggle\"; id: number }\n\t| { action: \"update\"; id: number; text: string }\n\t| { action: \"split\"; id: number; parts: string[] }\n\t| { action: \"clear\" };\n\nexport interface TodoActionResult {\n\tstate: TodoState;\n\ttext: string;\n\tchanged: boolean;\n}\n\nfunction emptyState(): TodoState {\n\treturn { todos: [], nextId: 1, log: [] };\n}\n\nexport function todosFile(): string {\n\treturn join(process.env.PI_DATA_DIR || join(process.cwd(), \".pi\"), \"todos.json\");\n}\n\nexport function loadTodos(file = todosFile()): TodoState {\n\ttry {\n\t\tconst parsed = JSON.parse(readFileSync(file, \"utf8\")) as Partial<TodoState>;\n\t\tif (!Array.isArray(parsed.todos) || !Array.isArray(parsed.log)) {\n\t\t\treturn emptyState();\n\t\t}\n\t\tconst todos: TodoItem[] = [];\n\t\tconst seenIds = new Set<number>();\n\t\tfor (const todo of parsed.todos) {\n\t\t\tif (\n\t\t\t\ttypeof todo !== \"object\" ||\n\t\t\t\ttodo === null ||\n\t\t\t\ttypeof (todo as Partial<TodoItem>).id !== \"number\" ||\n\t\t\t\t!Number.isSafeInteger((todo as Partial<TodoItem>).id) ||\n\t\t\t\ttypeof (todo as Partial<TodoItem>).text !== \"string\" ||\n\t\t\t\ttypeof (todo as Partial<TodoItem>).done !== \"boolean\" ||\n\t\t\t\ttypeof (todo as Partial<TodoItem>).createdAt !== \"number\" ||\n\t\t\t\t!Number.isSafeInteger((todo as Partial<TodoItem>).createdAt)\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (seenIds.has(todo.id)) continue;\n\t\t\tseenIds.add(todo.id);\n\t\t\ttodos.push(todo as TodoItem);\n\t\t}\n\t\tconst log: TodoLogEntry[] = [];\n\t\tfor (const entry of parsed.log) {\n\t\t\tif (\n\t\t\t\ttypeof entry !== \"object\" ||\n\t\t\t\tentry === null ||\n\t\t\t\ttypeof (entry as Partial<TodoLogEntry>).at !== \"number\" ||\n\t\t\t\t!Number.isSafeInteger((entry as Partial<TodoLogEntry>).at) ||\n\t\t\t\ttypeof (entry as Partial<TodoLogEntry>).summary !== \"string\"\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tlog.push(entry as TodoLogEntry);\n\t\t}\n\t\tconst maxId = todos.reduce((max, todo) => Math.max(max, todo.id), 0);\n\t\tconst nextId =\n\t\t\ttypeof parsed.nextId === \"number\" && Number.isSafeInteger(parsed.nextId)\n\t\t\t\t? Math.max(parsed.nextId, maxId + 1)\n\t\t\t\t: maxId + 1;\n\t\treturn { todos, nextId, log: log.slice(0, MAX_LOG) };\n\t} catch {\n\t\treturn emptyState();\n\t}\n}\n\nexport function saveTodos(state: TodoState, file = todosFile()): void {\n\tmkdirSync(dirname(file), { recursive: true });\n\tconst tmp = `${file}.${process.pid}.${Date.now()}.tmp`;\n\twriteFileSync(tmp, JSON.stringify(state, null, 2), { mode: 0o600 });\n\trenameSync(tmp, file);\n}\n\nfunction appendLog(state: TodoState, summary: string): TodoState {\n\tconst log = [{ at: Date.now(), summary }, ...state.log].slice(0, MAX_LOG);\n\treturn { ...state, log };\n}\n\nfunction formatPlan(state: TodoState): string {\n\tif (state.todos.length === 0) return \"Plan is empty.\";\n\tconst pending = state.todos.filter((todo) => !todo.done);\n\tconst done = state.todos.filter((todo) => todo.done);\n\treturn [...pending, ...done].map((todo) => `${todo.done ? \"[x]\" : \"[ ]\"} #${todo.id} ${todo.text}`).join(\"\\n\");\n}\n\nfunction formatRecentChanges(state: TodoState, limit = 3): string {\n\tif (state.log.length === 0) return \"\";\n\treturn `Recent changes:\\n${state.log\n\t\t.slice(0, limit)\n\t\t.map((entry) => `- ${entry.summary}`)\n\t\t.join(\"\\n\")}`;\n}\n\nfunction contextInjection(state: TodoState): string {\n\tconst plan = formatPlan(state);\n\tconst changes = formatRecentChanges(state);\n\tconst directive =\n\t\t\"Check this plan before your next action; update it with the todo tool when work is done or scope changes (add, split, or update).\";\n\treturn changes ? `[Punch plan]\\n${plan}\\n\\n${changes}\\n\\n${directive}` : `[Punch plan]\\n${plan}\\n\\n${directive}`;\n}\n\nexport function applyTodoAction(state: TodoState, action: TodoAction): TodoActionResult {\n\tswitch (action.action) {\n\t\tcase \"list\": {\n\t\t\treturn { state, text: formatPlan(state), changed: false };\n\t\t}\n\t\tcase \"add\": {\n\t\t\tconst text = action.text.trim();\n\t\t\tif (!text) throw new Error(\"text is required for add\");\n\t\t\tconst item: TodoItem = { id: state.nextId, text, done: false, createdAt: Date.now() };\n\t\t\tconst next = appendLog(\n\t\t\t\t{ ...state, todos: [...state.todos, item], nextId: state.nextId + 1 },\n\t\t\t\t`Added #${item.id}: ${text}`,\n\t\t\t);\n\t\t\treturn { state: next, text: formatPlan(next), changed: true };\n\t\t}\n\t\tcase \"toggle\": {\n\t\t\tconst index = state.todos.findIndex((todo) => todo.id === action.id);\n\t\t\tif (index === -1) throw new Error(`todo #${action.id} not found`);\n\t\t\tconst todos = [...state.todos];\n\t\t\ttodos[index] = { ...todos[index]!, done: !todos[index]!.done };\n\t\t\tconst item = todos[index]!;\n\t\t\tconst summary = item.done ? `Completed #${item.id}: ${item.text}` : `Reopened #${item.id}: ${item.text}`;\n\t\t\tconst next = appendLog({ ...state, todos }, summary);\n\t\t\treturn { state: next, text: formatPlan(next), changed: true };\n\t\t}\n\t\tcase \"update\": {\n\t\t\tconst index = state.todos.findIndex((todo) => todo.id === action.id);\n\t\t\tif (index === -1) throw new Error(`todo #${action.id} not found`);\n\t\t\tconst text = action.text.trim();\n\t\t\tif (!text) throw new Error(\"text is required for update\");\n\t\t\tif (state.todos[index]!.text === text) return { state, text: formatPlan(state), changed: false };\n\t\t\tconst todos = [...state.todos];\n\t\t\ttodos[index] = { ...todos[index]!, text };\n\t\t\tconst next = appendLog({ ...state, todos }, `Updated #${action.id}: ${text}`);\n\t\t\treturn { state: next, text: formatPlan(next), changed: true };\n\t\t}\n\t\tcase \"split\": {\n\t\t\tconst index = state.todos.findIndex((todo) => todo.id === action.id);\n\t\t\tif (index === -1) throw new Error(`todo #${action.id} not found`);\n\t\t\tconst parts = action.parts.map((part) => part.trim()).filter(Boolean);\n\t\t\tif (parts.length < 2) throw new Error(\"split requires at least two parts\");\n\t\t\tconst createdAt = Date.now();\n\t\t\tconst created: TodoItem[] = parts.map((part, offset) => ({\n\t\t\t\tid: state.nextId + offset,\n\t\t\t\ttext: part,\n\t\t\t\tdone: false,\n\t\t\t\tcreatedAt,\n\t\t\t}));\n\t\t\tconst todos = [...state.todos.slice(0, index), ...created, ...state.todos.slice(index + 1)];\n\t\t\tconst next = appendLog(\n\t\t\t\t{ ...state, todos, nextId: state.nextId + created.length },\n\t\t\t\t`Split #${action.id} into ${created.length} items`,\n\t\t\t);\n\t\t\treturn { state: next, text: formatPlan(next), changed: true };\n\t\t}\n\t\tcase \"clear\": {\n\t\t\tif (state.todos.length === 0) return { state, text: formatPlan(state), changed: false };\n\t\t\tconst next = appendLog({ ...state, todos: [] }, \"Cleared plan\");\n\t\t\treturn { state: next, text: formatPlan(next), changed: true };\n\t\t}\n\t}\n}\n\nexport function installTodos(pi: ExtensionAPI): void {\n\tlet state = loadTodos();\n\n\tconst syncWidget = (ctx: ExtensionContext): void => {\n\t\tif (!ctx.hasUI) return;\n\t\tif (state.todos.length === 0) {\n\t\t\tctx.ui.setWidget(\"punch-todos\", undefined);\n\t\t\treturn;\n\t\t}\n\t\tconst pending = state.todos.filter((todo) => !todo.done).map((todo) => `[ ] #${todo.id} ${todo.text}`);\n\t\tconst done = state.todos.filter((todo) => todo.done).map((todo) => `[x] #${todo.id} ${todo.text}`);\n\t\tconst lines = [...pending, ...done];\n\t\tif (state.log[0]) lines.push(`last: ${state.log[0].summary}`);\n\t\tctx.ui.setWidget(\"punch-todos\", lines);\n\t};\n\n\tpi.on(\"session_start\", (_event, ctx) => {\n\t\tstate = loadTodos();\n\t\tsyncWidget(ctx);\n\t});\n\n\tpi.on(\"context\", (event) => {\n\t\tif (state.todos.length === 0) return;\n\t\tconst message: AgentMessage = {\n\t\t\trole: \"custom\",\n\t\t\tcustomType: \"punch-todo-context\",\n\t\t\tcontent: contextInjection(state),\n\t\t\tdisplay: false,\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t\treturn { messages: [...event.messages, message] };\n\t});\n\n\tpi.registerTool({\n\t\tname: \"todo\",\n\t\tlabel: \"Punch to-do list\",\n\t\tdescription: \"Maintain a live to-do plan: list, add, toggle, update, split, or clear items.\",\n\t\tpromptSnippet: \"Track your plan with the todo tool\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before starting a multi-step task, create a plan with todo (action=add) for each step.\",\n\t\t\t\"Check the plan before every next action; keep it current.\",\n\t\t\t\"Mark items done (action=toggle) as soon as they finish.\",\n\t\t\t\"When scope changes, add, split, or update items.\",\n\t\t\t\"Do not call todo when nothing changed.\",\n\t\t],\n\t\tparameters: Type.Object({\n\t\t\taction: StringEnum([\"list\", \"add\", \"toggle\", \"update\", \"split\", \"clear\"] as const),\n\t\t\ttext: Type.Optional(Type.String({ description: \"Item text for add or update\" })),\n\t\t\tid: Type.Optional(Type.Number({ description: \"Item id for toggle, update, or split\" })),\n\t\t\tparts: Type.Optional(Type.Array(Type.String({ description: \"New items for split\" }))),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tlet action: TodoAction;\n\t\t\tswitch (args.action) {\n\t\t\t\tcase \"list\":\n\t\t\t\t\taction = { action: \"list\" };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"add\":\n\t\t\t\t\taction = { action: \"add\", text: args.text ?? \"\" };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"toggle\":\n\t\t\t\t\tif (args.id === undefined) throw new Error(\"id is required for toggle\");\n\t\t\t\t\taction = { action: \"toggle\", id: args.id };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"update\":\n\t\t\t\t\tif (args.id === undefined) throw new Error(\"id is required for update\");\n\t\t\t\t\taction = { action: \"update\", id: args.id, text: args.text ?? \"\" };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"split\":\n\t\t\t\t\tif (args.id === undefined) throw new Error(\"id is required for split\");\n\t\t\t\t\taction = { action: \"split\", id: args.id, parts: args.parts ?? [] };\n\t\t\t\t\tbreak;\n\t\t\t\tcase \"clear\":\n\t\t\t\t\taction = { action: \"clear\" };\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t\tconst result = applyTodoAction(state, action);\n\t\t\tstate = result.state;\n\t\t\tif (result.changed) {\n\t\t\t\tsaveTodos(state);\n\t\t\t\tsyncWidget(ctx);\n\t\t\t}\n\t\t\tconst changes = formatRecentChanges(result.state);\n\t\t\tconst text = changes ? `${result.text}\\n\\n${changes}` : result.text;\n\t\t\treturn { content: [{ type: \"text\", text }], details: {} };\n\t\t},\n\t});\n}\n"]}
@@ -0,0 +1,3 @@
1
+ import type { ExtensionAPI } from "../../core/extensions/types.ts";
2
+ export default function reportProgressExtension(pi: ExtensionAPI): void;
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/report-progress/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA+BtE","sourcesContent":["import { Type } from \"typebox\";\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\n\nconst limits = { goal: 200, finding: 300, next: 200 } as const;\n\nexport default function reportProgressExtension(pi: ExtensionAPI): void {\n\tpi.registerTool({\n\t\tname: \"report_progress\",\n\t\tlabel: \"Report progress\",\n\t\tdescription:\n\t\t\t\"Publish a brief, user-visible milestone. This is not a scratchpad: include only conclusions and intended actions safe to show the user.\",\n\t\tpromptSnippet: \"Share a meaningful public progress milestone\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use only for meaningful user-visible milestones, never hidden reasoning, chain-of-thought, credentials, or raw tool data.\",\n\t\t],\n\t\tparameters: Type.Object(\n\t\t\t{\n\t\t\t\tgoal: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.goal, description: \"Public description of the current goal\" }),\n\t\t\t\t),\n\t\t\t\tfinding: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.finding, description: \"Public conclusion or key discovery\" }),\n\t\t\t\t),\n\t\t\t\tnext: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.next, description: \"Public description of the next action\" }),\n\t\t\t\t),\n\t\t\t},\n\t\t\t{ additionalProperties: false },\n\t\t),\n\t\tasync execute(_toolCallId, args) {\n\t\t\tif (!args.goal && !args.finding && !args.next) {\n\t\t\t\tthrow new Error(\"goal, finding, or next is required\");\n\t\t\t}\n\t\t\treturn { content: [{ type: \"text\" as const, text: \"Progress milestone shared.\" }], details: {} };\n\t\t},\n\t});\n}\n"]}
@@ -0,0 +1,25 @@
1
+ import { Type } from "typebox";
2
+ const limits = { goal: 200, finding: 300, next: 200 };
3
+ export default function reportProgressExtension(pi) {
4
+ pi.registerTool({
5
+ name: "report_progress",
6
+ label: "Report progress",
7
+ description: "Publish a brief, user-visible milestone. This is not a scratchpad: include only conclusions and intended actions safe to show the user.",
8
+ promptSnippet: "Share a meaningful public progress milestone",
9
+ promptGuidelines: [
10
+ "Use only for meaningful user-visible milestones, never hidden reasoning, chain-of-thought, credentials, or raw tool data.",
11
+ ],
12
+ parameters: Type.Object({
13
+ goal: Type.Optional(Type.String({ maxLength: limits.goal, description: "Public description of the current goal" })),
14
+ finding: Type.Optional(Type.String({ maxLength: limits.finding, description: "Public conclusion or key discovery" })),
15
+ next: Type.Optional(Type.String({ maxLength: limits.next, description: "Public description of the next action" })),
16
+ }, { additionalProperties: false }),
17
+ async execute(_toolCallId, args) {
18
+ if (!args.goal && !args.finding && !args.next) {
19
+ throw new Error("goal, finding, or next is required");
20
+ }
21
+ return { content: [{ type: "text", text: "Progress milestone shared." }], details: {} };
22
+ },
23
+ });
24
+ }
25
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/report-progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG/B,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAW,CAAC;AAE/D,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAgB,EAAQ;IACvE,EAAE,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACV,yIAAyI;QAC1I,aAAa,EAAE,8CAA8C;QAC7D,gBAAgB,EAAE;YACjB,2HAA2H;SAC3H;QACD,UAAU,EAAE,IAAI,CAAC,MAAM,CACtB;YACC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC,CAC9F;YACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CAC7F;YACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAC7F;SACD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAC/B;QACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE;YAChC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAAA,CACjG;KACD,CAAC,CAAC;AAAA,CACH","sourcesContent":["import { Type } from \"typebox\";\nimport type { ExtensionAPI } from \"../../core/extensions/types.ts\";\n\nconst limits = { goal: 200, finding: 300, next: 200 } as const;\n\nexport default function reportProgressExtension(pi: ExtensionAPI): void {\n\tpi.registerTool({\n\t\tname: \"report_progress\",\n\t\tlabel: \"Report progress\",\n\t\tdescription:\n\t\t\t\"Publish a brief, user-visible milestone. This is not a scratchpad: include only conclusions and intended actions safe to show the user.\",\n\t\tpromptSnippet: \"Share a meaningful public progress milestone\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use only for meaningful user-visible milestones, never hidden reasoning, chain-of-thought, credentials, or raw tool data.\",\n\t\t],\n\t\tparameters: Type.Object(\n\t\t\t{\n\t\t\t\tgoal: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.goal, description: \"Public description of the current goal\" }),\n\t\t\t\t),\n\t\t\t\tfinding: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.finding, description: \"Public conclusion or key discovery\" }),\n\t\t\t\t),\n\t\t\t\tnext: Type.Optional(\n\t\t\t\t\tType.String({ maxLength: limits.next, description: \"Public description of the next action\" }),\n\t\t\t\t),\n\t\t\t},\n\t\t\t{ additionalProperties: false },\n\t\t),\n\t\tasync execute(_toolCallId, args) {\n\t\t\tif (!args.goal && !args.finding && !args.next) {\n\t\t\t\tthrow new Error(\"goal, finding, or next is required\");\n\t\t\t}\n\t\t\treturn { content: [{ type: \"text\" as const, text: \"Progress milestone shared.\" }], details: {} };\n\t\t},\n\t});\n}\n"]}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Agent discovery and configuration
3
+ */
4
+ export type AgentScope = "user" | "project" | "both";
5
+ export interface AgentConfig {
6
+ name: string;
7
+ description: string;
8
+ tools?: string[];
9
+ model?: string;
10
+ a2aUrl?: string;
11
+ systemPrompt: string;
12
+ source: "builtin" | "user" | "project";
13
+ filePath: string;
14
+ }
15
+ export interface AgentDiscoveryResult {
16
+ agents: AgentConfig[];
17
+ projectAgentsDir: string | null;
18
+ }
19
+ export declare function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult;
20
+ export declare function formatAgentList(agents: AgentConfig[], maxItems: number): {
21
+ text: string;
22
+ remaining: number;
23
+ };
24
+ //# sourceMappingURL=agents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/extensions/subagent/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AA0GD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAsBnF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQ5G","sourcesContent":["/**\n * Agent discovery and configuration\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { CONFIG_DIR_NAME, getAgentDir, getExamplesPath } from \"../../config.ts\";\nimport { parseFrontmatter } from \"../../utils/frontmatter.ts\";\n\nexport type AgentScope = \"user\" | \"project\" | \"both\";\n\nexport interface AgentConfig {\n\tname: string;\n\tdescription: string;\n\ttools?: string[];\n\tmodel?: string;\n\ta2aUrl?: string;\n\tsystemPrompt: string;\n\tsource: \"builtin\" | \"user\" | \"project\";\n\tfilePath: string;\n}\n\nexport interface AgentDiscoveryResult {\n\tagents: AgentConfig[];\n\tprojectAgentsDir: string | null;\n}\n\n/**\n * Raw agent frontmatter. Values are `unknown` because `parseFrontmatter` runs a\n * real YAML parser, so any scalar or collection can appear here.\n *\n * A type alias rather than an interface: `parseFrontmatter` constrains its\n * parameter to `Record<string, unknown>`, and only an alias picks up the\n * implicit index signature that satisfies it.\n */\ntype AgentFrontmatter = {\n\tname?: unknown;\n\tdescription?: unknown;\n\ttools?: unknown;\n\tmodel?: unknown;\n\ta2aUrl?: unknown;\n};\n\n/**\n * Normalize a frontmatter `tools` value to a list of tool names.\n *\n * Both spellings are valid YAML and both are in use:\n *\n * tools: read, bash # string\n * tools: [read, bash] # array\n *\n * so accept either. Anything else (a number, a map, a nested list) yields no\n * tools rather than throwing: this runs inside agent discovery, where a single\n * bad file must not take down every other agent in the same directory.\n */\nfunction parseToolList(value: unknown): string[] | undefined {\n\tconst raw = Array.isArray(value) ? value : typeof value === \"string\" ? value.split(\",\") : [];\n\tconst tools = raw\n\t\t.filter((t): t is string => typeof t === \"string\")\n\t\t.map((t) => t.trim())\n\t\t.filter(Boolean);\n\treturn tools.length > 0 ? tools : undefined;\n}\n\nfunction loadAgentsFromDir(dir: string, source: AgentConfig[\"source\"]): AgentConfig[] {\n\tconst agents: AgentConfig[] = [];\n\n\tif (!fs.existsSync(dir)) {\n\t\treturn agents;\n\t}\n\n\tlet entries: fs.Dirent[];\n\ttry {\n\t\tentries = fs.readdirSync(dir, { withFileTypes: true });\n\t} catch {\n\t\treturn agents;\n\t}\n\n\tfor (const entry of entries) {\n\t\tif (!entry.name.endsWith(\".md\")) continue;\n\t\tif (!entry.isFile() && !entry.isSymbolicLink()) continue;\n\n\t\tconst filePath = path.join(dir, entry.name);\n\t\tlet content: string;\n\t\ttry {\n\t\t\tcontent = fs.readFileSync(filePath, \"utf-8\");\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst { frontmatter, body } = parseFrontmatter<AgentFrontmatter>(content);\n\n\t\tif (typeof frontmatter.name !== \"string\" || typeof frontmatter.description !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tagents.push({\n\t\t\tname: frontmatter.name,\n\t\t\tdescription: frontmatter.description,\n\t\t\ttools: parseToolList(frontmatter.tools),\n\t\t\tmodel: typeof frontmatter.model === \"string\" ? frontmatter.model : undefined,\n\t\t\ta2aUrl: typeof frontmatter.a2aUrl === \"string\" ? frontmatter.a2aUrl : undefined,\n\t\t\tsystemPrompt: body,\n\t\t\tsource,\n\t\t\tfilePath,\n\t\t});\n\t}\n\n\treturn agents;\n}\n\nfunction isDirectory(p: string): boolean {\n\ttry {\n\t\treturn fs.statSync(p).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction findNearestProjectAgentsDir(cwd: string): string | null {\n\tlet currentDir = cwd;\n\twhile (true) {\n\t\tconst candidate = path.join(currentDir, CONFIG_DIR_NAME, \"agents\");\n\t\tif (isDirectory(candidate)) return candidate;\n\n\t\tconst parentDir = path.dirname(currentDir);\n\t\tif (parentDir === currentDir) return null;\n\t\tcurrentDir = parentDir;\n\t}\n}\n\nexport function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult {\n\tconst builtinDir = path.join(getExamplesPath(), \"extensions\", \"subagent\", \"agents\");\n\tconst userDir = path.join(getAgentDir(), \"agents\");\n\tconst projectAgentsDir = findNearestProjectAgentsDir(cwd);\n\n\tconst builtinAgents = loadAgentsFromDir(builtinDir, \"builtin\");\n\tconst userAgents = scope === \"project\" ? [] : loadAgentsFromDir(userDir, \"user\");\n\tconst projectAgents = scope === \"user\" || !projectAgentsDir ? [] : loadAgentsFromDir(projectAgentsDir, \"project\");\n\n\tconst agentMap = new Map<string, AgentConfig>();\n\tfor (const agent of builtinAgents) agentMap.set(agent.name, agent);\n\n\tif (scope === \"both\") {\n\t\tfor (const agent of userAgents) agentMap.set(agent.name, agent);\n\t\tfor (const agent of projectAgents) agentMap.set(agent.name, agent);\n\t} else if (scope === \"user\") {\n\t\tfor (const agent of userAgents) agentMap.set(agent.name, agent);\n\t} else {\n\t\tfor (const agent of projectAgents) agentMap.set(agent.name, agent);\n\t}\n\n\treturn { agents: Array.from(agentMap.values()), projectAgentsDir };\n}\n\nexport function formatAgentList(agents: AgentConfig[], maxItems: number): { text: string; remaining: number } {\n\tif (agents.length === 0) return { text: \"none\", remaining: 0 };\n\tconst listed = agents.slice(0, maxItems);\n\tconst remaining = agents.length - listed.length;\n\treturn {\n\t\ttext: listed.map((a) => `${a.name} (${a.source}): ${a.description}`).join(\"; \"),\n\t\tremaining,\n\t};\n}\n"]}
@@ -0,0 +1,126 @@
1
+ /**
2
+ * Agent discovery and configuration
3
+ */
4
+ import * as fs from "node:fs";
5
+ import * as path from "node:path";
6
+ import { CONFIG_DIR_NAME, getAgentDir, getExamplesPath } from "../../config.js";
7
+ import { parseFrontmatter } from "../../utils/frontmatter.js";
8
+ /**
9
+ * Normalize a frontmatter `tools` value to a list of tool names.
10
+ *
11
+ * Both spellings are valid YAML and both are in use:
12
+ *
13
+ * tools: read, bash # string
14
+ * tools: [read, bash] # array
15
+ *
16
+ * so accept either. Anything else (a number, a map, a nested list) yields no
17
+ * tools rather than throwing: this runs inside agent discovery, where a single
18
+ * bad file must not take down every other agent in the same directory.
19
+ */
20
+ function parseToolList(value) {
21
+ const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split(",") : [];
22
+ const tools = raw
23
+ .filter((t) => typeof t === "string")
24
+ .map((t) => t.trim())
25
+ .filter(Boolean);
26
+ return tools.length > 0 ? tools : undefined;
27
+ }
28
+ function loadAgentsFromDir(dir, source) {
29
+ const agents = [];
30
+ if (!fs.existsSync(dir)) {
31
+ return agents;
32
+ }
33
+ let entries;
34
+ try {
35
+ entries = fs.readdirSync(dir, { withFileTypes: true });
36
+ }
37
+ catch {
38
+ return agents;
39
+ }
40
+ for (const entry of entries) {
41
+ if (!entry.name.endsWith(".md"))
42
+ continue;
43
+ if (!entry.isFile() && !entry.isSymbolicLink())
44
+ continue;
45
+ const filePath = path.join(dir, entry.name);
46
+ let content;
47
+ try {
48
+ content = fs.readFileSync(filePath, "utf-8");
49
+ }
50
+ catch {
51
+ continue;
52
+ }
53
+ const { frontmatter, body } = parseFrontmatter(content);
54
+ if (typeof frontmatter.name !== "string" || typeof frontmatter.description !== "string") {
55
+ continue;
56
+ }
57
+ agents.push({
58
+ name: frontmatter.name,
59
+ description: frontmatter.description,
60
+ tools: parseToolList(frontmatter.tools),
61
+ model: typeof frontmatter.model === "string" ? frontmatter.model : undefined,
62
+ a2aUrl: typeof frontmatter.a2aUrl === "string" ? frontmatter.a2aUrl : undefined,
63
+ systemPrompt: body,
64
+ source,
65
+ filePath,
66
+ });
67
+ }
68
+ return agents;
69
+ }
70
+ function isDirectory(p) {
71
+ try {
72
+ return fs.statSync(p).isDirectory();
73
+ }
74
+ catch {
75
+ return false;
76
+ }
77
+ }
78
+ function findNearestProjectAgentsDir(cwd) {
79
+ let currentDir = cwd;
80
+ while (true) {
81
+ const candidate = path.join(currentDir, CONFIG_DIR_NAME, "agents");
82
+ if (isDirectory(candidate))
83
+ return candidate;
84
+ const parentDir = path.dirname(currentDir);
85
+ if (parentDir === currentDir)
86
+ return null;
87
+ currentDir = parentDir;
88
+ }
89
+ }
90
+ export function discoverAgents(cwd, scope) {
91
+ const builtinDir = path.join(getExamplesPath(), "extensions", "subagent", "agents");
92
+ const userDir = path.join(getAgentDir(), "agents");
93
+ const projectAgentsDir = findNearestProjectAgentsDir(cwd);
94
+ const builtinAgents = loadAgentsFromDir(builtinDir, "builtin");
95
+ const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");
96
+ const projectAgents = scope === "user" || !projectAgentsDir ? [] : loadAgentsFromDir(projectAgentsDir, "project");
97
+ const agentMap = new Map();
98
+ for (const agent of builtinAgents)
99
+ agentMap.set(agent.name, agent);
100
+ if (scope === "both") {
101
+ for (const agent of userAgents)
102
+ agentMap.set(agent.name, agent);
103
+ for (const agent of projectAgents)
104
+ agentMap.set(agent.name, agent);
105
+ }
106
+ else if (scope === "user") {
107
+ for (const agent of userAgents)
108
+ agentMap.set(agent.name, agent);
109
+ }
110
+ else {
111
+ for (const agent of projectAgents)
112
+ agentMap.set(agent.name, agent);
113
+ }
114
+ return { agents: Array.from(agentMap.values()), projectAgentsDir };
115
+ }
116
+ export function formatAgentList(agents, maxItems) {
117
+ if (agents.length === 0)
118
+ return { text: "none", remaining: 0 };
119
+ const listed = agents.slice(0, maxItems);
120
+ const remaining = agents.length - listed.length;
121
+ return {
122
+ text: listed.map((a) => `${a.name} (${a.source}): ${a.description}`).join("; "),
123
+ remaining,
124
+ };
125
+ }
126
+ //# sourceMappingURL=agents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/extensions/subagent/agents.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Agent discovery and configuration\n */\n\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { CONFIG_DIR_NAME, getAgentDir, getExamplesPath } from \"../../config.ts\";\nimport { parseFrontmatter } from \"../../utils/frontmatter.ts\";\n\nexport type AgentScope = \"user\" | \"project\" | \"both\";\n\nexport interface AgentConfig {\n\tname: string;\n\tdescription: string;\n\ttools?: string[];\n\tmodel?: string;\n\ta2aUrl?: string;\n\tsystemPrompt: string;\n\tsource: \"builtin\" | \"user\" | \"project\";\n\tfilePath: string;\n}\n\nexport interface AgentDiscoveryResult {\n\tagents: AgentConfig[];\n\tprojectAgentsDir: string | null;\n}\n\n/**\n * Raw agent frontmatter. Values are `unknown` because `parseFrontmatter` runs a\n * real YAML parser, so any scalar or collection can appear here.\n *\n * A type alias rather than an interface: `parseFrontmatter` constrains its\n * parameter to `Record<string, unknown>`, and only an alias picks up the\n * implicit index signature that satisfies it.\n */\ntype AgentFrontmatter = {\n\tname?: unknown;\n\tdescription?: unknown;\n\ttools?: unknown;\n\tmodel?: unknown;\n\ta2aUrl?: unknown;\n};\n\n/**\n * Normalize a frontmatter `tools` value to a list of tool names.\n *\n * Both spellings are valid YAML and both are in use:\n *\n * tools: read, bash # string\n * tools: [read, bash] # array\n *\n * so accept either. Anything else (a number, a map, a nested list) yields no\n * tools rather than throwing: this runs inside agent discovery, where a single\n * bad file must not take down every other agent in the same directory.\n */\nfunction parseToolList(value: unknown): string[] | undefined {\n\tconst raw = Array.isArray(value) ? value : typeof value === \"string\" ? value.split(\",\") : [];\n\tconst tools = raw\n\t\t.filter((t): t is string => typeof t === \"string\")\n\t\t.map((t) => t.trim())\n\t\t.filter(Boolean);\n\treturn tools.length > 0 ? tools : undefined;\n}\n\nfunction loadAgentsFromDir(dir: string, source: AgentConfig[\"source\"]): AgentConfig[] {\n\tconst agents: AgentConfig[] = [];\n\n\tif (!fs.existsSync(dir)) {\n\t\treturn agents;\n\t}\n\n\tlet entries: fs.Dirent[];\n\ttry {\n\t\tentries = fs.readdirSync(dir, { withFileTypes: true });\n\t} catch {\n\t\treturn agents;\n\t}\n\n\tfor (const entry of entries) {\n\t\tif (!entry.name.endsWith(\".md\")) continue;\n\t\tif (!entry.isFile() && !entry.isSymbolicLink()) continue;\n\n\t\tconst filePath = path.join(dir, entry.name);\n\t\tlet content: string;\n\t\ttry {\n\t\t\tcontent = fs.readFileSync(filePath, \"utf-8\");\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst { frontmatter, body } = parseFrontmatter<AgentFrontmatter>(content);\n\n\t\tif (typeof frontmatter.name !== \"string\" || typeof frontmatter.description !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tagents.push({\n\t\t\tname: frontmatter.name,\n\t\t\tdescription: frontmatter.description,\n\t\t\ttools: parseToolList(frontmatter.tools),\n\t\t\tmodel: typeof frontmatter.model === \"string\" ? frontmatter.model : undefined,\n\t\t\ta2aUrl: typeof frontmatter.a2aUrl === \"string\" ? frontmatter.a2aUrl : undefined,\n\t\t\tsystemPrompt: body,\n\t\t\tsource,\n\t\t\tfilePath,\n\t\t});\n\t}\n\n\treturn agents;\n}\n\nfunction isDirectory(p: string): boolean {\n\ttry {\n\t\treturn fs.statSync(p).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction findNearestProjectAgentsDir(cwd: string): string | null {\n\tlet currentDir = cwd;\n\twhile (true) {\n\t\tconst candidate = path.join(currentDir, CONFIG_DIR_NAME, \"agents\");\n\t\tif (isDirectory(candidate)) return candidate;\n\n\t\tconst parentDir = path.dirname(currentDir);\n\t\tif (parentDir === currentDir) return null;\n\t\tcurrentDir = parentDir;\n\t}\n}\n\nexport function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult {\n\tconst builtinDir = path.join(getExamplesPath(), \"extensions\", \"subagent\", \"agents\");\n\tconst userDir = path.join(getAgentDir(), \"agents\");\n\tconst projectAgentsDir = findNearestProjectAgentsDir(cwd);\n\n\tconst builtinAgents = loadAgentsFromDir(builtinDir, \"builtin\");\n\tconst userAgents = scope === \"project\" ? [] : loadAgentsFromDir(userDir, \"user\");\n\tconst projectAgents = scope === \"user\" || !projectAgentsDir ? [] : loadAgentsFromDir(projectAgentsDir, \"project\");\n\n\tconst agentMap = new Map<string, AgentConfig>();\n\tfor (const agent of builtinAgents) agentMap.set(agent.name, agent);\n\n\tif (scope === \"both\") {\n\t\tfor (const agent of userAgents) agentMap.set(agent.name, agent);\n\t\tfor (const agent of projectAgents) agentMap.set(agent.name, agent);\n\t} else if (scope === \"user\") {\n\t\tfor (const agent of userAgents) agentMap.set(agent.name, agent);\n\t} else {\n\t\tfor (const agent of projectAgents) agentMap.set(agent.name, agent);\n\t}\n\n\treturn { agents: Array.from(agentMap.values()), projectAgentsDir };\n}\n\nexport function formatAgentList(agents: AgentConfig[], maxItems: number): { text: string; remaining: number } {\n\tif (agents.length === 0) return { text: \"none\", remaining: 0 };\n\tconst listed = agents.slice(0, maxItems);\n\tconst remaining = agents.length - listed.length;\n\treturn {\n\t\ttext: listed.map((a) => `${a.name} (${a.source}): ${a.description}`).join(\"; \"),\n\t\tremaining,\n\t};\n}\n"]}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Subagent Tool - Delegate tasks to specialized agents
3
+ *
4
+ * Spawns a separate `pi` process for each subagent invocation,
5
+ * giving it an isolated context window.
6
+ *
7
+ * Supports three modes:
8
+ * - Single: { agent: "name", task: "..." }
9
+ * - Parallel: { tasks: [{ agent: "name", task: "..." }, ...] }
10
+ * - Chain: { chain: [{ agent: "name", task: "... {previous} ..." }, ...] }
11
+ *
12
+ * Uses JSON mode to capture structured output from subagents.
13
+ */
14
+ import type { ExtensionAPI } from "../../core/extensions/types.ts";
15
+ export default function (pi: ExtensionAPI): void;
16
+ //# sourceMappingURL=index.d.ts.map