@celljs/ta 4.6.0 → 4.7.0

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 (253) hide show
  1. package/README.en.md +108 -0
  2. package/README.md +11 -2
  3. package/dist/cli.mjs +149 -104
  4. package/dist/pi/CHANGELOG.md +18 -0
  5. package/dist/pi/dist/bundle/chunks/chunk-44DLKSKE.js +2 -2
  6. package/dist/pi/package.json +1 -1
  7. package/dist/pi/packages/ta-channels/README.en.md +48 -0
  8. package/dist/pi/packages/ta-channels/README.md +1 -1
  9. package/dist/pi/packages/ta-channels/extension/index.mjs +8 -4
  10. package/dist/pi/packages/ta-channels/host/index.mjs +22 -3
  11. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts +4 -1
  12. package/dist/pi/packages/ta-channels/lib/channels-model.d.ts.map +1 -1
  13. package/dist/pi/packages/ta-channels/lib/channels-model.js.map +1 -1
  14. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts +2 -0
  15. package/dist/pi/packages/ta-channels/lib/channels-util.d.ts.map +1 -1
  16. package/dist/pi/packages/ta-channels/lib/channels-util.js +6 -1
  17. package/dist/pi/packages/ta-channels/lib/channels-util.js.map +1 -1
  18. package/dist/pi/packages/ta-channels/lib/channels.js +1 -1
  19. package/dist/pi/packages/ta-channels/lib/channels.js.map +1 -1
  20. package/dist/pi/packages/ta-channels/lib/extension.d.ts +2 -2
  21. package/dist/pi/packages/ta-channels/lib/extension.d.ts.map +1 -1
  22. package/dist/pi/packages/ta-channels/lib/extension.js +2 -2
  23. package/dist/pi/packages/ta-channels/lib/extension.js.map +1 -1
  24. package/dist/pi/packages/ta-channels/lib/sidebar.d.ts.map +1 -1
  25. package/dist/pi/packages/ta-channels/lib/sidebar.js +4 -2
  26. package/dist/pi/packages/ta-channels/lib/sidebar.js.map +1 -1
  27. package/dist/pi/packages/ta-channels/lib/style.d.ts +1 -1
  28. package/dist/pi/packages/ta-channels/lib/style.d.ts.map +1 -1
  29. package/dist/pi/packages/ta-channels/lib/style.js +1 -0
  30. package/dist/pi/packages/ta-channels/lib/style.js.map +1 -1
  31. package/dist/pi/packages/ta-channels/lib/team-tools.js +1 -1
  32. package/dist/pi/packages/ta-channels/lib/team-tools.js.map +1 -1
  33. package/dist/pi/packages/ta-channels/lib/team.d.ts +7 -1
  34. package/dist/pi/packages/ta-channels/lib/team.d.ts.map +1 -1
  35. package/dist/pi/packages/ta-channels/lib/team.js +25 -2
  36. package/dist/pi/packages/ta-channels/lib/team.js.map +1 -1
  37. package/dist/pi/packages/ta-channels/lib/views.d.ts +3 -1
  38. package/dist/pi/packages/ta-channels/lib/views.d.ts.map +1 -1
  39. package/dist/pi/packages/ta-channels/lib/views.js +6 -0
  40. package/dist/pi/packages/ta-channels/lib/views.js.map +1 -1
  41. package/dist/pi/packages/ta-channels/package.json +1 -1
  42. package/dist/pi/packages/ta-channels/web/index.js +18 -4
  43. package/dist/pi/packages/ta-computer-use/README.en.md +37 -0
  44. package/dist/pi/packages/ta-computer-use/README.md +37 -0
  45. package/dist/pi/packages/ta-computer-use/extension/index.mjs +549 -0
  46. package/dist/pi/packages/ta-computer-use/lib/cua-driver-access.d.ts +71 -0
  47. package/dist/pi/packages/ta-computer-use/lib/cua-driver-access.d.ts.map +1 -0
  48. package/dist/pi/packages/ta-computer-use/lib/cua-driver-access.js +143 -0
  49. package/dist/pi/packages/ta-computer-use/lib/cua-driver-access.js.map +1 -0
  50. package/dist/pi/packages/ta-computer-use/lib/cua-driver-daemon.d.ts +78 -0
  51. package/dist/pi/packages/ta-computer-use/lib/cua-driver-daemon.d.ts.map +1 -0
  52. package/dist/pi/packages/ta-computer-use/lib/cua-driver-daemon.js +250 -0
  53. package/dist/pi/packages/ta-computer-use/lib/cua-driver-daemon.js.map +1 -0
  54. package/dist/pi/packages/ta-computer-use/lib/cua-driver.d.ts +56 -0
  55. package/dist/pi/packages/ta-computer-use/lib/cua-driver.d.ts.map +1 -0
  56. package/dist/pi/packages/ta-computer-use/lib/cua-driver.js +112 -0
  57. package/dist/pi/packages/ta-computer-use/lib/cua-driver.js.map +1 -0
  58. package/dist/pi/packages/ta-computer-use/lib/extension.d.ts +39 -0
  59. package/dist/pi/packages/ta-computer-use/lib/extension.d.ts.map +1 -0
  60. package/dist/pi/packages/ta-computer-use/lib/extension.js +174 -0
  61. package/dist/pi/packages/ta-computer-use/lib/extension.js.map +1 -0
  62. package/dist/pi/packages/ta-computer-use/lib/pi-types.d.ts +3 -0
  63. package/dist/pi/packages/ta-computer-use/lib/pi-types.d.ts.map +1 -0
  64. package/dist/pi/packages/ta-computer-use/lib/pi-types.js +3 -0
  65. package/dist/pi/packages/ta-computer-use/lib/pi-types.js.map +1 -0
  66. package/dist/pi/packages/ta-computer-use/package.json +51 -0
  67. package/dist/pi/packages/ta-extensions/README.en.md +27 -0
  68. package/dist/pi/packages/ta-extensions/README.md +10 -3
  69. package/dist/pi/packages/ta-extensions/host/index.mjs +331 -1
  70. package/dist/pi/packages/ta-extensions/lib/actions.d.ts +5 -1
  71. package/dist/pi/packages/ta-extensions/lib/actions.d.ts.map +1 -1
  72. package/dist/pi/packages/ta-extensions/lib/actions.js +20 -1
  73. package/dist/pi/packages/ta-extensions/lib/actions.js.map +1 -1
  74. package/dist/pi/packages/ta-extensions/lib/context.d.ts +20 -0
  75. package/dist/pi/packages/ta-extensions/lib/context.d.ts.map +1 -0
  76. package/dist/pi/packages/ta-extensions/lib/context.js +8 -0
  77. package/dist/pi/packages/ta-extensions/lib/context.js.map +1 -0
  78. package/dist/pi/packages/ta-extensions/lib/host.d.ts +8 -2
  79. package/dist/pi/packages/ta-extensions/lib/host.d.ts.map +1 -1
  80. package/dist/pi/packages/ta-extensions/lib/host.js +11 -2
  81. package/dist/pi/packages/ta-extensions/lib/host.js.map +1 -1
  82. package/dist/pi/packages/ta-extensions/lib/i18n.d.ts +32 -0
  83. package/dist/pi/packages/ta-extensions/lib/i18n.d.ts.map +1 -1
  84. package/dist/pi/packages/ta-extensions/lib/i18n.js +78 -2
  85. package/dist/pi/packages/ta-extensions/lib/i18n.js.map +1 -1
  86. package/dist/pi/packages/ta-extensions/lib/index.d.ts +2 -1
  87. package/dist/pi/packages/ta-extensions/lib/index.d.ts.map +1 -1
  88. package/dist/pi/packages/ta-extensions/lib/index.js +25 -21
  89. package/dist/pi/packages/ta-extensions/lib/index.js.map +1 -1
  90. package/dist/pi/packages/ta-extensions/lib/market-detail.d.ts +12 -0
  91. package/dist/pi/packages/ta-extensions/lib/market-detail.d.ts.map +1 -0
  92. package/dist/pi/packages/ta-extensions/lib/market-detail.js +95 -0
  93. package/dist/pi/packages/ta-extensions/lib/market-detail.js.map +1 -0
  94. package/dist/pi/packages/ta-extensions/lib/market-parts.d.ts +33 -0
  95. package/dist/pi/packages/ta-extensions/lib/market-parts.d.ts.map +1 -0
  96. package/dist/pi/packages/ta-extensions/lib/market-parts.js +56 -0
  97. package/dist/pi/packages/ta-extensions/lib/market-parts.js.map +1 -0
  98. package/dist/pi/packages/ta-extensions/lib/market-store.d.ts +41 -0
  99. package/dist/pi/packages/ta-extensions/lib/market-store.d.ts.map +1 -0
  100. package/dist/pi/packages/ta-extensions/lib/market-store.js +99 -0
  101. package/dist/pi/packages/ta-extensions/lib/market-store.js.map +1 -0
  102. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts +3 -0
  103. package/dist/pi/packages/ta-extensions/lib/market-style.d.ts.map +1 -0
  104. package/dist/pi/packages/ta-extensions/lib/market-style.js +98 -0
  105. package/dist/pi/packages/ta-extensions/lib/market-style.js.map +1 -0
  106. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts +74 -0
  107. package/dist/pi/packages/ta-extensions/lib/market-util.d.ts.map +1 -0
  108. package/dist/pi/packages/ta-extensions/lib/market-util.js +193 -0
  109. package/dist/pi/packages/ta-extensions/lib/market-util.js.map +1 -0
  110. package/dist/pi/packages/ta-extensions/lib/market-view.d.ts +9 -0
  111. package/dist/pi/packages/ta-extensions/lib/market-view.d.ts.map +1 -0
  112. package/dist/pi/packages/ta-extensions/lib/market-view.js +144 -0
  113. package/dist/pi/packages/ta-extensions/lib/market-view.js.map +1 -0
  114. package/dist/pi/packages/ta-extensions/lib/market.d.ts +88 -0
  115. package/dist/pi/packages/ta-extensions/lib/market.d.ts.map +1 -0
  116. package/dist/pi/packages/ta-extensions/lib/market.js +198 -0
  117. package/dist/pi/packages/ta-extensions/lib/market.js.map +1 -0
  118. package/dist/pi/packages/ta-extensions/lib/page.d.ts +3 -16
  119. package/dist/pi/packages/ta-extensions/lib/page.d.ts.map +1 -1
  120. package/dist/pi/packages/ta-extensions/lib/page.js +87 -58
  121. package/dist/pi/packages/ta-extensions/lib/page.js.map +1 -1
  122. package/dist/pi/packages/ta-extensions/lib/signal.d.ts +12 -0
  123. package/dist/pi/packages/ta-extensions/lib/signal.d.ts.map +1 -0
  124. package/dist/pi/packages/ta-extensions/lib/signal.js +32 -0
  125. package/dist/pi/packages/ta-extensions/lib/signal.js.map +1 -0
  126. package/dist/pi/packages/ta-extensions/lib/style.d.ts +1 -1
  127. package/dist/pi/packages/ta-extensions/lib/style.d.ts.map +1 -1
  128. package/dist/pi/packages/ta-extensions/lib/style.js +3 -2
  129. package/dist/pi/packages/ta-extensions/lib/style.js.map +1 -1
  130. package/dist/pi/packages/ta-extensions/package.json +1 -1
  131. package/dist/pi/packages/ta-extensions/skills/ta-package/SKILL.md +1 -1
  132. package/dist/pi/packages/ta-extensions/web/index.js +937 -54
  133. package/dist/pi/packages/ta-workspace/README.md +1 -1
  134. package/dist/pi/packages/ta-workspace/README.zh-cn.md +29 -0
  135. package/dist/pi/packages/ta-workspace/lib/browser.d.ts.map +1 -1
  136. package/dist/pi/packages/ta-workspace/lib/browser.js +26 -2
  137. package/dist/pi/packages/ta-workspace/lib/browser.js.map +1 -1
  138. package/dist/pi/packages/ta-workspace/lib/util/workspace.d.ts +4 -0
  139. package/dist/pi/packages/ta-workspace/lib/util/workspace.d.ts.map +1 -1
  140. package/dist/pi/packages/ta-workspace/lib/util/workspace.js +24 -0
  141. package/dist/pi/packages/ta-workspace/lib/util/workspace.js.map +1 -1
  142. package/dist/pi/packages/ta-workspace/package.json +1 -1
  143. package/dist/pi/packages/ta-workspace/web/index.js +47 -6
  144. package/dist/public/assets/{abnfDiagram-S7VZAUFO-3_0FZVeo.js → abnfDiagram-S7VZAUFO-D1ZeYB9c.js} +1 -1
  145. package/dist/public/assets/{architecture-WOLXFQ4H-BX-N-_gd.js → architecture-WOLXFQ4H-RV_x_iFj.js} +1 -1
  146. package/dist/public/assets/{architectureDiagram-YGSQEFNW-Daeu1xjI.js → architectureDiagram-YGSQEFNW-BGOmzcpZ.js} +1 -1
  147. package/dist/public/assets/{blockDiagram-APKKGZFW-DjJS8902.js → blockDiagram-APKKGZFW-BkoflIym.js} +1 -1
  148. package/dist/public/assets/{browser-DZ1aJcgd.js → browser-Cl9_lr0X.js} +1 -1
  149. package/dist/public/assets/{c4Diagram-KJ2TOQU5-mKfHFqh9.js → c4Diagram-KJ2TOQU5-CfrQTIEs.js} +1 -1
  150. package/dist/public/assets/{chunk-6MUBBAK2-Cnx7dsB1.js → chunk-6MUBBAK2-C-VxnXsG.js} +1 -1
  151. package/dist/public/assets/{chunk-AXFCVDMN-g4Y7Pg2t.js → chunk-AXFCVDMN-aqbxPiaN.js} +1 -1
  152. package/dist/public/assets/{chunk-BG4553SI-QNE6A_Vg.js → chunk-BG4553SI-DDgvFLBP.js} +1 -1
  153. package/dist/public/assets/{chunk-DQASFODM-DPHr08r0.js → chunk-DQASFODM-CItpjfW5.js} +1 -1
  154. package/dist/public/assets/{chunk-HFQBQIA3-CenkxHlV.js → chunk-HFQBQIA3-BATYGV1I.js} +1 -1
  155. package/dist/public/assets/{chunk-KQLB2F66-C3Z8V8R_.js → chunk-KQLB2F66-BVAqVjgq.js} +1 -1
  156. package/dist/public/assets/{chunk-KS47KZWR-BbUyxMWY.js → chunk-KS47KZWR-Bk0_a-eE.js} +1 -1
  157. package/dist/public/assets/{chunk-LEVMRMFU-CKECy4cp.js → chunk-LEVMRMFU-DsFG_U8r.js} +1 -1
  158. package/dist/public/assets/{chunk-M57EVK23-DuZd8RGI.js → chunk-M57EVK23-BgeE81Y7.js} +1 -1
  159. package/dist/public/assets/{chunk-OY52VR5R-DatO2fu-.js → chunk-OY52VR5R-2Rp6C2LJ.js} +1 -1
  160. package/dist/public/assets/{chunk-QB3YPZ4I-11782Ox2.js → chunk-QB3YPZ4I-BhcIp-Bl.js} +1 -1
  161. package/dist/public/assets/{chunk-R3KSYZAL-CCTi2rHV.js → chunk-R3KSYZAL-i9n2AYPG.js} +1 -1
  162. package/dist/public/assets/{chunk-STOXU5M4-DU6EHCIH.js → chunk-STOXU5M4-DOSqSu65.js} +1 -1
  163. package/dist/public/assets/{chunk-TU62E6Q5-BtgGljqq.js → chunk-TU62E6Q5-BDA8bjy3.js} +1 -1
  164. package/dist/public/assets/{chunk-X4PVCEUW-Dd_Qy0Gx.js → chunk-X4PVCEUW-Cs-r9l_d.js} +1 -1
  165. package/dist/public/assets/{chunk-XXDRQBXY-DjOrWHxV.js → chunk-XXDRQBXY-DEcanQFC.js} +1 -1
  166. package/dist/public/assets/{classDiagram-v2-L25IHNXF-KfN1--CA.js → classDiagram-v2-L25IHNXF-BS8XxKRR.js} +1 -1
  167. package/dist/public/assets/{cose-bilkent-JH36ORCC-BuWVQ5UC.js → cose-bilkent-JH36ORCC--RPleOJ8.js} +1 -1
  168. package/dist/public/assets/cynefin-EF2NZ3EQ-CXQC7Jwi.js +1 -0
  169. package/dist/public/assets/{cynefinDiagram-L36ESFBY-BKljxAVP.js → cynefinDiagram-L36ESFBY-DZHM2oEU.js} +1 -1
  170. package/dist/public/assets/{d3-selection-CtCbiJ-r.js → d3-selection-D2iIEb1P.js} +1 -1
  171. package/dist/public/assets/{dagre-SPEB5RXH-nD3f86OL.js → dagre-SPEB5RXH-h_G5ukMB.js} +1 -1
  172. package/dist/public/assets/{diagram-3B7GL73J-wSVpHF4f.js → diagram-3B7GL73J-BnThWj9P.js} +1 -1
  173. package/dist/public/assets/{diagram-DNEMPZML-BOkeaSpr.js → diagram-DNEMPZML-DHCMo8sZ.js} +1 -1
  174. package/dist/public/assets/{diagram-L3MUGCDN-CRCErdiz.js → diagram-L3MUGCDN-DxJZnIKT.js} +1 -1
  175. package/dist/public/assets/{diagram-LA4NIPWU-y5kaOsii.js → diagram-LA4NIPWU-Cn0SGxqL.js} +1 -1
  176. package/dist/public/assets/{diagram-MHCOC4E2-D7l7ybij.js → diagram-MHCOC4E2-BafBOkBk.js} +1 -1
  177. package/dist/public/assets/{diagram-XPFHEONP-kHzV_Ibv.js → diagram-XPFHEONP-D7UnEMcU.js} +1 -1
  178. package/dist/public/assets/{dist-B-aKVhGg.js → dist-CN9JBoER.js} +1 -1
  179. package/dist/public/assets/{ebnfDiagram-UZSYDL2S-BX_-WdHG.js → ebnfDiagram-UZSYDL2S-Us1rkKwp.js} +1 -1
  180. package/dist/public/assets/{editor.api-Dwz0wCaW.js → editor.api-S_CuXudU.js} +1 -1
  181. package/dist/public/assets/{elk-XV6XMXQE-YaOVo5bZ.js → elk-XV6XMXQE-Czvqrn49.js} +1 -1
  182. package/dist/public/assets/{erDiagram-EYBAPDEH-BXQPjKDV.js → erDiagram-EYBAPDEH-C0g3K15f.js} +1 -1
  183. package/dist/public/assets/{eventmodeling-K75KTNOO-SiGVyftr.js → eventmodeling-K75KTNOO-DIcU7mQ5.js} +1 -1
  184. package/dist/public/assets/flowDiagram-MALGAFMO-D5Z_jzJ0.js +1 -0
  185. package/dist/public/assets/{freemarker2-DmbpSxx5.js → freemarker2-CkAEBjHO.js} +1 -1
  186. package/dist/public/assets/{ganttDiagram-23REXITY-B_i7AN7O.js → ganttDiagram-23REXITY-CIkKvihz.js} +1 -1
  187. package/dist/public/assets/gitGraph-VSP46ZUC-CvdLb7m6.js +1 -0
  188. package/dist/public/assets/{gitGraphDiagram-STJD7YCW-BMA1YavS.js → gitGraphDiagram-STJD7YCW-BxM3589j.js} +1 -1
  189. package/dist/public/assets/{handlebars-BVNKBeJT.js → handlebars-CPBNiVZ2.js} +1 -1
  190. package/dist/public/assets/{html-BHaxuuAl.js → html-CJBVALoy.js} +1 -1
  191. package/dist/public/assets/{index-DtU34jhH.js → index-CBMmE3BQ.js} +2 -2
  192. package/dist/public/assets/info-OHQRW6UA-BLs8wjUC.js +1 -0
  193. package/dist/public/assets/{infoDiagram-KBXO4MBG-BkNpfsDm.js → infoDiagram-KBXO4MBG-BIcStK_t.js} +1 -1
  194. package/dist/public/assets/{ishikawaDiagram-M35NCXHK-xTM6C-Kn.js → ishikawaDiagram-M35NCXHK-CpV2hKA6.js} +1 -1
  195. package/dist/public/assets/{javascript-C5dXKvxq.js → javascript-dv6GQsa3.js} +1 -1
  196. package/dist/public/assets/{journeyDiagram-OPLOXDXO-C6iaT7vL.js → journeyDiagram-OPLOXDXO-B_vnmdId.js} +1 -1
  197. package/dist/public/assets/{jsonMode-Ia_aRv-z.js → jsonMode-DG_orhvz.js} +1 -1
  198. package/dist/public/assets/{kanban-definition-BZKZHSQY-MobAdBhz.js → kanban-definition-BZKZHSQY-q5uWw99H.js} +1 -1
  199. package/dist/public/assets/{liquid-CIbIBxiN.js → liquid-CD-LM2Kh.js} +1 -1
  200. package/dist/public/assets/{mdx-BqruHcEe.js → mdx-C9mfI8up.js} +1 -1
  201. package/dist/public/assets/{mermaid-parser.core-kBQmxOUn.js → mermaid-parser.core-DNe1duhT.js} +3 -3
  202. package/dist/public/assets/{mermaid.core-BFkQwIYu.js → mermaid.core-B1AcqJgl.js} +4 -4
  203. package/dist/public/assets/{mindmap-definition-I2QAS2VK-DxpTmvUG.js → mindmap-definition-I2QAS2VK-CwYG3Fl3.js} +1 -1
  204. package/dist/public/assets/module-BLLqRvli.js +1099 -0
  205. package/dist/public/assets/module-BZPCnGxA.js +1 -0
  206. package/dist/public/assets/{monaco-BRwac88s.js → monaco-C0ktZo3r.js} +3 -3
  207. package/dist/public/assets/packet-JDAUHWVQ-jwWITUaQ.js +1 -0
  208. package/dist/public/assets/{pegDiagram-FD4XPPHP-B3bIVo4u.js → pegDiagram-FD4XPPHP-DxtA4QDS.js} +1 -1
  209. package/dist/public/assets/pie-XZMESJXO-CeTVZZgy.js +1 -0
  210. package/dist/public/assets/{pieDiagram-J4AKIIQI-CgnbwU0I.js → pieDiagram-J4AKIIQI-CfcIi0Vn.js} +1 -1
  211. package/dist/public/assets/{python-Cwjb3hEe.js → python-DCA1j2QE.js} +1 -1
  212. package/dist/public/assets/{quadrantDiagram-XTYBLID2-DWx4wRau.js → quadrantDiagram-XTYBLID2-BxkJdurF.js} +1 -1
  213. package/dist/public/assets/radar-ABXABTNO-BGI8J8LU.js +1 -0
  214. package/dist/public/assets/railroad-I3PHUGI6-CFkpx3Pr.js +1 -0
  215. package/dist/public/assets/{railroad-abnf-LNEFI6M7-CyjF4cc_.js → railroad-abnf-LNEFI6M7--H3g5ywg.js} +1 -1
  216. package/dist/public/assets/{railroad-ebnf-DWYD2UWJ-D2ypsr5c.js → railroad-ebnf-DWYD2UWJ-C2LAUFu6.js} +1 -1
  217. package/dist/public/assets/{railroad-peg-JR7BVNR7-Cy6Mde1c.js → railroad-peg-JR7BVNR7-Kq_ZXQMl.js} +1 -1
  218. package/dist/public/assets/{railroadDiagram-MRQ6NCDL-B6ya_k_l.js → railroadDiagram-MRQ6NCDL-i4xIvHJV.js} +1 -1
  219. package/dist/public/assets/{razor-D_ClW9Lh.js → razor-CEeNaFx5.js} +1 -1
  220. package/dist/public/assets/{requirementDiagram-Y7LWUY3S-Brg8B8VS.js → requirementDiagram-Y7LWUY3S-CYNXjuJm.js} +1 -1
  221. package/dist/public/assets/{sankeyDiagram-WGJFYUXA-DbzPDfky.js → sankeyDiagram-WGJFYUXA-CRQiHcW6.js} +1 -1
  222. package/dist/public/assets/{sequenceDiagram-5NDRBG5M-BuN84drT.js → sequenceDiagram-5NDRBG5M-BSDVFsi2.js} +1 -1
  223. package/dist/public/assets/{stateDiagram-v2-FJ4FJNEA-C_CTpHMj.js → stateDiagram-v2-FJ4FJNEA-uyUAaysl.js} +1 -1
  224. package/dist/public/assets/{swimlanes-UMQ2AFYF-BvD4v9jw.js → swimlanes-UMQ2AFYF-DdEjQumY.js} +1 -1
  225. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-BJsun6CT.js +8 -0
  226. package/dist/public/assets/{timeline-definition-SEUHKTQE-VE2xWGk8.js → timeline-definition-SEUHKTQE-DZl-TXXh.js} +1 -1
  227. package/dist/public/assets/treeView-D4JQ5SDB-CL1mG6td.js +1 -0
  228. package/dist/public/assets/treemap-SAJKECNS-Bk3Z1uEC.js +1 -0
  229. package/dist/public/assets/{typescript-upeNz2VW.js → typescript-DrF8YGbQ.js} +1 -1
  230. package/dist/public/assets/{usecaseDiagram-AFA6YXN4-ZtyyvKye.js → usecaseDiagram-AFA6YXN4-DkG3gLrp.js} +1 -1
  231. package/dist/public/assets/{vennDiagram-NNMJR3RB-BTEvzrNd.js → vennDiagram-NNMJR3RB-B_lj8x7-.js} +1 -1
  232. package/dist/public/assets/wardley-7MLQ67FV-1E8i3qpD.js +1 -0
  233. package/dist/public/assets/{wardleyDiagram-S7YFUSEH-CF8wIUhx.js → wardleyDiagram-S7YFUSEH-B1VFrC5a.js} +1 -1
  234. package/dist/public/assets/{xml-Cki0HxGb.js → xml-DfL-Brke.js} +1 -1
  235. package/dist/public/assets/{xychartDiagram-GGNKY7IX-DcDpoJ4n.js → xychartDiagram-GGNKY7IX-CM2CpXu9.js} +1 -1
  236. package/dist/public/assets/{yaml-YIY66l1U.js → yaml-CpmxRjjF.js} +1 -1
  237. package/dist/public/index.html +21 -3
  238. package/dist/serve/index.mjs +2251 -656
  239. package/package.json +18 -17
  240. package/dist/public/assets/cynefin-EF2NZ3EQ-D_GZWaFs.js +0 -1
  241. package/dist/public/assets/flowDiagram-MALGAFMO-BHpEyQnS.js +0 -1
  242. package/dist/public/assets/gitGraph-VSP46ZUC-CSv9x0vY.js +0 -1
  243. package/dist/public/assets/info-OHQRW6UA-Bx2U6fFU.js +0 -1
  244. package/dist/public/assets/module-C1y_4M09.js +0 -1061
  245. package/dist/public/assets/module-DYWqfyIP.js +0 -1
  246. package/dist/public/assets/packet-JDAUHWVQ-Dy7GyfNz.js +0 -1
  247. package/dist/public/assets/pie-XZMESJXO-B4D2CjUH.js +0 -1
  248. package/dist/public/assets/radar-ABXABTNO-Dtf3tObc.js +0 -1
  249. package/dist/public/assets/railroad-I3PHUGI6-DKGa9xBx.js +0 -1
  250. package/dist/public/assets/swimlanesDiagram-OMPLPG4O-CMvLg13v.js +0 -8
  251. package/dist/public/assets/treeView-D4JQ5SDB-ETecwv1j.js +0 -1
  252. package/dist/public/assets/treemap-SAJKECNS-er6ceAYK.js +0 -1
  253. package/dist/public/assets/wardley-7MLQ67FV-CzrxsjBc.js +0 -1
@@ -0,0 +1,112 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CuaDriver = void 0;
4
+ const node_fs_1 = require("node:fs");
5
+ const node_os_1 = require("node:os");
6
+ const node_path_1 = require("node:path");
7
+ /**
8
+ * Cua Driver (https://cua.ai/cua-driver): a program that uses the desktop apps of this computer in the
9
+ * background, through each system's accessibility tree, as an MCP server (`cua-driver mcp`). Ta uses the
10
+ * one that comes with Ta Desktop, a version Ta is tested with, or else the one the user installed.
11
+ */
12
+ var CuaDriver;
13
+ (function (CuaDriver) {
14
+ /** The name of its MCP server, so its tools are `mcp__cua_driver__<tool>`. */
15
+ CuaDriver.SERVER = 'cua-driver';
16
+ /** pi's namespace of the server's tools. */
17
+ CuaDriver.NAMESPACE = 'mcp__cua_driver';
18
+ /** The section of the system prompt that tells the model about it. */
19
+ CuaDriver.SECTION = 'computer_use';
20
+ /** The program that comes with Ta Desktop, which sets it for the `ta serve` it starts. */
21
+ CuaDriver.BUNDLED_ENV = 'TA_CUA_DRIVER';
22
+ /** What the system prompt says, with what only one system needs. */
23
+ function prompt(platform) {
24
+ return [
25
+ "Cua Driver lets you use the desktop apps of this computer in the background, without taking the user's pointer or keyboard: list apps and windows, read a window's accessibility tree, click, type, scroll and take screenshots.",
26
+ `Its tools are \`tools.${CuaDriver.NAMESPACE}__*\` in codemode scripts. It starts the first time a script names \`${CuaDriver.NAMESPACE}\`: begin with \`describeNamespace("${CuaDriver.NAMESPACE}")\` for its tools and how to use them.`,
27
+ 'Use it only when a task needs a desktop app, not for files or commands.',
28
+ ...(PLATFORM_NOTES[platform] ? [PLATFORM_NOTES[platform]] : []),
29
+ ].join('\n');
30
+ }
31
+ CuaDriver.prompt = prompt;
32
+ const PLATFORM_NOTES = {
33
+ darwin: 'If a call waits for the permissions of macOS, Ta has asked the user for them; do not ask again.',
34
+ win32: 'Windows does not let it control the windows of apps run as administrator unless Ta runs as administrator too.',
35
+ linux: 'It needs the desktop session of the user (X11, or Wayland with XWayland) and its accessibility bus (AT-SPI).',
36
+ };
37
+ /**
38
+ * For each run of the one of Ta Desktop: no product telemetry and no update check, which Ta's own
39
+ * updates take care of. The user's own install keeps the user's settings.
40
+ */
41
+ CuaDriver.BUNDLED_ENV_VARS = { CUA_DRIVER_RS_TELEMETRY_ENABLED: '0', CUA_DRIVER_RS_UPDATE_CHECK: '0' };
42
+ /** The description of the MCP server, which pi lists in the system prompt once it is registered. */
43
+ CuaDriver.DESCRIPTION = 'Use the desktop apps of this computer in the background (Cua Driver)';
44
+ CuaDriver.INSTALL = {
45
+ posix: '/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"',
46
+ win32: 'irm https://cua.ai/driver/install.ps1 | iex',
47
+ };
48
+ /**
49
+ * Its program: the one of Ta Desktop, else the user's own, on `PATH` or where its installer or its macOS
50
+ * app puts it. Only looks at files, it runs nothing.
51
+ */
52
+ function locate(host = currentHost()) {
53
+ var _a;
54
+ if (host.bundled && host.isFile(host.bundled)) {
55
+ return { path: host.bundled, bundled: true };
56
+ }
57
+ const windows = host.platform === 'win32';
58
+ const name = windows ? 'cua-driver.exe' : 'cua-driver';
59
+ const dirs = ((_a = host.path) !== null && _a !== void 0 ? _a : '').split(windows ? ';' : ':').filter(Boolean);
60
+ const candidates = [...dirs.map(dir => (0, node_path_1.join)(dir, name)), (0, node_path_1.join)(host.home, '.local', 'bin', name)];
61
+ if (host.platform === 'darwin') {
62
+ const app = 'CuaDriver.app/Contents/MacOS/cua-driver';
63
+ candidates.push((0, node_path_1.join)('/Applications', app), (0, node_path_1.join)(host.home, 'Applications', app));
64
+ }
65
+ const own = candidates.find(candidate => host.isFile(candidate));
66
+ return own ? { path: own, bundled: false } : undefined;
67
+ }
68
+ CuaDriver.locate = locate;
69
+ /** The CuaDriver.app of a program inside one. */
70
+ function appOf(program) {
71
+ const inside = '/Contents/MacOS/cua-driver';
72
+ const app = program.slice(0, -inside.length);
73
+ return program.endsWith(inside) && app.endsWith('.app') ? app : undefined;
74
+ }
75
+ CuaDriver.appOf = appOf;
76
+ /**
77
+ * Whether a call may use its tools, given what the called tool says it reaches (pi's `reachesTools`):
78
+ * the words of a codemode script, or `all` for one that searches tools, which then has to name it.
79
+ */
80
+ function reaches(reach, input) {
81
+ if (reach === undefined) {
82
+ return false;
83
+ }
84
+ if (reach === 'all') {
85
+ return JSON.stringify(input !== null && input !== void 0 ? input : null).includes(CuaDriver.NAMESPACE);
86
+ }
87
+ return reach.some(word => word.includes(CuaDriver.NAMESPACE));
88
+ }
89
+ CuaDriver.reaches = reaches;
90
+ /** What `/computer-use` says. */
91
+ function status(program, platform) {
92
+ if (program) {
93
+ const which = program.bundled ? `the one that comes with Ta Desktop (${program.path})` : program.path;
94
+ return `Cua Driver: ${which}. Ta starts it the first time it uses a desktop app, and checks what the system needs then.`;
95
+ }
96
+ const install = platform === 'win32' ? CuaDriver.INSTALL.win32 : CuaDriver.INSTALL.posix;
97
+ return `Ta uses desktop apps through Cua Driver, which is not installed. Install it with \`${install}\`, or use Ta Desktop, which comes with it; Ta finds it on the next message, with no restart.`;
98
+ }
99
+ CuaDriver.status = status;
100
+ function currentHost() {
101
+ return { platform: process.platform, path: process.env.PATH, home: (0, node_os_1.homedir)(), bundled: process.env[CuaDriver.BUNDLED_ENV], isFile };
102
+ }
103
+ function isFile(path) {
104
+ try {
105
+ return (0, node_fs_1.statSync)(path).isFile();
106
+ }
107
+ catch (_a) {
108
+ return false;
109
+ }
110
+ }
111
+ })(CuaDriver || (exports.CuaDriver = CuaDriver = {}));
112
+ //# sourceMappingURL=cua-driver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cua-driver.js","sourceRoot":"","sources":["../src/cua-driver.ts"],"names":[],"mappings":";;;AAAA,qCAAmC;AACnC,qCAAkC;AAClC,yCAAiC;AAoBjC;;;;GAIG;AACH,IAAiB,SAAS,CAsGzB;AAtGD,WAAiB,SAAS;IACtB,8EAA8E;IACjE,gBAAM,GAAG,YAAY,CAAC;IACnC,4CAA4C;IAC/B,mBAAS,GAAG,iBAAiB,CAAC;IAC3C,sEAAsE;IACzD,iBAAO,GAAG,cAAc,CAAC;IACtC,0FAA0F;IAC7E,qBAAW,GAAG,eAAe,CAAC;IAE3C,oEAAoE;IACpE,SAAgB,MAAM,CAAC,QAAyB;QAC5C,OAAO;YACH,kOAAkO;YAClO,yBAAyB,mBAAS,wEAAwE,mBAAS,uCAAuC,mBAAS,yCAAyC;YAC5M,yEAAyE;YACzE,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAPe,UAAA,MAAM,SAOrB,CAAA;IAED,MAAM,cAAc,GAA6C;QAC7D,MAAM,EAAE,iGAAiG;QACzG,KAAK,EAAE,+GAA+G;QACtH,KAAK,EAAE,8GAA8G;KACxH,CAAC;IAEF;;;OAGG;IACU,0BAAgB,GAAqC,EAAE,+BAA+B,EAAE,GAAG,EAAE,0BAA0B,EAAE,GAAG,EAAE,CAAC;IAE5I,oGAAoG;IACvF,qBAAW,GAAG,sEAAsE,CAAC;IAErF,iBAAO,GAAgD;QAChE,KAAK,EAAE,+DAA+D;QACtE,KAAK,EAAE,6CAA6C;KACvD,CAAC;IAEF;;;OAGG;IACH,SAAgB,MAAM,CAAC,IAAI,GAAkB,WAAW,EAAE;;QACtD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC;QACvD,MAAM,IAAI,GAAG,OAAC,IAAI,CAAC,IAAI,mCAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,IAAA,gBAAI,EAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACjG,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,yCAAyC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,IAAA,gBAAI,EAAC,eAAe,EAAE,GAAG,CAAC,EAAE,IAAA,gBAAI,EAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACjE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAde,UAAA,MAAM,SAcrB,CAAA;IAED,iDAAiD;IACjD,SAAgB,KAAK,CAAC,OAAe;QACjC,MAAM,MAAM,GAAG,4BAA4B,CAAC;QAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,CAAC;IAJe,UAAA,KAAK,QAIpB,CAAA;IAED;;;OAGG;IACH,SAAgB,OAAO,CAAC,KAA4C,EAAE,KAAc;QAChF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAS,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAS,CAAC,CAAC,CAAC;IACxD,CAAC;IARe,UAAA,OAAO,UAQtB,CAAA;IAED,iCAAiC;IACjC,SAAgB,MAAM,CAAC,OAAqC,EAAE,QAAyB;QACnF,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACtG,OAAO,eAAe,KAAK,6FAA6F,CAAC;QAC7H,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAO,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAO,CAAC,KAAK,CAAC;QACrE,OAAO,sFAAsF,OAAO,+FAA+F,CAAC;IACxM,CAAC;IAPe,UAAA,MAAM,SAOrB,CAAA;IAED,SAAS,WAAW;QAChB,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAA,iBAAO,GAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9H,CAAC;IAED,SAAS,MAAM,CAAC,IAAY;QACxB,IAAI,CAAC;YACD,OAAO,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,CAAC;mBAAO,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;AACL,CAAC,EAtGgB,SAAS,aAAT,SAAS,GAAT,SAAS,QAsGzB"}
@@ -0,0 +1,39 @@
1
+ import { type CuaDriverProgram } from './cua-driver';
2
+ import { CuaDriverAccess } from './cua-driver-access';
3
+ import { CuaDriverDaemon } from './cua-driver-daemon';
4
+ import type { ExtensionAPI } from './pi-types';
5
+ /** A program of Cua Driver and what goes with it, shared by the sessions of a process. */
6
+ export interface CuaDriverSetup {
7
+ program: CuaDriverProgram;
8
+ /** The daemon Ta runs, for the driver of Ta Desktop on macOS. */
9
+ daemon?: CuaDriverDaemon;
10
+ access: CuaDriverAccess;
11
+ /** The arguments and environment of its MCP server. */
12
+ args: string[];
13
+ env?: Record<string, string>;
14
+ /** Checked, once for the process. */
15
+ ready: boolean;
16
+ checking?: Promise<Awaited<ReturnType<CuaDriverAccess['check']>>>;
17
+ }
18
+ /** What the extension depends on, so that tests can give their own. */
19
+ export interface ComputerUseOptions {
20
+ locate(): CuaDriverProgram | undefined;
21
+ platform: NodeJS.Platform;
22
+ setup(program: CuaDriverProgram, platform: NodeJS.Platform): CuaDriverSetup;
23
+ }
24
+ /** One per program and process: the sessions of `ta serve` share its daemon and its check. */
25
+ export declare function setupOf(found: CuaDriverProgram, platform: NodeJS.Platform): CuaDriverSetup;
26
+ /**
27
+ * Lets the agent use the desktop apps of this computer through Cua Driver, at no cost until it does.
28
+ * Registered up front, an MCP server starts in every session: its process (about 10 MB) and pi's MCP
29
+ * client. So the system prompt only names it, and the server is registered when a call first names its
30
+ * tools; pi connects it before the call runs. Each prompt looks for the program (a few `stat`s, nothing
31
+ * is run) until it is found, so a driver installed meanwhile is used without a restart.
32
+ *
33
+ * The first call also checks what the system needs (CuaDriverAccess): on macOS it waits while the user
34
+ * gives the permissions it asked for, elsewhere it says what is missing, so that the agent's call goes on
35
+ * or fails with what to do, not with an error of the driver.
36
+ */
37
+ export declare function activate(pi: ExtensionAPI, options?: ComputerUseOptions): void;
38
+ export default function computerUse(pi: ExtensionAPI): void;
39
+ //# sourceMappingURL=extension.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iEAAiE;IACjE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,uDAAuD;IACvD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACrE;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IAC/B,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,cAAc,CAAC;CAC/E;AAID,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,cAAc,CAoB1F;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,kBAA6B,GAAG,IAAI,CA+GvF;AAED,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE1D"}
@@ -0,0 +1,174 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.setupOf = setupOf;
4
+ exports.activate = activate;
5
+ exports.default = computerUse;
6
+ const node_child_process_1 = require("node:child_process");
7
+ const node_fs_1 = require("node:fs");
8
+ const node_path_1 = require("node:path");
9
+ const cua_driver_1 = require("./cua-driver");
10
+ const cua_driver_access_1 = require("./cua-driver-access");
11
+ const cua_driver_daemon_1 = require("./cua-driver-daemon");
12
+ /** How long a call waits the first time for Cua Driver's tools; it connects in tens of milliseconds. */
13
+ const CONNECT_WAIT_MS = 5000;
14
+ const POLL_MS = 15;
15
+ const setups = new Map();
16
+ /** One per program and process: the sessions of `ta serve` share its daemon and its check. */
17
+ function setupOf(found, platform) {
18
+ // LaunchServices finds an app by its exact path: one with `..` or a link in it is another app to it.
19
+ const program = { ...found, path: realPath(found.path) };
20
+ let setup = setups.get(program.path);
21
+ if (!setup) {
22
+ const env = program.bundled ? { ...cua_driver_1.CuaDriver.BUNDLED_ENV_VARS } : undefined;
23
+ const app = program.bundled && platform === 'darwin' ? cua_driver_1.CuaDriver.appOf(program.path) : undefined;
24
+ const daemon = app ? new cua_driver_daemon_1.CuaDriverDaemon(app, { env }) : undefined;
25
+ const access = new cua_driver_access_1.CuaDriverAccess(daemon ? (0, node_path_1.join)(daemon.app, 'Contents', 'MacOS', 'cua-driver') : program.path, {
26
+ platform,
27
+ socket: daemon === null || daemon === void 0 ? void 0 : daemon.socket,
28
+ env,
29
+ beforeLook: daemon ? () => daemon.ensure() : undefined,
30
+ openSettings: pane => (0, node_child_process_1.execFile)('open', [`x-apple.systempreferences:com.apple.preference.security?${pane}`], () => undefined),
31
+ });
32
+ const args = daemon ? ['mcp', '--embedded', '--socket', daemon.socket] : ['mcp'];
33
+ setup = { program, daemon, access, args, env, ready: false };
34
+ setups.set(program.path, setup);
35
+ }
36
+ return setup;
37
+ }
38
+ function realPath(path) {
39
+ try {
40
+ return (0, node_fs_1.realpathSync)(path);
41
+ }
42
+ catch (_a) {
43
+ return path;
44
+ }
45
+ }
46
+ const DEFAULTS = { locate: () => cua_driver_1.CuaDriver.locate(), platform: process.platform, setup: setupOf };
47
+ /**
48
+ * Lets the agent use the desktop apps of this computer through Cua Driver, at no cost until it does.
49
+ * Registered up front, an MCP server starts in every session: its process (about 10 MB) and pi's MCP
50
+ * client. So the system prompt only names it, and the server is registered when a call first names its
51
+ * tools; pi connects it before the call runs. Each prompt looks for the program (a few `stat`s, nothing
52
+ * is run) until it is found, so a driver installed meanwhile is used without a restart.
53
+ *
54
+ * The first call also checks what the system needs (CuaDriverAccess): on macOS it waits while the user
55
+ * gives the permissions it asked for, elsewhere it says what is missing, so that the agent's call goes on
56
+ * or fails with what to do, not with an error of the driver.
57
+ */
58
+ function activate(pi, options = DEFAULTS) {
59
+ let setup;
60
+ /** Registered, and waited for once: later calls are pi's to wait for, as for any server it knows. */
61
+ let connected = false;
62
+ let connecting;
63
+ const prefix = `${cua_driver_1.CuaDriver.NAMESPACE}__`;
64
+ const ready = () => pi.getAllTools().some(tool => tool.name.startsWith(prefix));
65
+ const found = () => {
66
+ if (!setup) {
67
+ const program = options.locate();
68
+ setup = program ? options.setup(program, options.platform) : undefined;
69
+ }
70
+ return setup;
71
+ };
72
+ const connect = async (driver, signal) => {
73
+ if (!pi.getMcpServers().some(server => server.name === cua_driver_1.CuaDriver.SERVER)) {
74
+ pi.registerMcpServer(cua_driver_1.CuaDriver.SERVER, { command: driver.program.path, args: driver.args, env: driver.env, description: cua_driver_1.CuaDriver.DESCRIPTION });
75
+ }
76
+ // pi's MCP extension waits for a server it already knows; this one may come after this handler.
77
+ const deadline = Date.now() + CONNECT_WAIT_MS;
78
+ while (!ready() && Date.now() < deadline && !(signal === null || signal === void 0 ? void 0 : signal.aborted)) {
79
+ await new Promise(resolve => setTimeout(resolve, POLL_MS));
80
+ }
81
+ // A call stopped meanwhile leaves the wait to the next one.
82
+ connected = !(signal === null || signal === void 0 ? void 0 : signal.aborted);
83
+ };
84
+ /** Once for the process; the calls at the same time share it. */
85
+ const check = async (driver, notify, signal) => {
86
+ var _a;
87
+ var _b;
88
+ (_b = driver.checking) !== null && _b !== void 0 ? _b : (driver.checking = driver.access.check(notify, signal).finally(() => {
89
+ driver.checking = undefined;
90
+ }));
91
+ const result = await driver.checking;
92
+ if (!result.ready) {
93
+ return result.reason;
94
+ }
95
+ if (result.known && !driver.ready) {
96
+ driver.ready = true;
97
+ for (const note of result.notes) {
98
+ notify(note);
99
+ }
100
+ void ((_a = driver.daemon) === null || _a === void 0 ? void 0 : _a.reap());
101
+ }
102
+ return undefined;
103
+ };
104
+ pi.on('before_agent_start', event => {
105
+ const { sections } = event.systemPromptOptions;
106
+ if (found()) {
107
+ sections[cua_driver_1.CuaDriver.SECTION] = cua_driver_1.CuaDriver.prompt(options.platform);
108
+ }
109
+ else {
110
+ delete sections[cua_driver_1.CuaDriver.SECTION];
111
+ }
112
+ });
113
+ pi.on('tool_call', async (event, ctx) => {
114
+ var _a, _b;
115
+ const driver = setup;
116
+ if (!driver) {
117
+ return undefined;
118
+ }
119
+ if (driver.ready && connected && !driver.daemon) {
120
+ return undefined;
121
+ }
122
+ const tool = pi.getAllTools().find(candidate => candidate.name === event.toolName);
123
+ if (!cua_driver_1.CuaDriver.reaches((_a = tool === null || tool === void 0 ? void 0 : tool.reachesTools) === null || _a === void 0 ? void 0 : _a.call(tool, event.input), event.input)) {
124
+ return undefined;
125
+ }
126
+ const notify = (message) => ctx.ui.notify(message, 'warning');
127
+ try {
128
+ // Every call that uses it, in case the daemon stopped: a check costs one connection.
129
+ await ((_b = driver.daemon) === null || _b === void 0 ? void 0 : _b.ensure());
130
+ // The daemon of Ta Desktop answers before the server connects: its relay needs the permissions.
131
+ // The user's own install starts its daemon when it connects, so it is asked afterwards.
132
+ const reason = driver.daemon && !driver.ready ? await check(driver, notify, ctx.signal) : undefined;
133
+ if (reason) {
134
+ return { block: true, reason };
135
+ }
136
+ if (!connected) {
137
+ connecting !== null && connecting !== void 0 ? connecting : (connecting = connect(driver, ctx.signal).finally(() => {
138
+ connecting = undefined;
139
+ }));
140
+ await connecting;
141
+ }
142
+ const after = !driver.daemon && !driver.ready ? await check(driver, notify, ctx.signal) : undefined;
143
+ return after ? { block: true, reason: after } : undefined;
144
+ }
145
+ catch (error) {
146
+ return { block: true, reason: error.message };
147
+ }
148
+ });
149
+ pi.registerCommand('computer-use', {
150
+ description: 'Whether Ta can use the desktop apps of this computer (Cua Driver), and what the system still needs',
151
+ handler: async (_args, ctx) => {
152
+ var _a;
153
+ const program = options.locate();
154
+ ctx.ui.notify(cua_driver_1.CuaDriver.status(program, options.platform), program ? 'info' : 'warning');
155
+ if (!program) {
156
+ return;
157
+ }
158
+ const driver = options.setup(program, options.platform);
159
+ await ((_a = driver.daemon) === null || _a === void 0 ? void 0 : _a.ensure());
160
+ const result = await driver.access.check(message => ctx.ui.notify(message, 'warning'), ctx.signal);
161
+ if (!result.ready) {
162
+ ctx.ui.notify(result.reason, 'warning');
163
+ }
164
+ else if (result.known) {
165
+ driver.ready = true;
166
+ ctx.ui.notify(['Cua Driver has what it needs.', ...result.notes].join('\n'), result.notes.length > 0 ? 'warning' : 'info');
167
+ }
168
+ },
169
+ });
170
+ }
171
+ function computerUse(pi) {
172
+ activate(pi);
173
+ }
174
+ //# sourceMappingURL=extension.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ /** pi's types, which are ES modules, for this package's CommonJS build; only types, so the bundle imports nothing of pi. */
2
+ export type ExtensionAPI = import('@earendil-works/pi-coding-agent', { with: { 'resolution-mode': 'import' } }).ExtensionAPI;
3
+ //# sourceMappingURL=pi-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-types.d.ts","sourceRoot":"","sources":["../src/pi-types.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,MAAM,MAAM,YAAY,GAAG,OAAO,iCAAiC,EAAU,UAAE,iBAAiB,EAAE,QAAQ,IAAE,EAAG,YAAY,CAAC"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=pi-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-types.js","sourceRoot":"","sources":["../src/pi-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,51 @@
1
+ {
2
+ "name": "@celljs/ta-computer-use",
3
+ "version": "4.7.0",
4
+ "description": "A pi package for Ta: the desktop apps of this computer, used in the background through Cua Driver, which starts only when the agent first needs it",
5
+ "keywords": [
6
+ "pi-package"
7
+ ],
8
+ "homepage": "https://github.com/cellbang/cell",
9
+ "bugs": {
10
+ "url": "https://github.com/cellbang/cell/issues"
11
+ },
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/cellbang/cell.git"
15
+ },
16
+ "license": "MIT",
17
+ "files": [
18
+ "esm",
19
+ "extension",
20
+ "src"
21
+ ],
22
+ "scripts": {
23
+ "build": "tsc -b && bun build src/extension.ts --format esm --target node --outfile extension/index.mjs",
24
+ "clean": "rm -rf lib extension *.tsbuildinfo",
25
+ "test": "bun test ./lib",
26
+ "watch": "tsc -b -w --preserveWatchOutput"
27
+ },
28
+ "devDependencies": {
29
+ "@earendil-works/pi-coding-agent": "^1.5.0"
30
+ },
31
+ "publishConfig": {
32
+ "access": "public"
33
+ },
34
+ "pi": {
35
+ "extensions": [
36
+ "./extension/index.mjs"
37
+ ]
38
+ },
39
+ "exports": {
40
+ "./package.json": "./package.json",
41
+ "./lib/*.js": {
42
+ "import": "./esm/*.js",
43
+ "default": "./lib/*.js"
44
+ },
45
+ "./lib/*": {
46
+ "import": "./esm/*.js",
47
+ "default": "./lib/*.js"
48
+ },
49
+ "./*": "./*"
50
+ }
51
+ }
@@ -0,0 +1,27 @@
1
+ # Cell - Ta Extensions
2
+
3
+ A built-in pi package for Ta (enabled by default, can be disabled in Settings → Extensions): tells users they can create extensions in natural language, handles sharing them, and provides a marketplace. Does not modify Ta's core—three components:
4
+
5
+ - **Skills** (`pi.skills`, `skills/ta-package`): Ta creates and edits pi packages (pi extensions, web extensions, skills, prompt templates) based on user descriptions, and exports or imports extensions on request. The skills are also available in the terminal Ta; disabling this package removes them as well.
6
+ - **Web Extension** (`pi.web`, `web-src/index.tsx` → `web/index.js`): The "Extensions" page in the navigation bar with two tabs at the top: "Mine" and "Marketplace" (the page's top-right menu also opens the marketplace directly).
7
+ - A header line explains that the effect takes place when the response ends. Below the input are example illustrations for four extension types: cards, pages, commands, and skills (`web-src/pictures.tsx`; uses page CSS variables and follows the theme). Click one to see an example; submitted requests open a new session (`openSession` + `switchSession`) and send "Create an extension: ..." to Ta.
8
+ - "My Extensions": packages in the `extensions/` directory (created by Ta or imported from files), showing name, version, content tags, and description. The right side has a toggle (`setPackageEnabled`; disabled ones fade). Hover to reveal edit, export, and remove actions; editing asks how to change the package, then opens a new session for Ta.
9
+ - "Installed Extensions": packages from the `packages` setting (npm or Git), with toggles. You can copy the source or remove them.
10
+ - Import: use the button, the page's top-right menu, or drag files to the page. In the dialog, select a `.tgz` file or enter an `npm:…` / Git address to install (`installPackage`, equivalent to `ta install`). After import, install, or remove, call `reloadExtensions` so the current session and page get the updates immediately.
11
+ - "Share with Others": export → send .tgz file → they import. A three-step diagram shows this flow, with a note explaining that npm, Git sources, or telling Ta directly also work.
12
+ - "Marketplace" (`market-view.tsx`, `market-detail.tsx`): npm packages with the `pi-package` keyword—the ones listed in pi's official package directory.
13
+ - Search box (searches 300 ms after input stops) and a few popular topics. Without keywords, lists by npm's combined ranking (download volume dominates); scrolling to the bottom auto-loads the next page.
14
+ - Each card shows an avatar from the first letter of the name (same name, same color), name (scope faded), author, monthly downloads, description, category tags, and publish date, with an "Install" button on the right: one-click install as user-level `npm:<name>` (`installPackage`, unpinned version, updatable with `ta update`). A loading spinner appears during install; "Installed" shows when done; built-in extensions show "Built-in". Installation continues if you leave the page.
15
+ - Click a card to see its detail page (`Esc` or "Back" returns to the list, scroll position preserved): avatar, name, description, author/version/downloads/license/date, install or remove, npm/source/homepage links, previews from `pi.video` / `pi.image`, and README.
16
+ - **Server** (`pi.host`, `web-src/host.ts` → `host/index.mjs`): the page calls it via `callHost` (`TaPackageServer.callPackageHost`).
17
+ - `exportPackage(id)`: packs a package directory into a `.tgz` file (gzip tar, top level is the package, skips `node_modules`, `.git`, and symlinks), sends it to the page as base64 for download. The format is the same as `tar -czf <name>.tgz <name>`, so it can be unpacked with `tar` without Ta.
18
+ - `searchMarket(query, from?)`, `marketPackage(name)` (`market.ts`): queries npm on the server (packages are installed there). Results are cached for 5 minutes; identical requests are deduplicated. Search uses `/-/v1/search?text=<term> keywords:pi-package`. Npm still ranks all `pi-package` packages below relevant results, so this filters to keep only packages with the term in their name, description, or keywords, stopping at the first irrelevant result. The detail doesn't fetch npm's entire package doc (frequently-updated packages can be tens of MB)—just the `/<name>/latest` manifest and last month's downloads. The README is first fetched from jsDelivr for the published version; if not found, fetches from GitHub. HTML images, links, and headings in READMEs are converted to Markdown (Ta's Markdown doesn't render HTML), badges removed, relative links point to the GitHub repo.
19
+ - `importPackage(data, overwrite?)`: validates the file (single top-level directory, contains `package.json`, paths don't escape, at most 5000 files and 20 MB; skips symlinks and macOS tar's `._*` files), places it in `extensions/<package-name-without-scope>` in the agent directory, and pi loads it without configuration. Returns `exists` if a directory with the same name already exists; the page asks the user and retries with `overwrite`. Writes to a hidden temporary directory first, then swaps it in, so the session won't load a half-written file. Packages output by `npm pack` (with top-level `package/`) can also be imported.
20
+
21
+ ## Limitations
22
+
23
+ - Export and import require `ta serve` (both page and server run inside `ta serve`). When running `ta` alone, follow the skill's instructions to have Ta use `tar` and `ta install`.
24
+ - Extensions imported from files are placed only in the user's `extensions/`. To use one in a project, place the directory in the project's `.ta/extensions/` and commit it.
25
+ - Extensions run code on this machine. Before importing extensions from others, the page warns to only import from trusted sources, and the skill asks Ta to review it first and explain what it does. Marketplace installs are one-click (no approval prompts, following pi's practice); you can view the intro and source code at the bottom of the list or in the detail page.
26
+ - The marketplace only recognizes the official npm registry (search, manifests, and download counts at registry.npmjs.org). READMEs depend on jsDelivr or GitHub. If either is unreachable, the page shows why and offers "Retry"; this doesn't affect already-installed extensions. Installation still uses pi's npm, respecting your npm config.
27
+ - Most npm data is in English; Chinese searches won't find everything. Topic buttons use English keywords.
@@ -1,20 +1,27 @@
1
1
  # Cell - Ta Extensions
2
2
 
3
- Ta 自带的 pi 包(默认开启,可在 设置 → 扩展 关闭):告诉用户可以用自然语言做扩展,并负责扩展的分享。不改 Ta 的核心,由三部分组成:
3
+ Ta 自带的 pi 包(默认开启,可在 设置 → 扩展 关闭):告诉用户可以用自然语言做扩展,负责扩展的分享,并提供扩展市场。不改 Ta 的核心,由三部分组成:
4
4
 
5
5
  - **技能**(`pi.skills`,`skills/ta-package`):Ta 按用户的描述做、改 pi 包(pi 扩展、Web 扩展、技能、提示模板),以及按用户的话导出、导入扩展。终端里的 Ta 也有;关掉这个包,技能也随之去掉。
6
- - **Web 扩展**(`pi.web`,`web-src/index.tsx` → `web/index.js`):导航栏里的"扩展"页。
6
+ - **Web 扩展**(`pi.web`,`web-src/index.tsx` → `web/index.js`):导航栏里的"扩展"页,顶部两个标签:"我的"和"市场"(页面右上角菜单也能直接打开市场)。
7
7
  - 顶部一句话说明回答结束就生效;输入框下是四种扩展(卡片、页面、命令、技能)的示意图(`web-src/pictures.tsx`,只用页面的 CSS 变量,跟随主题),点一个就做它的示例。发出后开一个新对话(`openSession` + `switchSession`)把"做一个扩展:……"发给 Ta。
8
8
  - "我的扩展":`extensions/` 目录里的包(Ta 做的、从文件导入的),显示名称、版本、内容标签和说明,右侧是开关(`setPackageEnabled`,停用的变淡);悬停出现修改(问一句想怎么改,再开新对话交给 Ta)、导出、移除。
9
9
  - "安装的扩展":`packages` 设置里的包(npm、Git),同样有开关,可复制来源、移除。
10
10
  - 导入:按钮、页面右上角菜单或把文件拖到页面上;弹窗里选 `.tgz` 文件,或填 `npm:…` / Git 地址安装(`installPackage`,即 `ta install`)。导入、安装、移除后调用 `reloadExtensions`,当前对话和页面马上用上。
11
11
  - "分享给别人":导出 → 发送 .tgz 文件 → 对方导入 三步图示,下面一行说明也支持 npm、Git 来源或直接对 Ta 说。
12
+ - "市场"(`market-view.tsx`、`market-detail.tsx`):npm 上带 `pi-package` 关键词的包,也就是 pi 官网包目录收录的那些。
13
+ - 搜索框(输入停 300 ms 后搜索)和几个常用话题;没有关键词时按 npm 的综合排序(下载量占大头)列出,滚动到底自动加载下一页。
14
+ - 每张卡片是名字首字母头像(同名同色)、名称(scope 变淡)、作者、月下载量、说明、类别标签和发布时间,右侧一个"安装"按钮:一键安装为用户级的 `npm:<名字>`(`installPackage`,不锁版本,`ta update` 能更新),安装中转圈,装好后显示"已安装",随 Ta 提供的显示"内置"。安装在离开页面后继续。
15
+ - 点卡片进入详情页(`Esc` 或"返回"回到列表,滚动位置不变):头像、名称、说明、作者/版本/下载量/许可证/时间、安装或移除、npm/源代码/主页链接,`pi.video` / `pi.image` 预览,以及 README。
12
16
  - **服务端**(`pi.host`,`web-src/host.ts` → `host/index.mjs`):页面经 `callHost`(`TaPackageServer.callPackageHost`)调用。
13
17
  - `exportPackage(id)`:把包目录打成一个 `.tgz`(gzip 的 tar,顶层是包目录,去掉 `node_modules`、`.git` 和链接),用 base64 交给页面下载。和 `tar -czf <名字>.tgz <名字>` 的格式相同,没有 Ta 也能用 `tar` 解开。
18
+ - `searchMarket(query, from?)`、`marketPackage(name)`(`market.ts`):在服务端查 npm,因为包也装在服务端;结果缓存 5 分钟,同一请求合并。搜索走 `/-/v1/search?text=<词> keywords:pi-package`;npm 对有关键词的搜索仍会把所有 `pi-package` 排在后面,所以只保留名称、说明或关键词里含有每个词的包,出现第一个不相关的就结束分页。详情不取 npm 的整份包文档(发版频繁的包有几十 MB),只取 `/<名字>/latest` 清单、上月下载量,README 先从 jsDelivr 取发布的那一版,没有再取 GitHub 仓库的;README 里的 HTML 图片、链接、标题转成 Markdown(Ta 的 Markdown 不渲染 HTML),去掉徽章,相对链接指向 GitHub 仓库。
14
19
  - `importPackage(data, overwrite?)`:检查文件(只有一个顶层目录、里面有 `package.json`、路径不出目录、不超过 5000 个文件和 20 MB;跳过链接和 macOS tar 附带的 `._*`),放进 agent 目录的 `extensions/<包名去掉 scope>`,pi 无需设置就会加载。同名目录已存在时返回 `exists`,页面问过用户再带 `overwrite` 重来;先写到隐藏的临时目录再换上,会话不会加载到一半的文件。`npm pack` 打出的包(顶层是 `package/`)也能导入。
15
20
 
16
21
  ## 限制
17
22
 
18
23
  - 导出、导入文件需要 ta serve(页面和服务端都在 ta serve 里);单独运行 `ta` 时,按技能里的说明让 Ta 用 `tar` 和 `ta install` 完成。
19
24
  - 从文件导入的扩展只放进用户的 `extensions/`;要给一个项目用,把目录放进项目的 `.ta/extensions/` 并提交。
20
- - 扩展会在本机运行代码:导入别人给的扩展前,页面提示只导入信任的来源,技能也要求 Ta 先读一遍再说明它做什么。
25
+ - 扩展会在本机运行代码:导入别人给的扩展前,页面提示只导入信任的来源,技能也要求 Ta 先读一遍再说明它做什么。市场的安装是一键的(照 pi 的做法不弹审批),列表底部和详情里都可以先看介绍和源代码。
26
+ - 市场只认 npm 官方源(搜索、清单、下载量都在 registry.npmjs.org),README 依赖 jsDelivr 或 GitHub;连不上时页面显示原因和"重试",不影响已安装的扩展。安装仍走 pi 的 npm 安装,遵循用户自己的 npm 配置。
27
+ - npm 的数据大多是英文,按中文搜不到;话题按钮用英文关键词。