@agentuity/cli 0.0.59 → 0.0.61

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 (625) hide show
  1. package/bin/cli.ts +15 -4
  2. package/dist/banner.d.ts +1 -0
  3. package/dist/banner.d.ts.map +1 -1
  4. package/dist/banner.js +28 -13
  5. package/dist/banner.js.map +1 -1
  6. package/dist/cli.d.ts.map +1 -1
  7. package/dist/cli.js +99 -10
  8. package/dist/cli.js.map +1 -1
  9. package/dist/cmd/ai/capabilities/index.d.ts.map +1 -1
  10. package/dist/cmd/ai/capabilities/index.js +4 -0
  11. package/dist/cmd/ai/capabilities/index.js.map +1 -1
  12. package/dist/cmd/ai/capabilities/show.d.ts.map +1 -1
  13. package/dist/cmd/ai/capabilities/show.js +23 -5
  14. package/dist/cmd/ai/capabilities/show.js.map +1 -1
  15. package/dist/cmd/ai/index.d.ts.map +1 -1
  16. package/dist/cmd/ai/index.js +11 -0
  17. package/dist/cmd/ai/index.js.map +1 -1
  18. package/dist/cmd/ai/prompt/agent.d.ts +3 -0
  19. package/dist/cmd/ai/prompt/agent.d.ts.map +1 -0
  20. package/dist/cmd/ai/prompt/agent.js +340 -0
  21. package/dist/cmd/ai/prompt/agent.js.map +1 -0
  22. package/dist/cmd/ai/prompt/api.d.ts +3 -0
  23. package/dist/cmd/ai/prompt/api.d.ts.map +1 -0
  24. package/dist/cmd/ai/prompt/api.js +272 -0
  25. package/dist/cmd/ai/prompt/api.js.map +1 -0
  26. package/dist/cmd/ai/prompt/index.d.ts +1 -2
  27. package/dist/cmd/ai/prompt/index.d.ts.map +1 -1
  28. package/dist/cmd/ai/prompt/index.js +17 -1
  29. package/dist/cmd/ai/prompt/index.js.map +1 -1
  30. package/dist/cmd/ai/prompt/llm.d.ts +1 -0
  31. package/dist/cmd/ai/prompt/llm.d.ts.map +1 -1
  32. package/dist/cmd/ai/prompt/llm.js +2 -2
  33. package/dist/cmd/ai/prompt/llm.js.map +1 -1
  34. package/dist/cmd/ai/prompt/web.d.ts +3 -0
  35. package/dist/cmd/ai/prompt/web.d.ts.map +1 -0
  36. package/dist/cmd/ai/prompt/web.js +299 -0
  37. package/dist/cmd/ai/prompt/web.js.map +1 -0
  38. package/dist/cmd/ai/schema/generate.js +1 -1
  39. package/dist/cmd/ai/schema/generate.js.map +1 -1
  40. package/dist/cmd/ai/schema/index.d.ts.map +1 -1
  41. package/dist/cmd/ai/schema/index.js +2 -0
  42. package/dist/cmd/ai/schema/index.js.map +1 -1
  43. package/dist/cmd/ai/schema/show.d.ts.map +1 -1
  44. package/dist/cmd/ai/schema/show.js +4 -1
  45. package/dist/cmd/ai/schema/show.js.map +1 -1
  46. package/dist/cmd/auth/api.d.ts.map +1 -1
  47. package/dist/cmd/auth/api.js +12 -6
  48. package/dist/cmd/auth/api.js.map +1 -1
  49. package/dist/cmd/auth/index.d.ts.map +1 -1
  50. package/dist/cmd/auth/index.js +5 -0
  51. package/dist/cmd/auth/index.js.map +1 -1
  52. package/dist/cmd/auth/login.d.ts.map +1 -1
  53. package/dist/cmd/auth/login.js +5 -22
  54. package/dist/cmd/auth/login.js.map +1 -1
  55. package/dist/cmd/auth/logout.d.ts.map +1 -1
  56. package/dist/cmd/auth/logout.js +4 -1
  57. package/dist/cmd/auth/logout.js.map +1 -1
  58. package/dist/cmd/auth/signup.d.ts.map +1 -1
  59. package/dist/cmd/auth/signup.js +4 -1
  60. package/dist/cmd/auth/signup.js.map +1 -1
  61. package/dist/cmd/auth/ssh/add.d.ts.map +1 -1
  62. package/dist/cmd/auth/ssh/add.js +13 -4
  63. package/dist/cmd/auth/ssh/add.js.map +1 -1
  64. package/dist/cmd/auth/ssh/api.d.ts.map +1 -1
  65. package/dist/cmd/auth/ssh/api.js +11 -5
  66. package/dist/cmd/auth/ssh/api.js.map +1 -1
  67. package/dist/cmd/auth/ssh/delete.js +4 -4
  68. package/dist/cmd/auth/ssh/delete.js.map +1 -1
  69. package/dist/cmd/auth/ssh/index.d.ts.map +1 -1
  70. package/dist/cmd/auth/ssh/index.js +5 -0
  71. package/dist/cmd/auth/ssh/index.js.map +1 -1
  72. package/dist/cmd/auth/ssh/list.js +3 -3
  73. package/dist/cmd/auth/ssh/list.js.map +1 -1
  74. package/dist/cmd/auth/whoami.d.ts.map +1 -1
  75. package/dist/cmd/auth/whoami.js +4 -4
  76. package/dist/cmd/auth/whoami.js.map +1 -1
  77. package/dist/cmd/build/ast.d.ts +24 -1
  78. package/dist/cmd/build/ast.d.ts.map +1 -1
  79. package/dist/cmd/build/ast.js +526 -14
  80. package/dist/cmd/build/ast.js.map +1 -1
  81. package/dist/cmd/build/bundler.d.ts +3 -1
  82. package/dist/cmd/build/bundler.d.ts.map +1 -1
  83. package/dist/cmd/build/bundler.js +89 -38
  84. package/dist/cmd/build/bundler.js.map +1 -1
  85. package/dist/cmd/build/file.js +1 -1
  86. package/dist/cmd/build/file.js.map +1 -1
  87. package/dist/cmd/build/fix-duplicate-exports.d.ts.map +1 -1
  88. package/dist/cmd/build/fix-duplicate-exports.js +4 -1
  89. package/dist/cmd/build/fix-duplicate-exports.js.map +1 -1
  90. package/dist/cmd/build/index.d.ts.map +1 -1
  91. package/dist/cmd/build/index.js +55 -13
  92. package/dist/cmd/build/index.js.map +1 -1
  93. package/dist/cmd/build/plugin.d.ts.map +1 -1
  94. package/dist/cmd/build/plugin.js +183 -38
  95. package/dist/cmd/build/plugin.js.map +1 -1
  96. package/dist/cmd/cloud/agent/get.d.ts.map +1 -1
  97. package/dist/cmd/cloud/agent/get.js +5 -2
  98. package/dist/cmd/cloud/agent/get.js.map +1 -1
  99. package/dist/cmd/cloud/agent/index.d.ts.map +1 -1
  100. package/dist/cmd/cloud/agent/index.js +5 -0
  101. package/dist/cmd/cloud/agent/index.js.map +1 -1
  102. package/dist/cmd/cloud/agent/list.js +3 -3
  103. package/dist/cmd/cloud/agent/list.js.map +1 -1
  104. package/dist/cmd/cloud/apikey/create.d.ts.map +1 -1
  105. package/dist/cmd/cloud/apikey/create.js +12 -3
  106. package/dist/cmd/cloud/apikey/create.js.map +1 -1
  107. package/dist/cmd/cloud/apikey/delete.js +3 -3
  108. package/dist/cmd/cloud/apikey/delete.js.map +1 -1
  109. package/dist/cmd/cloud/apikey/get.js +1 -1
  110. package/dist/cmd/cloud/apikey/get.js.map +1 -1
  111. package/dist/cmd/cloud/apikey/index.d.ts.map +1 -1
  112. package/dist/cmd/cloud/apikey/index.js +8 -0
  113. package/dist/cmd/cloud/apikey/index.js.map +1 -1
  114. package/dist/cmd/cloud/apikey/list.d.ts.map +1 -1
  115. package/dist/cmd/cloud/apikey/list.js +4 -1
  116. package/dist/cmd/cloud/apikey/list.js.map +1 -1
  117. package/dist/cmd/cloud/db/create.d.ts +2 -0
  118. package/dist/cmd/cloud/db/create.d.ts.map +1 -0
  119. package/dist/cmd/cloud/db/create.js +82 -0
  120. package/dist/cmd/cloud/db/create.js.map +1 -0
  121. package/dist/cmd/cloud/db/delete.d.ts.map +1 -0
  122. package/dist/cmd/cloud/db/delete.js +119 -0
  123. package/dist/cmd/cloud/db/delete.js.map +1 -0
  124. package/dist/cmd/cloud/db/get.d.ts +2 -0
  125. package/dist/cmd/cloud/db/get.d.ts.map +1 -0
  126. package/dist/cmd/cloud/db/get.js +72 -0
  127. package/dist/cmd/cloud/db/get.js.map +1 -0
  128. package/dist/cmd/cloud/db/index.d.ts +2 -0
  129. package/dist/cmd/cloud/db/index.d.ts.map +1 -0
  130. package/dist/cmd/cloud/db/index.js +19 -0
  131. package/dist/cmd/cloud/db/index.js.map +1 -0
  132. package/dist/cmd/cloud/db/list.d.ts.map +1 -0
  133. package/dist/cmd/cloud/db/list.js +85 -0
  134. package/dist/cmd/cloud/db/list.js.map +1 -0
  135. package/dist/cmd/cloud/db/sql.d.ts +2 -0
  136. package/dist/cmd/cloud/db/sql.d.ts.map +1 -0
  137. package/dist/cmd/cloud/db/sql.js +111 -0
  138. package/dist/cmd/cloud/db/sql.js.map +1 -0
  139. package/dist/cmd/cloud/deploy.d.ts.map +1 -1
  140. package/dist/cmd/cloud/deploy.js +9 -3
  141. package/dist/cmd/cloud/deploy.js.map +1 -1
  142. package/dist/cmd/cloud/deployment/index.d.ts.map +1 -1
  143. package/dist/cmd/cloud/deployment/index.js +5 -0
  144. package/dist/cmd/cloud/deployment/index.js.map +1 -1
  145. package/dist/cmd/cloud/deployment/list.d.ts.map +1 -1
  146. package/dist/cmd/cloud/deployment/list.js +12 -3
  147. package/dist/cmd/cloud/deployment/list.js.map +1 -1
  148. package/dist/cmd/cloud/deployment/logs.d.ts.map +1 -1
  149. package/dist/cmd/cloud/deployment/logs.js +16 -4
  150. package/dist/cmd/cloud/deployment/logs.js.map +1 -1
  151. package/dist/cmd/cloud/deployment/remove.d.ts.map +1 -1
  152. package/dist/cmd/cloud/deployment/remove.js +12 -3
  153. package/dist/cmd/cloud/deployment/remove.js.map +1 -1
  154. package/dist/cmd/cloud/deployment/rollback.d.ts.map +1 -1
  155. package/dist/cmd/cloud/deployment/rollback.js +8 -2
  156. package/dist/cmd/cloud/deployment/rollback.js.map +1 -1
  157. package/dist/cmd/cloud/deployment/show.d.ts.map +1 -1
  158. package/dist/cmd/cloud/deployment/show.js +8 -2
  159. package/dist/cmd/cloud/deployment/show.js.map +1 -1
  160. package/dist/cmd/cloud/deployment/undeploy.d.ts.map +1 -1
  161. package/dist/cmd/cloud/deployment/undeploy.js +12 -3
  162. package/dist/cmd/cloud/deployment/undeploy.js.map +1 -1
  163. package/dist/cmd/cloud/deployment/utils.d.ts.map +1 -1
  164. package/dist/cmd/cloud/deployment/utils.js +3 -1
  165. package/dist/cmd/cloud/deployment/utils.js.map +1 -1
  166. package/dist/cmd/cloud/domain.d.ts.map +1 -1
  167. package/dist/cmd/cloud/domain.js +4 -2
  168. package/dist/cmd/cloud/domain.js.map +1 -1
  169. package/dist/cmd/cloud/env/delete.d.ts.map +1 -1
  170. package/dist/cmd/cloud/env/delete.js +4 -1
  171. package/dist/cmd/cloud/env/delete.js.map +1 -1
  172. package/dist/cmd/cloud/env/get.d.ts.map +1 -1
  173. package/dist/cmd/cloud/env/get.js +6 -4
  174. package/dist/cmd/cloud/env/get.js.map +1 -1
  175. package/dist/cmd/cloud/env/import.d.ts.map +1 -1
  176. package/dist/cmd/cloud/env/import.js +10 -0
  177. package/dist/cmd/cloud/env/import.js.map +1 -1
  178. package/dist/cmd/cloud/env/index.d.ts.map +1 -1
  179. package/dist/cmd/cloud/env/index.js +8 -0
  180. package/dist/cmd/cloud/env/index.js.map +1 -1
  181. package/dist/cmd/cloud/env/list.d.ts.map +1 -1
  182. package/dist/cmd/cloud/env/list.js +5 -3
  183. package/dist/cmd/cloud/env/list.js.map +1 -1
  184. package/dist/cmd/cloud/env/pull.d.ts.map +1 -1
  185. package/dist/cmd/cloud/env/pull.js +4 -1
  186. package/dist/cmd/cloud/env/pull.js.map +1 -1
  187. package/dist/cmd/cloud/env/push.js +1 -1
  188. package/dist/cmd/cloud/env/push.js.map +1 -1
  189. package/dist/cmd/cloud/env/set.js +3 -3
  190. package/dist/cmd/cloud/env/set.js.map +1 -1
  191. package/dist/cmd/cloud/index.d.ts.map +1 -1
  192. package/dist/cmd/cloud/index.js +9 -2
  193. package/dist/cmd/cloud/index.js.map +1 -1
  194. package/dist/cmd/cloud/keyvalue/create-namespace.d.ts.map +1 -1
  195. package/dist/cmd/cloud/keyvalue/create-namespace.js +9 -3
  196. package/dist/cmd/cloud/keyvalue/create-namespace.js.map +1 -1
  197. package/dist/cmd/cloud/keyvalue/delete-namespace.d.ts.map +1 -1
  198. package/dist/cmd/cloud/keyvalue/delete-namespace.js +12 -3
  199. package/dist/cmd/cloud/keyvalue/delete-namespace.js.map +1 -1
  200. package/dist/cmd/cloud/keyvalue/delete.d.ts.map +1 -1
  201. package/dist/cmd/cloud/keyvalue/delete.js +6 -3
  202. package/dist/cmd/cloud/keyvalue/delete.js.map +1 -1
  203. package/dist/cmd/cloud/keyvalue/get.d.ts.map +1 -1
  204. package/dist/cmd/cloud/keyvalue/get.js +3 -3
  205. package/dist/cmd/cloud/keyvalue/get.js.map +1 -1
  206. package/dist/cmd/cloud/keyvalue/index.d.ts.map +1 -1
  207. package/dist/cmd/cloud/keyvalue/index.js +8 -0
  208. package/dist/cmd/cloud/keyvalue/index.js.map +1 -1
  209. package/dist/cmd/cloud/keyvalue/keys.d.ts.map +1 -1
  210. package/dist/cmd/cloud/keyvalue/keys.js +3 -3
  211. package/dist/cmd/cloud/keyvalue/keys.js.map +1 -1
  212. package/dist/cmd/cloud/keyvalue/list-namespaces.d.ts.map +1 -1
  213. package/dist/cmd/cloud/keyvalue/list-namespaces.js +3 -3
  214. package/dist/cmd/cloud/keyvalue/list-namespaces.js.map +1 -1
  215. package/dist/cmd/cloud/keyvalue/repl.d.ts.map +1 -1
  216. package/dist/cmd/cloud/keyvalue/repl.js +1 -1
  217. package/dist/cmd/cloud/keyvalue/repl.js.map +1 -1
  218. package/dist/cmd/cloud/keyvalue/search.d.ts.map +1 -1
  219. package/dist/cmd/cloud/keyvalue/search.js +9 -3
  220. package/dist/cmd/cloud/keyvalue/search.js.map +1 -1
  221. package/dist/cmd/cloud/keyvalue/set.d.ts.map +1 -1
  222. package/dist/cmd/cloud/keyvalue/set.js +12 -3
  223. package/dist/cmd/cloud/keyvalue/set.js.map +1 -1
  224. package/dist/cmd/cloud/keyvalue/stats.d.ts.map +1 -1
  225. package/dist/cmd/cloud/keyvalue/stats.js +6 -3
  226. package/dist/cmd/cloud/keyvalue/stats.js.map +1 -1
  227. package/dist/cmd/cloud/objectstore/delete-bucket.d.ts.map +1 -1
  228. package/dist/cmd/cloud/objectstore/delete-bucket.js +8 -2
  229. package/dist/cmd/cloud/objectstore/delete-bucket.js.map +1 -1
  230. package/dist/cmd/cloud/objectstore/delete.d.ts.map +1 -1
  231. package/dist/cmd/cloud/objectstore/delete.js +12 -3
  232. package/dist/cmd/cloud/objectstore/delete.js.map +1 -1
  233. package/dist/cmd/cloud/objectstore/get.d.ts.map +1 -1
  234. package/dist/cmd/cloud/objectstore/get.js +12 -3
  235. package/dist/cmd/cloud/objectstore/get.js.map +1 -1
  236. package/dist/cmd/cloud/objectstore/index.d.ts.map +1 -1
  237. package/dist/cmd/cloud/objectstore/index.js +8 -0
  238. package/dist/cmd/cloud/objectstore/index.js.map +1 -1
  239. package/dist/cmd/cloud/objectstore/list-buckets.d.ts.map +1 -1
  240. package/dist/cmd/cloud/objectstore/list-buckets.js +6 -1
  241. package/dist/cmd/cloud/objectstore/list-buckets.js.map +1 -1
  242. package/dist/cmd/cloud/objectstore/list-keys.d.ts.map +1 -1
  243. package/dist/cmd/cloud/objectstore/list-keys.js +6 -3
  244. package/dist/cmd/cloud/objectstore/list-keys.js.map +1 -1
  245. package/dist/cmd/cloud/objectstore/put.d.ts.map +1 -1
  246. package/dist/cmd/cloud/objectstore/put.js +12 -3
  247. package/dist/cmd/cloud/objectstore/put.js.map +1 -1
  248. package/dist/cmd/cloud/objectstore/repl.d.ts.map +1 -1
  249. package/dist/cmd/cloud/objectstore/repl.js +6 -1
  250. package/dist/cmd/cloud/objectstore/repl.js.map +1 -1
  251. package/dist/cmd/cloud/objectstore/url.d.ts.map +1 -1
  252. package/dist/cmd/cloud/objectstore/url.js +12 -3
  253. package/dist/cmd/cloud/objectstore/url.js.map +1 -1
  254. package/dist/cmd/cloud/scp/download.d.ts.map +1 -1
  255. package/dist/cmd/cloud/scp/download.js +16 -4
  256. package/dist/cmd/cloud/scp/download.js.map +1 -1
  257. package/dist/cmd/cloud/scp/index.d.ts.map +1 -1
  258. package/dist/cmd/cloud/scp/index.js +11 -0
  259. package/dist/cmd/cloud/scp/index.js.map +1 -1
  260. package/dist/cmd/cloud/scp/upload.d.ts.map +1 -1
  261. package/dist/cmd/cloud/scp/upload.js +16 -4
  262. package/dist/cmd/cloud/scp/upload.js.map +1 -1
  263. package/dist/cmd/cloud/secret/delete.d.ts.map +1 -1
  264. package/dist/cmd/cloud/secret/delete.js +4 -1
  265. package/dist/cmd/cloud/secret/delete.js.map +1 -1
  266. package/dist/cmd/cloud/secret/get.d.ts.map +1 -1
  267. package/dist/cmd/cloud/secret/get.js +7 -5
  268. package/dist/cmd/cloud/secret/get.js.map +1 -1
  269. package/dist/cmd/cloud/secret/import.d.ts.map +1 -1
  270. package/dist/cmd/cloud/secret/import.js +5 -2
  271. package/dist/cmd/cloud/secret/import.js.map +1 -1
  272. package/dist/cmd/cloud/secret/index.d.ts.map +1 -1
  273. package/dist/cmd/cloud/secret/index.js +8 -0
  274. package/dist/cmd/cloud/secret/index.js.map +1 -1
  275. package/dist/cmd/cloud/secret/list.d.ts.map +1 -1
  276. package/dist/cmd/cloud/secret/list.js +5 -3
  277. package/dist/cmd/cloud/secret/list.js.map +1 -1
  278. package/dist/cmd/cloud/secret/pull.d.ts.map +1 -1
  279. package/dist/cmd/cloud/secret/pull.js +4 -1
  280. package/dist/cmd/cloud/secret/pull.js.map +1 -1
  281. package/dist/cmd/cloud/secret/push.js +1 -1
  282. package/dist/cmd/cloud/secret/push.js.map +1 -1
  283. package/dist/cmd/cloud/secret/set.d.ts.map +1 -1
  284. package/dist/cmd/cloud/secret/set.js +8 -2
  285. package/dist/cmd/cloud/secret/set.js.map +1 -1
  286. package/dist/cmd/cloud/session/get.js +1 -1
  287. package/dist/cmd/cloud/session/get.js.map +1 -1
  288. package/dist/cmd/cloud/session/index.d.ts.map +1 -1
  289. package/dist/cmd/cloud/session/index.js +5 -0
  290. package/dist/cmd/cloud/session/index.js.map +1 -1
  291. package/dist/cmd/cloud/session/list.d.ts.map +1 -1
  292. package/dist/cmd/cloud/session/list.js +29 -8
  293. package/dist/cmd/cloud/session/list.js.map +1 -1
  294. package/dist/cmd/cloud/session/logs.d.ts.map +1 -1
  295. package/dist/cmd/cloud/session/logs.js +8 -2
  296. package/dist/cmd/cloud/session/logs.js.map +1 -1
  297. package/dist/cmd/cloud/ssh.d.ts.map +1 -1
  298. package/dist/cmd/cloud/ssh.js +15 -6
  299. package/dist/cmd/cloud/ssh.js.map +1 -1
  300. package/dist/cmd/cloud/storage/create.d.ts +2 -0
  301. package/dist/cmd/cloud/storage/create.d.ts.map +1 -0
  302. package/dist/cmd/cloud/storage/create.js +61 -0
  303. package/dist/cmd/cloud/storage/create.js.map +1 -0
  304. package/dist/cmd/cloud/storage/delete.d.ts +2 -0
  305. package/dist/cmd/cloud/storage/delete.d.ts.map +1 -0
  306. package/dist/cmd/cloud/storage/delete.js +170 -0
  307. package/dist/cmd/cloud/storage/delete.js.map +1 -0
  308. package/dist/cmd/cloud/storage/download.d.ts +2 -0
  309. package/dist/cmd/cloud/storage/download.d.ts.map +1 -0
  310. package/dist/cmd/cloud/storage/download.js +143 -0
  311. package/dist/cmd/cloud/storage/download.js.map +1 -0
  312. package/dist/cmd/cloud/storage/get.d.ts +2 -0
  313. package/dist/cmd/cloud/storage/get.d.ts.map +1 -0
  314. package/dist/cmd/cloud/storage/get.js +95 -0
  315. package/dist/cmd/cloud/storage/get.js.map +1 -0
  316. package/dist/cmd/cloud/storage/index.d.ts +2 -0
  317. package/dist/cmd/cloud/storage/index.d.ts.map +1 -0
  318. package/dist/cmd/cloud/storage/index.js +30 -0
  319. package/dist/cmd/cloud/storage/index.js.map +1 -0
  320. package/dist/cmd/cloud/storage/list.d.ts +2 -0
  321. package/dist/cmd/cloud/storage/list.d.ts.map +1 -0
  322. package/dist/cmd/cloud/storage/list.js +193 -0
  323. package/dist/cmd/cloud/storage/list.js.map +1 -0
  324. package/dist/cmd/cloud/storage/upload.d.ts +2 -0
  325. package/dist/cmd/cloud/storage/upload.d.ts.map +1 -0
  326. package/dist/cmd/cloud/storage/upload.js +145 -0
  327. package/dist/cmd/cloud/storage/upload.js.map +1 -0
  328. package/dist/cmd/cloud/storage/utils.d.ts +18 -0
  329. package/dist/cmd/cloud/storage/utils.d.ts.map +1 -0
  330. package/dist/cmd/cloud/storage/utils.js +21 -0
  331. package/dist/cmd/cloud/storage/utils.js.map +1 -0
  332. package/dist/cmd/cloud/stream/delete.d.ts.map +1 -1
  333. package/dist/cmd/cloud/stream/delete.js +9 -3
  334. package/dist/cmd/cloud/stream/delete.js.map +1 -1
  335. package/dist/cmd/cloud/stream/get.d.ts.map +1 -1
  336. package/dist/cmd/cloud/stream/get.js +10 -4
  337. package/dist/cmd/cloud/stream/get.js.map +1 -1
  338. package/dist/cmd/cloud/stream/index.d.ts.map +1 -1
  339. package/dist/cmd/cloud/stream/index.js +5 -0
  340. package/dist/cmd/cloud/stream/index.js.map +1 -1
  341. package/dist/cmd/cloud/stream/list.d.ts.map +1 -1
  342. package/dist/cmd/cloud/stream/list.js +8 -5
  343. package/dist/cmd/cloud/stream/list.js.map +1 -1
  344. package/dist/cmd/cloud/vector/delete.d.ts.map +1 -1
  345. package/dist/cmd/cloud/vector/delete.js +12 -3
  346. package/dist/cmd/cloud/vector/delete.js.map +1 -1
  347. package/dist/cmd/cloud/vector/get.d.ts.map +1 -1
  348. package/dist/cmd/cloud/vector/get.js +12 -3
  349. package/dist/cmd/cloud/vector/get.js.map +1 -1
  350. package/dist/cmd/cloud/vector/index.d.ts.map +1 -1
  351. package/dist/cmd/cloud/vector/index.js +8 -0
  352. package/dist/cmd/cloud/vector/index.js.map +1 -1
  353. package/dist/cmd/cloud/vector/search.d.ts.map +1 -1
  354. package/dist/cmd/cloud/vector/search.js +20 -5
  355. package/dist/cmd/cloud/vector/search.js.map +1 -1
  356. package/dist/cmd/dev/agents.d.ts.map +1 -1
  357. package/dist/cmd/dev/agents.js +7 -2
  358. package/dist/cmd/dev/agents.js.map +1 -1
  359. package/dist/cmd/dev/api.d.ts.map +1 -1
  360. package/dist/cmd/dev/api.js +3 -1
  361. package/dist/cmd/dev/api.js.map +1 -1
  362. package/dist/cmd/dev/index.d.ts.map +1 -1
  363. package/dist/cmd/dev/index.js +13 -5
  364. package/dist/cmd/dev/index.js.map +1 -1
  365. package/dist/cmd/help/index.d.ts +2 -0
  366. package/dist/cmd/help/index.d.ts.map +1 -0
  367. package/dist/cmd/help/index.js +35 -0
  368. package/dist/cmd/help/index.js.map +1 -0
  369. package/dist/cmd/index.d.ts.map +1 -1
  370. package/dist/cmd/index.js +1 -0
  371. package/dist/cmd/index.js.map +1 -1
  372. package/dist/cmd/profile/create.js +3 -3
  373. package/dist/cmd/profile/create.js.map +1 -1
  374. package/dist/cmd/profile/delete.d.ts.map +1 -1
  375. package/dist/cmd/profile/delete.js +6 -3
  376. package/dist/cmd/profile/delete.js.map +1 -1
  377. package/dist/cmd/profile/index.d.ts.map +1 -1
  378. package/dist/cmd/profile/index.js +8 -0
  379. package/dist/cmd/profile/index.js.map +1 -1
  380. package/dist/cmd/profile/list.d.ts.map +1 -1
  381. package/dist/cmd/profile/list.js +4 -1
  382. package/dist/cmd/profile/list.js.map +1 -1
  383. package/dist/cmd/profile/show.d.ts.map +1 -1
  384. package/dist/cmd/profile/show.js +6 -3
  385. package/dist/cmd/profile/show.js.map +1 -1
  386. package/dist/cmd/profile/use.js +3 -3
  387. package/dist/cmd/profile/use.js.map +1 -1
  388. package/dist/cmd/project/create.d.ts.map +1 -1
  389. package/dist/cmd/project/create.js +11 -5
  390. package/dist/cmd/project/create.js.map +1 -1
  391. package/dist/cmd/project/delete.d.ts.map +1 -1
  392. package/dist/cmd/project/delete.js +15 -6
  393. package/dist/cmd/project/delete.js.map +1 -1
  394. package/dist/cmd/project/download.d.ts +1 -1
  395. package/dist/cmd/project/download.d.ts.map +1 -1
  396. package/dist/cmd/project/download.js +28 -2
  397. package/dist/cmd/project/download.js.map +1 -1
  398. package/dist/cmd/project/index.d.ts.map +1 -1
  399. package/dist/cmd/project/index.js +5 -0
  400. package/dist/cmd/project/index.js.map +1 -1
  401. package/dist/cmd/project/list.js +3 -3
  402. package/dist/cmd/project/list.js.map +1 -1
  403. package/dist/cmd/project/show.d.ts.map +1 -1
  404. package/dist/cmd/project/show.js +6 -3
  405. package/dist/cmd/project/show.js.map +1 -1
  406. package/dist/cmd/project/templates.d.ts.map +1 -1
  407. package/dist/cmd/project/templates.js +10 -2
  408. package/dist/cmd/project/templates.js.map +1 -1
  409. package/dist/cmd/repl/index.js +1 -1
  410. package/dist/cmd/repl/index.js.map +1 -1
  411. package/dist/cmd/version/index.d.ts.map +1 -1
  412. package/dist/cmd/version/index.js +4 -1
  413. package/dist/cmd/version/index.js.map +1 -1
  414. package/dist/command-prefix.d.ts.map +1 -1
  415. package/dist/command-prefix.js +5 -3
  416. package/dist/command-prefix.js.map +1 -1
  417. package/dist/config.d.ts +1 -1
  418. package/dist/config.d.ts.map +1 -1
  419. package/dist/config.js +3 -1
  420. package/dist/config.js.map +1 -1
  421. package/dist/crypto/box.d.ts.map +1 -1
  422. package/dist/crypto/box.js +31 -17
  423. package/dist/crypto/box.js.map +1 -1
  424. package/dist/download.d.ts.map +1 -1
  425. package/dist/download.js +7 -1
  426. package/dist/download.js.map +1 -1
  427. package/dist/env-util.d.ts +3 -0
  428. package/dist/env-util.d.ts.map +1 -1
  429. package/dist/env-util.js +43 -2
  430. package/dist/env-util.js.map +1 -1
  431. package/dist/errors.d.ts +4 -2
  432. package/dist/errors.d.ts.map +1 -1
  433. package/dist/errors.js +7 -1
  434. package/dist/errors.js.map +1 -1
  435. package/dist/index.d.ts +1 -1
  436. package/dist/index.d.ts.map +1 -1
  437. package/dist/index.js +1 -1
  438. package/dist/index.js.map +1 -1
  439. package/dist/schema-generator.d.ts +5 -1
  440. package/dist/schema-generator.d.ts.map +1 -1
  441. package/dist/schema-generator.js +1 -0
  442. package/dist/schema-generator.js.map +1 -1
  443. package/dist/steps.js +17 -13
  444. package/dist/steps.js.map +1 -1
  445. package/dist/tui.d.ts +4 -2
  446. package/dist/tui.d.ts.map +1 -1
  447. package/dist/tui.js +24 -14
  448. package/dist/tui.js.map +1 -1
  449. package/dist/types.d.ts +10 -6
  450. package/dist/types.d.ts.map +1 -1
  451. package/dist/types.js.map +1 -1
  452. package/dist/utils/date.d.ts.map +1 -1
  453. package/dist/utils/date.js +7 -2
  454. package/dist/utils/date.js.map +1 -1
  455. package/dist/version.js +1 -1
  456. package/dist/version.js.map +1 -1
  457. package/package.json +3 -3
  458. package/src/banner.ts +29 -13
  459. package/src/cli.ts +124 -14
  460. package/src/cmd/ai/capabilities/index.ts +4 -0
  461. package/src/cmd/ai/capabilities/show.ts +23 -5
  462. package/src/cmd/ai/index.ts +11 -0
  463. package/src/cmd/ai/prompt/agent.ts +342 -0
  464. package/src/cmd/ai/prompt/api.ts +274 -0
  465. package/src/cmd/ai/prompt/index.ts +18 -3
  466. package/src/cmd/ai/prompt/llm.ts +2 -2
  467. package/src/cmd/ai/prompt/web.ts +301 -0
  468. package/src/cmd/ai/schema/generate.ts +1 -1
  469. package/src/cmd/ai/schema/index.ts +2 -0
  470. package/src/cmd/ai/schema/show.ts +4 -1
  471. package/src/cmd/auth/api.ts +28 -6
  472. package/src/cmd/auth/index.ts +5 -0
  473. package/src/cmd/auth/login.ts +5 -22
  474. package/src/cmd/auth/logout.ts +4 -1
  475. package/src/cmd/auth/signup.ts +4 -1
  476. package/src/cmd/auth/ssh/add.ts +13 -4
  477. package/src/cmd/auth/ssh/api.ts +21 -5
  478. package/src/cmd/auth/ssh/delete.ts +4 -4
  479. package/src/cmd/auth/ssh/index.ts +5 -0
  480. package/src/cmd/auth/ssh/list.ts +3 -3
  481. package/src/cmd/auth/whoami.ts +4 -7
  482. package/src/cmd/build/ast.ts +605 -31
  483. package/src/cmd/build/bundler.ts +110 -37
  484. package/src/cmd/build/file.ts +1 -1
  485. package/src/cmd/build/fix-duplicate-exports.ts +4 -1
  486. package/src/cmd/build/index.ts +58 -13
  487. package/src/cmd/build/plugin.ts +210 -46
  488. package/src/cmd/cloud/agent/get.ts +5 -2
  489. package/src/cmd/cloud/agent/index.ts +5 -0
  490. package/src/cmd/cloud/agent/list.ts +3 -3
  491. package/src/cmd/cloud/apikey/create.ts +14 -5
  492. package/src/cmd/cloud/apikey/delete.ts +3 -3
  493. package/src/cmd/cloud/apikey/get.ts +1 -1
  494. package/src/cmd/cloud/apikey/index.ts +8 -0
  495. package/src/cmd/cloud/apikey/list.ts +4 -1
  496. package/src/cmd/cloud/db/create.ts +87 -0
  497. package/src/cmd/cloud/db/delete.ts +133 -0
  498. package/src/cmd/cloud/db/get.ts +83 -0
  499. package/src/cmd/cloud/db/index.ts +19 -0
  500. package/src/cmd/cloud/db/list.ts +95 -0
  501. package/src/cmd/cloud/db/sql.ts +134 -0
  502. package/src/cmd/cloud/deploy.ts +9 -3
  503. package/src/cmd/cloud/deployment/index.ts +5 -0
  504. package/src/cmd/cloud/deployment/list.ts +12 -3
  505. package/src/cmd/cloud/deployment/logs.ts +16 -4
  506. package/src/cmd/cloud/deployment/remove.ts +14 -4
  507. package/src/cmd/cloud/deployment/rollback.ts +8 -3
  508. package/src/cmd/cloud/deployment/show.ts +8 -2
  509. package/src/cmd/cloud/deployment/undeploy.ts +12 -4
  510. package/src/cmd/cloud/deployment/utils.ts +7 -1
  511. package/src/cmd/cloud/domain.ts +9 -2
  512. package/src/cmd/cloud/env/delete.ts +4 -1
  513. package/src/cmd/cloud/env/get.ts +6 -4
  514. package/src/cmd/cloud/env/import.ts +10 -0
  515. package/src/cmd/cloud/env/index.ts +8 -0
  516. package/src/cmd/cloud/env/list.ts +5 -3
  517. package/src/cmd/cloud/env/pull.ts +4 -1
  518. package/src/cmd/cloud/env/push.ts +1 -1
  519. package/src/cmd/cloud/env/set.ts +3 -3
  520. package/src/cmd/cloud/index.ts +9 -2
  521. package/src/cmd/cloud/keyvalue/create-namespace.ts +9 -4
  522. package/src/cmd/cloud/keyvalue/delete-namespace.ts +12 -4
  523. package/src/cmd/cloud/keyvalue/delete.ts +6 -4
  524. package/src/cmd/cloud/keyvalue/get.ts +3 -4
  525. package/src/cmd/cloud/keyvalue/index.ts +8 -0
  526. package/src/cmd/cloud/keyvalue/keys.ts +3 -4
  527. package/src/cmd/cloud/keyvalue/list-namespaces.ts +3 -4
  528. package/src/cmd/cloud/keyvalue/repl.ts +1 -2
  529. package/src/cmd/cloud/keyvalue/search.ts +9 -4
  530. package/src/cmd/cloud/keyvalue/set.ts +14 -4
  531. package/src/cmd/cloud/keyvalue/stats.ts +6 -4
  532. package/src/cmd/cloud/objectstore/delete-bucket.ts +8 -3
  533. package/src/cmd/cloud/objectstore/delete.ts +12 -4
  534. package/src/cmd/cloud/objectstore/get.ts +12 -4
  535. package/src/cmd/cloud/objectstore/index.ts +8 -0
  536. package/src/cmd/cloud/objectstore/list-buckets.ts +6 -2
  537. package/src/cmd/cloud/objectstore/list-keys.ts +6 -4
  538. package/src/cmd/cloud/objectstore/put.ts +16 -4
  539. package/src/cmd/cloud/objectstore/repl.ts +6 -2
  540. package/src/cmd/cloud/objectstore/url.ts +12 -4
  541. package/src/cmd/cloud/scp/download.ts +16 -5
  542. package/src/cmd/cloud/scp/index.ts +11 -0
  543. package/src/cmd/cloud/scp/upload.ts +16 -5
  544. package/src/cmd/cloud/secret/delete.ts +4 -1
  545. package/src/cmd/cloud/secret/get.ts +7 -5
  546. package/src/cmd/cloud/secret/import.ts +5 -2
  547. package/src/cmd/cloud/secret/index.ts +8 -0
  548. package/src/cmd/cloud/secret/list.ts +5 -3
  549. package/src/cmd/cloud/secret/pull.ts +4 -1
  550. package/src/cmd/cloud/secret/push.ts +1 -1
  551. package/src/cmd/cloud/secret/set.ts +8 -2
  552. package/src/cmd/cloud/session/get.ts +1 -1
  553. package/src/cmd/cloud/session/index.ts +5 -0
  554. package/src/cmd/cloud/session/list.ts +29 -8
  555. package/src/cmd/cloud/session/logs.ts +8 -2
  556. package/src/cmd/cloud/ssh.ts +15 -7
  557. package/src/cmd/cloud/storage/create.ts +65 -0
  558. package/src/cmd/cloud/storage/delete.ts +198 -0
  559. package/src/cmd/cloud/storage/download.ts +166 -0
  560. package/src/cmd/cloud/storage/get.ts +106 -0
  561. package/src/cmd/cloud/storage/index.ts +30 -0
  562. package/src/cmd/cloud/storage/list.ts +221 -0
  563. package/src/cmd/cloud/storage/upload.ts +165 -0
  564. package/src/cmd/cloud/storage/utils.ts +26 -0
  565. package/src/cmd/cloud/stream/delete.ts +9 -4
  566. package/src/cmd/cloud/stream/get.ts +10 -5
  567. package/src/cmd/cloud/stream/index.ts +5 -0
  568. package/src/cmd/cloud/stream/list.ts +8 -6
  569. package/src/cmd/cloud/vector/delete.ts +17 -6
  570. package/src/cmd/cloud/vector/get.ts +12 -4
  571. package/src/cmd/cloud/vector/index.ts +8 -0
  572. package/src/cmd/cloud/vector/search.ts +20 -6
  573. package/src/cmd/dev/agents.ts +7 -2
  574. package/src/cmd/dev/api.ts +4 -1
  575. package/src/cmd/dev/index.ts +16 -5
  576. package/src/cmd/help/index.ts +40 -0
  577. package/src/cmd/index.ts +1 -0
  578. package/src/cmd/profile/create.ts +3 -3
  579. package/src/cmd/profile/delete.ts +6 -3
  580. package/src/cmd/profile/index.ts +8 -0
  581. package/src/cmd/profile/list.ts +4 -1
  582. package/src/cmd/profile/show.ts +6 -3
  583. package/src/cmd/profile/use.ts +3 -3
  584. package/src/cmd/project/create.ts +11 -5
  585. package/src/cmd/project/delete.ts +15 -6
  586. package/src/cmd/project/download.ts +35 -3
  587. package/src/cmd/project/index.ts +5 -0
  588. package/src/cmd/project/list.ts +3 -3
  589. package/src/cmd/project/show.ts +6 -3
  590. package/src/cmd/project/templates.ts +12 -2
  591. package/src/cmd/repl/index.ts +1 -1
  592. package/src/cmd/version/index.ts +4 -1
  593. package/src/command-prefix.ts +5 -3
  594. package/src/config.ts +4 -2
  595. package/src/crypto/box.ts +69 -17
  596. package/src/download.ts +7 -1
  597. package/src/env-util.ts +44 -2
  598. package/src/errors.ts +9 -1
  599. package/src/index.ts +6 -1
  600. package/src/schema-generator.ts +7 -1
  601. package/src/steps.ts +22 -13
  602. package/src/tui.ts +32 -16
  603. package/src/types.ts +11 -6
  604. package/src/utils/date.ts +9 -4
  605. package/src/version.ts +1 -1
  606. package/dist/cmd/cloud/resource/add.d.ts +0 -2
  607. package/dist/cmd/cloud/resource/add.d.ts.map +0 -1
  608. package/dist/cmd/cloud/resource/add.js +0 -70
  609. package/dist/cmd/cloud/resource/add.js.map +0 -1
  610. package/dist/cmd/cloud/resource/delete.d.ts.map +0 -1
  611. package/dist/cmd/cloud/resource/delete.js +0 -126
  612. package/dist/cmd/cloud/resource/delete.js.map +0 -1
  613. package/dist/cmd/cloud/resource/index.d.ts +0 -2
  614. package/dist/cmd/cloud/resource/index.d.ts.map +0 -1
  615. package/dist/cmd/cloud/resource/index.js +0 -12
  616. package/dist/cmd/cloud/resource/index.js.map +0 -1
  617. package/dist/cmd/cloud/resource/list.d.ts.map +0 -1
  618. package/dist/cmd/cloud/resource/list.js +0 -100
  619. package/dist/cmd/cloud/resource/list.js.map +0 -1
  620. package/src/cmd/cloud/resource/add.ts +0 -75
  621. package/src/cmd/cloud/resource/delete.ts +0 -141
  622. package/src/cmd/cloud/resource/index.ts +0 -12
  623. package/src/cmd/cloud/resource/list.ts +0 -105
  624. /package/dist/cmd/cloud/{resource → db}/delete.d.ts +0 -0
  625. /package/dist/cmd/cloud/{resource → db}/list.d.ts +0 -0
package/src/cmd/ai/prompt/web.ts ADDED
@@ -0,0 +1,301 @@
1
+ import { createSubcommand } from '../../../types';
2
+ import type { CommandContext } from '../../../types';
3
+ import { getCommand } from '../../../command-prefix';
4
+
5
+ export const webSubcommand = createSubcommand({
6
+ name: 'web',
7
+ description: 'Generate a comprehensive prompt for LLM agents for the web folder',
8
+ tags: ['read-only', 'fast'],
9
+ idempotent: true,
10
+ examples: [{ command: getCommand('prompt web'), description: 'Run web command' }],
11
+ async handler(_ctx: CommandContext) {
12
+ const prompt = generateLLMPrompt();
13
+ console.log(prompt);
14
+ },
15
+ });
16
+
17
+ export function generateLLMPrompt(): string {
18
+ return `# Web Folder Guide
19
+
20
+ This folder contains your React-based web application that communicates with your Agentuity agents.
21
+
22
+ ## Directory Structure
23
+
24
+ Required files:
25
+ - **App.tsx** (required) - Main React application component
26
+ - **frontend.tsx** (required) - Frontend entry point with client-side rendering
27
+ - **index.html** (required) - HTML template
28
+ - **public/** (optional) - Static assets (images, CSS, JS files)
29
+
30
+ Example structure:
31
+ \`\`\`
32
+ src/web/
33
+ ├── App.tsx
34
+ ├── frontend.tsx
35
+ ├── index.html
36
+ └── public/
37
+ ├── styles.css
38
+ ├── logo.svg
39
+ └── script.js
40
+ \`\`\`
41
+
42
+ ## Creating the Web App
43
+
44
+ ### App.tsx - Main Component
45
+
46
+ \`\`\`typescript
47
+ import { AgentuityProvider, useAgent } from '@agentuity/react';
48
+ import { useState } from 'react';
49
+
50
+ export function App() {
51
+ const [name, setName] = useState('World');
52
+ const { run, running, data: greeting } = useAgent('hello');
53
+
54
+ return (
55
+ <div style={{ fontFamily: 'sans-serif', padding: '2rem' }}>
56
+ <AgentuityProvider>
57
+ <h1>Welcome to Agentuity</h1>
58
+
59
+ <input
60
+ type="text"
61
+ value={name}
62
+ onChange={(e) => setName(e.target.value)}
63
+ disabled={running}
64
+ />
65
+
66
+ <button
67
+ onClick={() => run({ name })}
68
+ disabled={running}
69
+ >
70
+ {running ? 'Running...' : 'Say Hello'}
71
+ </button>
72
+
73
+ <div>{greeting ?? 'Waiting for response'}</div>
74
+ </AgentuityProvider>
75
+ </div>
76
+ );
77
+ }
78
+ \`\`\`
79
+
80
+ ### frontend.tsx - Entry Point
81
+
82
+ \`\`\`typescript
83
+ import { createRoot } from 'react-dom/client';
84
+ import { App } from './App';
85
+
86
+ const root = document.getElementById('root');
87
+ if (!root) throw new Error('Root element not found');
88
+
89
+ createRoot(root).render(<App />);
90
+ \`\`\`
91
+
92
+ ### index.html - HTML Template
93
+
94
+ \`\`\`html
95
+ <!DOCTYPE html>
96
+ <html lang="en">
97
+ <head>
98
+ <meta charset="UTF-8">
99
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
100
+ <title>My Agentuity App</title>
101
+ </head>
102
+ <body>
103
+ <div id="root"></div>
104
+ <script type="module" src="/web/frontend.tsx"></script>
105
+ </body>
106
+ </html>
107
+ \`\`\`
108
+
109
+ ## React Hooks
110
+
111
+ ### useAgent - Call Agents
112
+
113
+ \`\`\`typescript
114
+ import { useAgent } from '@agentuity/react';
115
+
116
+ function MyComponent() {
117
+ const { run, running, data, error } = useAgent('myAgent');
118
+
119
+ return (
120
+ <button onClick={() => run({ input: 'value' })}>
121
+ {running ? 'Running...' : 'Call Agent'}
122
+ </button>
123
+ );
124
+ }
125
+ \`\`\`
126
+
127
+ ### useAgentWebsocket - WebSocket Connection
128
+
129
+ \`\`\`typescript
130
+ import { useAgentWebsocket } from '@agentuity/react';
131
+
132
+ function MyComponent() {
133
+ const { connected, send, data } = useAgentWebsocket('websocket');
134
+
135
+ return (
136
+ <div>
137
+ <p>Status: {connected ? 'Connected' : 'Disconnected'}</p>
138
+ <button onClick={() => send('Hello')}>Send Message</button>
139
+ <p>Received: {data}</p>
140
+ </div>
141
+ );
142
+ }
143
+ \`\`\`
144
+
145
+ ### useAgentEventStream - Server-Sent Events
146
+
147
+ \`\`\`typescript
148
+ import { useAgentEventStream } from '@agentuity/react';
149
+
150
+ function MyComponent() {
151
+ const { connected, data, error } = useAgentEventStream('sse');
152
+
153
+ return (
154
+ <div>
155
+ <p>Connected: {connected ? 'Yes' : 'No'}</p>
156
+ {error && <p>Error: {error.message}</p>}
157
+ <p>Data: {data}</p>
158
+ </div>
159
+ );
160
+ }
161
+ \`\`\`
162
+
163
+ ## Complete Example
164
+
165
+ \`\`\`typescript
166
+ import { AgentuityProvider, useAgent, useAgentWebsocket } from '@agentuity/react';
167
+ import { useEffect, useState } from 'react';
168
+
169
+ export function App() {
170
+ const [count, setCount] = useState(0);
171
+ const { run, data: agentResult } = useAgent('simple');
172
+ const { connected, send, data: wsMessage } = useAgentWebsocket('websocket');
173
+
174
+ useEffect(() => {
175
+ // Send WebSocket message every second
176
+ const interval = setInterval(() => {
177
+ send(\`Message at \${new Date().toISOString()}\`);
178
+ }, 1000);
179
+ return () => clearInterval(interval);
180
+ }, [send]);
181
+
182
+ return (
183
+ <div style={{ fontFamily: 'sans-serif', padding: '2rem' }}>
184
+ <AgentuityProvider>
185
+ <h1>My Agentuity App</h1>
186
+
187
+ <div>
188
+ <p>Count: {count}</p>
189
+ <button onClick={() => setCount(c => c + 1)}>
190
+ Increment
191
+ </button>
192
+ </div>
193
+
194
+ <div>
195
+ <button onClick={() => run({ name: 'Jeff', age: 30 })}>
196
+ Call Agent
197
+ </button>
198
+ <p>{agentResult}</p>
199
+ </div>
200
+
201
+ <div>
202
+ <strong>WebSocket:</strong>
203
+ {connected ? JSON.stringify(wsMessage) : 'Not connected'}
204
+ </div>
205
+ </AgentuityProvider>
206
+ </div>
207
+ );
208
+ }
209
+ \`\`\`
210
+
211
+ ## Static Assets
212
+
213
+ Place static files in the **public/** folder:
214
+
215
+ \`\`\`
216
+ src/web/public/
217
+ ├── logo.svg
218
+ ├── styles.css
219
+ └── script.js
220
+ \`\`\`
221
+
222
+ Reference them in your HTML or components:
223
+
224
+ \`\`\`html
225
+ <!-- In index.html -->
226
+ <link rel="stylesheet" href="/public/styles.css">
227
+ <script src="/public/script.js"></script>
228
+ \`\`\`
229
+
230
+ \`\`\`typescript
231
+ // In React components
232
+ <img src="/public/logo.svg" alt="Logo" />
233
+ \`\`\`
234
+
235
+ ## Styling
236
+
237
+ ### Inline Styles
238
+
239
+ \`\`\`typescript
240
+ <div style={{ backgroundColor: '#000', color: '#fff', padding: '1rem' }}>
241
+ Styled content
242
+ </div>
243
+ \`\`\`
244
+
245
+ ### CSS Files
246
+
247
+ Create \`public/styles.css\`:
248
+
249
+ \`\`\`css
250
+ body {
251
+ background-color: #09090b;
252
+ color: #fff;
253
+ font-family: sans-serif;
254
+ }
255
+ \`\`\`
256
+
257
+ Import in \`index.html\`:
258
+
259
+ \`\`\`html
260
+ <link rel="stylesheet" href="/public/styles.css">
261
+ \`\`\`
262
+
263
+ ### Style Tag in Component
264
+
265
+ \`\`\`typescript
266
+ <div>
267
+ <button className="glow-btn">Click me</button>
268
+ <style>{\`
269
+ .glow-btn {
270
+ background: linear-gradient(to right, #155e75, #3b82f6);
271
+ border: none;
272
+ padding: 0.75rem 1.5rem;
273
+ color: white;
274
+ cursor: pointer;
275
+ }
276
+ \`}</style>
277
+ </div>
278
+ \`\`\`
279
+
280
+ ## Best Practices
281
+
282
+ - Wrap your app with **AgentuityProvider** for hooks to work
283
+ - Use **useAgent** for one-off agent calls
284
+ - Use **useAgentWebsocket** for bidirectional real-time communication
285
+ - Use **useAgentEventStream** for server-to-client streaming
286
+ - Place reusable components in separate files
287
+ - Keep static assets in the **public/** folder
288
+ - Use TypeScript for type safety
289
+ - Handle loading and error states in UI
290
+
291
+ ## Rules
292
+
293
+ - **App.tsx** must export a function named \`App\`
294
+ - **frontend.tsx** must render the \`App\` component to \`#root\`
295
+ - **index.html** must have a \`<div id="root"></div>\`
296
+ - All agents are accessible via \`useAgent('agentName')\`
297
+ - The web app is served at \`/\` by default
298
+ - Static files in \`public/\` are served at \`/public/*\`
299
+ - Module script tag: \`<script type="module" src="/web/frontend.tsx"></script>\`
300
+ `;
301
+ }
package/src/cmd/ai/schema/generate.ts CHANGED
@@ -16,7 +16,7 @@ export const generateSubcommand = createSubcommand({
16
16
  description: 'Generate a JSON schema for the agentuity.json config file',
17
17
  tags: ['read-only', 'fast'],
18
18
  idempotent: true,
19
- examples: [getCommand('schema generate')],
19
+ examples: [{ command: getCommand('schema generate'), description: 'Run generate command' }],
20
20
  async handler(_ctx: CommandContext) {
21
21
  const o = z.toJSONSchema(ProjectSchema);
22
22
  const { $schema, allOf, ...rest } = o;
package/src/cmd/ai/schema/index.ts CHANGED
@@ -2,11 +2,13 @@ import type { CommandDefinition } from '../../../types';
2
2
  import { createCommand } from '../../../types';
3
3
  import { showSubcommand } from './show';
4
4
  import { generateSubcommand } from './generate';
5
+ import { getCommand } from '../../../command-prefix';
5
6
 
6
7
  export const schemaCommand: CommandDefinition = createCommand({
7
8
  name: 'schema',
8
9
  description: 'Output CLI schema in machine-readable format',
9
10
  tags: ['read-only', 'fast'],
11
+ examples: [{ command: getCommand('ai schema show'), description: 'Show CLI schema as JSON' }],
10
12
  subcommands: [showSubcommand, generateSubcommand],
11
13
  });
12
14
 
package/src/cmd/ai/schema/show.ts CHANGED
@@ -7,7 +7,10 @@ export const showSubcommand = createSubcommand({
7
7
  description: 'Display the complete CLI schema',
8
8
  tags: ['read-only', 'fast'],
9
9
  idempotent: true,
10
- examples: [getCommand('schema show'), getCommand('--help=json')],
10
+ examples: [
11
+ { command: getCommand('schema show'), description: 'Show details' },
12
+ { command: getCommand('--help=json'), description: 'Show help information' },
13
+ ],
11
14
  async handler(ctx: CommandContext) {
12
15
  const { logger } = ctx;
13
16
 
package/src/cmd/auth/api.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import { z } from 'zod';
2
2
  import { APIError, APIResponseSchema, APIResponseSchemaOptionalData } from '@agentuity/server';
3
3
  import type { APIClient } from '../../api';
4
+ import { StructuredError } from '@agentuity/core';
4
5
 
5
6
  // Zod schemas for API validation
6
7
  const OTPStartDataSchema = z.object({
@@ -36,6 +37,11 @@ export interface SignupResult {
36
37
  expires: Date;
37
38
  }
38
39
 
40
+ const OTPGenerationError = StructuredError(
41
+ 'OTPGenerationError',
42
+ 'Error generating the one-time login code'
43
+ );
44
+
39
45
  export async function generateLoginOTP(apiClient: APIClient): Promise<string> {
40
46
  const resp = await apiClient.request(
41
47
  'GET',
@@ -44,16 +50,22 @@ export async function generateLoginOTP(apiClient: APIClient): Promise<string> {
44
50
  );
45
51
 
46
52
  if (!resp.success) {
47
- throw new Error(resp.message);
53
+ throw new OTPGenerationError();
48
54
  }
49
55
 
50
56
  if (!resp.data) {
51
- throw new Error('No OTP returned from server');
57
+ throw new OTPGenerationError();
52
58
  }
53
59
 
54
60
  return resp.data.otp;
55
61
  }
56
62
 
63
+ const PollForLoginError = StructuredError('PollForLoginError');
64
+ const PollForLoginTimeout = StructuredError(
65
+ 'PollForLoginTimeout',
66
+ 'Timed out waiting for user login. Aborting'
67
+ );
68
+
57
69
  export async function pollForLoginCompletion(
58
70
  apiClient: APIClient,
59
71
  otp: string,
@@ -71,7 +83,7 @@ export async function pollForLoginCompletion(
71
83
  );
72
84
 
73
85
  if (!resp.success) {
74
- throw new Error(resp.message);
86
+ throw new PollForLoginError({ message: resp.message });
75
87
  }
76
88
 
77
89
  if (resp.data) {
@@ -85,7 +97,7 @@ export async function pollForLoginCompletion(
85
97
  await Bun.sleep(2000);
86
98
  }
87
99
 
88
- throw new Error('Login timed out');
100
+ throw new PollForLoginTimeout();
89
101
  }
90
102
 
91
103
  export function generateSignupOTP(): string {
@@ -99,6 +111,16 @@ export function generateSignupOTP(): string {
99
111
  return result;
100
112
  }
101
113
 
114
+ const PollForSignupCompletedError = StructuredError(
115
+ 'PollForSignupCompletedError',
116
+ 'Error waiting for signup completion. Please try again.'
117
+ );
118
+
119
+ const PollForSignupTimeoutError = StructuredError(
120
+ 'PollForSignupTimeoutError',
121
+ 'Timed out waiting for user signup. Aborting.'
122
+ );
123
+
102
124
  export async function pollForSignupCompletion(
103
125
  apiClient: APIClient,
104
126
  otp: string,
@@ -115,7 +137,7 @@ export async function pollForSignupCompletion(
115
137
  );
116
138
 
117
139
  if (!resp.success) {
118
- throw new Error(resp.message);
140
+ throw new PollForSignupCompletedError();
119
141
  }
120
142
 
121
143
  if (resp.data) {
@@ -136,5 +158,5 @@ export async function pollForSignupCompletion(
136
158
  await Bun.sleep(2000);
137
159
  }
138
160
 
139
- throw new Error('Signup timed out');
161
+ throw new PollForSignupTimeoutError();
140
162
  }
package/src/cmd/auth/index.ts CHANGED
@@ -4,10 +4,15 @@ import { logoutCommand } from './logout';
4
4
  import { signupCommand } from './signup';
5
5
  import { whoamiCommand } from './whoami';
6
6
  import { sshSubcommand } from './ssh';
7
+ import { getCommand } from '../../command-prefix';
7
8
 
8
9
  export const command = createCommand({
9
10
  name: 'auth',
10
11
  description: 'Authentication and authorization related commands',
11
12
  tags: ['read-only', 'fast'],
13
+ examples: [
14
+ { command: getCommand('auth login'), description: 'Login to your account' },
15
+ { command: getCommand('auth whoami'), description: 'Show current user info' },
16
+ ],
12
17
  subcommands: [loginCommand, logoutCommand, signupCommand, whoamiCommand, sshSubcommand],
13
18
  });
package/src/cmd/auth/login.ts CHANGED
@@ -1,5 +1,4 @@
1
1
  import { createSubcommand } from '../../types';
2
- import { UpgradeRequiredError, ValidationError } from '@agentuity/server';
3
2
  import { getAppBaseURL } from '../../api';
4
3
  import { saveAuth } from '../../config';
5
4
  import { generateLoginOTP, pollForLoginCompletion } from './api';
@@ -14,16 +13,13 @@ export const loginCommand = createSubcommand({
14
13
  toplevel: true,
15
14
  idempotent: false,
16
15
  requires: { apiClient: true },
17
- examples: [getCommand('auth login'), getCommand('login')],
16
+ examples: [
17
+ { command: getCommand('auth login'), description: 'Login to account' },
18
+ { command: getCommand('login'), description: 'Login to account' },
19
+ ],
18
20
  async handler(ctx) {
19
21
  const { logger, config, apiClient } = ctx;
20
22
 
21
- if (!apiClient) {
22
- throw new Error(
23
- 'API client is not available. This is likely a configuration or initialization issue.'
24
- );
25
- }
26
-
27
23
  const appUrl = getAppBaseURL(config);
28
24
 
29
25
  try {
@@ -73,20 +69,7 @@ export const loginCommand = createSubcommand({
73
69
  tui.success('Welcome to Agentuity! You are now logged in');
74
70
  } catch (error) {
75
71
  logger.trace(error);
76
- if (error instanceof UpgradeRequiredError) {
77
- const bannerBody = `${error.message}\n\nVisit: ${tui.link('https://agentuity.dev/CLI/installation')}`;
78
- tui.banner('CLI Upgrade Required', bannerBody);
79
- process.exit(1);
80
- } else if (error instanceof ValidationError) {
81
- tui.error(`API error: ${error.message}`);
82
- tui.warning(`API url: ${error.url}`);
83
- error.issues.map((i) => tui.arrow(`${i.message} for ${i.path}`));
84
- process.exit(1);
85
- } else if (error instanceof Error) {
86
- logger.fatal(`Login failed: ${error.message}`, ErrorCode.AUTH_FAILED);
87
- } else {
88
- logger.fatal('Login failed', ErrorCode.AUTH_FAILED);
89
- }
72
+ logger.fatal('Login failed: %s', error, ErrorCode.AUTH_FAILED);
90
73
  }
91
74
  },
92
75
  });
package/src/cmd/auth/logout.ts CHANGED
@@ -9,7 +9,10 @@ export const logoutCommand = createSubcommand({
9
9
  tags: ['mutating', 'deletes-resource', 'fast', 'requires-auth'],
10
10
  toplevel: true,
11
11
  idempotent: false,
12
- examples: [getCommand('auth logout'), getCommand('logout')],
12
+ examples: [
13
+ { command: getCommand('auth logout'), description: 'Logout from account' },
14
+ { command: getCommand('logout'), description: 'Logout from account' },
15
+ ],
13
16
 
14
17
  async handler() {
15
18
  await clearAuth();
package/src/cmd/auth/signup.ts CHANGED
@@ -13,7 +13,10 @@ export const signupCommand = createSubcommand({
13
13
  toplevel: true,
14
14
  idempotent: false,
15
15
  requires: { apiClient: true },
16
- examples: [getCommand('auth signup'), getCommand('signup')],
16
+ examples: [
17
+ { command: getCommand('auth signup'), description: 'Sign up for account' },
18
+ { command: getCommand('signup'), description: 'Sign up for account' },
19
+ ],
17
20
 
18
21
  async handler(ctx) {
19
22
  const { logger, config, apiClient } = ctx;
package/src/cmd/auth/ssh/add.ts CHANGED
@@ -119,10 +119,19 @@ export const addCommand = createSubcommand({
119
119
  idempotent: false,
120
120
  requires: { apiClient: true, auth: true },
121
121
  examples: [
122
- getCommand('auth ssh add'),
123
- getCommand('auth ssh add --file ~/.ssh/id_ed25519.pub'),
124
- getCommand('auth ssh add --file ./deploy_key.pub'),
125
- 'cat ~/.ssh/id_rsa.pub | ' + getCommand('auth ssh add'),
122
+ { command: getCommand('auth ssh add'), description: 'Add SSH key interactively' },
123
+ {
124
+ command: getCommand('auth ssh add --file ~/.ssh/id_ed25519.pub'),
125
+ description: 'Add SSH key from file',
126
+ },
127
+ {
128
+ command: getCommand('auth ssh add --file ./deploy_key.pub'),
129
+ description: 'Add deploy key from file',
130
+ },
131
+ {
132
+ command: 'cat ~/.ssh/id_rsa.pub | ' + getCommand('auth ssh add'),
133
+ description: 'Add SSH key from stdin',
134
+ },
126
135
  ],
127
136
  schema: {
128
137
  options: optionsSchema,
package/src/cmd/auth/ssh/api.ts CHANGED
@@ -2,6 +2,7 @@ import { z } from 'zod';
2
2
  import { APIResponseSchema } from '@agentuity/server';
3
3
  import type { APIClient } from '../../../api';
4
4
  import { createHash } from 'crypto';
5
+ import { StructuredError } from '@agentuity/core';
5
6
 
6
7
  // Zod schemas for API validation
7
8
  const SSHKeySchema = z.object({
@@ -33,11 +34,16 @@ export interface AddSSHKeyResult {
33
34
  added: boolean;
34
35
  }
35
36
 
37
+ const InvalidSSHConfigurationError = StructuredError(
38
+ 'InvalidSSHConfigurationError',
39
+ 'Invalid SSH public key format'
40
+ );
41
+
36
42
  export function computeSSHKeyFingerprint(publicKey: string): string {
37
43
  // Parse the key (format: "ssh-ed25519 AAAAC3... [comment]")
38
44
  const parts = publicKey.trim().split(/\s+/);
39
45
  if (parts.length < 2) {
40
- throw new Error('Invalid SSH public key format');
46
+ throw new InvalidSSHConfigurationError();
41
47
  }
42
48
  const keyData = parts[1]; // Base64-encoded key data
43
49
  const buffer = Buffer.from(keyData, 'base64');
@@ -45,6 +51,12 @@ export function computeSSHKeyFingerprint(publicKey: string): string {
45
51
  return `SHA256:${fingerprint.replace(/=+$/, '')}`;
46
52
  }
47
53
 
54
+ const AddSSHKeyError = StructuredError('AddSSHKeyError');
55
+ const AddSSHKeyUnexpectedError = StructuredError(
56
+ 'AddSSHKeyUnexpectedError',
57
+ 'An unexpected error was received from the server.'
58
+ );
59
+
48
60
  export async function addSSHKey(apiClient: APIClient, publicKey: string): Promise<AddSSHKeyResult> {
49
61
  const resp = await apiClient.request(
50
62
  'POST',
@@ -54,16 +66,18 @@ export async function addSSHKey(apiClient: APIClient, publicKey: string): Promis
54
66
  );
55
67
 
56
68
  if (!resp.success) {
57
- throw new Error(resp.message);
69
+ throw new AddSSHKeyError({ message: resp.message });
58
70
  }
59
71
 
60
72
  if (!resp.data) {
61
- throw new Error('No data returned from server');
73
+ throw new AddSSHKeyUnexpectedError();
62
74
  }
63
75
 
64
76
  return resp.data;
65
77
  }
66
78
 
79
+ const ListSSHKeysError = StructuredError('ListSSHKeysError');
80
+
67
81
  export async function listSSHKeys(apiClient: APIClient): Promise<SSHKey[]> {
68
82
  const resp = await apiClient.request(
69
83
  'GET',
@@ -72,12 +86,14 @@ export async function listSSHKeys(apiClient: APIClient): Promise<SSHKey[]> {
72
86
  );
73
87
 
74
88
  if (!resp.success) {
75
- throw new Error(resp.message);
89
+ throw new ListSSHKeysError({ message: resp.message });
76
90
  }
77
91
 
78
92
  return resp.data ?? [];
79
93
  }
80
94
 
95
+ const RemoveSSHKeysError = StructuredError('RemoveSSHKeysError');
96
+
81
97
  export async function removeSSHKey(apiClient: APIClient, fingerprint: string): Promise<boolean> {
82
98
  const resp = await apiClient.request(
83
99
  'DELETE',
@@ -87,7 +103,7 @@ export async function removeSSHKey(apiClient: APIClient, fingerprint: string): P
87
103
  );
88
104
 
89
105
  if (!resp.success) {
90
- throw new Error(resp.message);
106
+ throw new RemoveSSHKeysError({ message: resp.message });
91
107
  }
92
108
 
93
109
  return resp.data?.removed ?? false;
package/src/cmd/auth/ssh/delete.ts CHANGED
@@ -21,10 +21,10 @@ export const deleteCommand = createSubcommand({
21
21
  requires: { apiClient: true, auth: true },
22
22
  idempotent: false,
23
23
  examples: [
24
- getCommand('auth ssh delete'),
25
- getCommand('auth ssh delete <fingerprint>'),
26
- getCommand('--explain auth ssh delete abc123'),
27
- getCommand('--dry-run auth ssh delete abc123'),
24
+ { command: getCommand('auth ssh delete'), description: 'Delete item' },
25
+ { command: getCommand('auth ssh delete <fingerprint>'), description: 'Delete item' },
26
+ { command: getCommand('--explain auth ssh delete abc123'), description: 'Delete item' },
27
+ { command: getCommand('--dry-run auth ssh delete abc123'), description: 'Delete item' },
28
28
  ],
29
29
  schema: {
30
30
  args: z.object({
package/src/cmd/auth/ssh/index.ts CHANGED
@@ -2,10 +2,15 @@ import { createCommand } from '../../../types';
2
2
  import { listCommand } from './list';
3
3
  import { addCommand } from './add';
4
4
  import { deleteCommand } from './delete';
5
+ import { getCommand } from '../../../command-prefix';
5
6
 
6
7
  export const sshSubcommand = createCommand({
7
8
  name: 'ssh',
8
9
  description: 'Manage SSH keys',
9
10
  tags: ['fast', 'requires-auth'],
11
+ examples: [
12
+ { command: getCommand('auth ssh list'), description: 'List all SSH keys' },
13
+ { command: getCommand('auth ssh add'), description: 'Add a new SSH key' },
14
+ ],
10
15
  subcommands: [listCommand, addCommand, deleteCommand],
11
16
  });
package/src/cmd/auth/ssh/list.ts CHANGED
@@ -22,9 +22,9 @@ export const listCommand = createSubcommand({
22
22
  requires: { apiClient: true, auth: true },
23
23
  idempotent: true,
24
24
  examples: [
25
- getCommand('auth ssh list'),
26
- getCommand('auth ssh ls'),
27
- getCommand('--json auth ssh list'),
25
+ { command: getCommand('auth ssh list'), description: 'List items' },
26
+ { command: getCommand('auth ssh ls'), description: 'List items' },
27
+ { command: getCommand('--json auth ssh list'), description: 'Show output in JSON format' },
28
28
  ],
29
29
  schema: {
30
30
  response: SSHListResponseSchema,