@xano/sdk 1.0.20 → 1.0.22

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 (238) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +1 -1
  3. package/dist/{agent-file-refresh-MOEDX5OL.js → agent-file-refresh-LV5ZBJEW.js} +14 -14
  4. package/dist/{agent-skill-command-A4QEVNTP.js → agent-skill-command-NPWUUIKI.js} +47 -47
  5. package/dist/{ai-models-command-SN2UKVC5.js → ai-models-command-BVOVIC6C.js} +9 -9
  6. package/dist/{answer-shape-BCGPH73R.js → answer-shape-4HVMTHYM.js} +5 -5
  7. package/dist/{backend-dir-66VVLCUF.js → backend-dir-6S23WBVQ.js} +13 -13
  8. package/dist/{backend-slot-WSWAHL2W.js → backend-slot-FS7G67MV.js} +4 -4
  9. package/dist/bin.js +51 -48
  10. package/dist/{branch-6DBHVVUT.js → branch-EV4K6G2F.js} +9 -9
  11. package/dist/{branch-commands-KUEGS6XL.js → branch-commands-VZKHIPDP.js} +25 -25
  12. package/dist/bundle.d.ts +2 -2
  13. package/dist/{chunk-OG6WYZNA.js → chunk-2T73ZZEB.js} +5 -5
  14. package/dist/{chunk-C7KO5KKB.js → chunk-2XRO4TQP.js} +7 -6
  15. package/dist/{chunk-4QRDNBPY.js → chunk-3WPQOIE5.js} +2 -2
  16. package/dist/{chunk-DAXFWXSV.js → chunk-4EFBDSVU.js} +3 -3
  17. package/dist/{chunk-YRLSJBSY.js → chunk-4RE636YS.js} +47 -44
  18. package/dist/{chunk-4DVP42ZC.js → chunk-5MVSDE67.js} +2 -2
  19. package/dist/{chunk-TN7ZBZRW.js → chunk-5WCHWKLJ.js} +3 -3
  20. package/dist/{chunk-LZDH5COS.js → chunk-6H57HQFN.js} +3 -3
  21. package/dist/{chunk-EQ2KB5YF.js → chunk-6JOQSH5G.js} +4 -4
  22. package/dist/{chunk-JHAZK4RY.js → chunk-6VKDIKJI.js} +2 -2
  23. package/dist/{chunk-4PHCBKJI.js → chunk-7GE6FZVU.js} +7 -6
  24. package/dist/{chunk-FSHW3GQU.js → chunk-A2TTPUAG.js} +3 -3
  25. package/dist/{chunk-CP7OSHLK.js → chunk-A2YRUMSZ.js} +7 -7
  26. package/dist/{chunk-CPR2F3WN.js → chunk-A5IFOUCW.js} +4 -4
  27. package/dist/{chunk-QZ2PC6B7.js → chunk-ABC7LY6Q.js} +69 -3
  28. package/dist/{chunk-QBSSSKIC.js → chunk-AEEZIZ2A.js} +3 -3
  29. package/dist/{chunk-MAAQ4ZSN.js → chunk-ATEB3WHX.js} +49 -49
  30. package/dist/{chunk-E7YXNU57.js → chunk-ATRMTNSR.js} +4 -4
  31. package/dist/{chunk-X3LYWTZ5.js → chunk-BISPJIDL.js} +3 -3
  32. package/dist/{chunk-7Z43XRBL.js → chunk-BJFO44A3.js} +5 -5
  33. package/dist/{chunk-2VHEZDZZ.js → chunk-BQ7PALBF.js} +29 -29
  34. package/dist/{chunk-I5YD7QPI.js → chunk-BUNNVRO3.js} +41 -5
  35. package/dist/{chunk-5KSVMHFS.js → chunk-CUS54UAR.js} +3 -3
  36. package/dist/{chunk-ZCXWOGFL.js → chunk-CUVZ3RT5.js} +3 -3
  37. package/dist/{chunk-SVQMDVND.js → chunk-CZISUZJ6.js} +2 -2
  38. package/dist/{chunk-YSSAJQH4.js → chunk-E4I6DR7F.js} +3 -3
  39. package/dist/{chunk-3H765RXT.js → chunk-EAR66AGQ.js} +11 -8
  40. package/dist/{chunk-MGC5S6OE.js → chunk-ED6N6TMS.js} +23 -15
  41. package/dist/{chunk-TDSRZDQP.js → chunk-EFP5WRUV.js} +2 -2
  42. package/dist/{chunk-34OZQNKR.js → chunk-EPMDBGJ6.js} +4 -4
  43. package/dist/{chunk-HUXMRYUX.js → chunk-EU63V7YR.js} +3 -3
  44. package/dist/{chunk-KMXXOJL2.js → chunk-F7YI4K7J.js} +14 -14
  45. package/dist/{chunk-LLG33KGY.js → chunk-F7YMUAEI.js} +15 -15
  46. package/dist/{chunk-EPD5J3WA.js → chunk-FIVLDAIK.js} +3 -3
  47. package/dist/{chunk-DJ7JH4UE.js → chunk-FTGMEKYL.js} +7 -7
  48. package/dist/{chunk-KHX6VQ4M.js → chunk-FWGPIQMW.js} +2 -2
  49. package/dist/{chunk-G3ZUGFIS.js → chunk-GG4KEISG.js} +5 -5
  50. package/dist/{chunk-YFVD3LNL.js → chunk-HDY5IY5M.js} +2 -2
  51. package/dist/{chunk-5Z4WQQHC.js → chunk-HWD2Z72H.js} +2 -2
  52. package/dist/{chunk-IUBGFCJJ.js → chunk-IH6NGW5Z.js} +6 -6
  53. package/dist/{chunk-3OR2RCXJ.js → chunk-ILPZJJVY.js} +92 -82
  54. package/dist/{chunk-RVBDZMCC.js → chunk-IMU3T4B3.js} +60 -18
  55. package/dist/{chunk-RSWPVU6X.js → chunk-KSW6PW36.js} +8 -8
  56. package/dist/{chunk-BFM2P47R.js → chunk-KYZ6QCR3.js} +6 -6
  57. package/dist/{chunk-CJIXD67B.js → chunk-L37MTTU4.js} +6 -6
  58. package/dist/{chunk-EOWNLLLV.js → chunk-LAZUQLWU.js} +7 -6
  59. package/dist/{chunk-FMXPV5JI.js → chunk-LEODZXR7.js} +4 -4
  60. package/dist/{chunk-T6GI2AFJ.js → chunk-LJSYTEPF.js} +14 -14
  61. package/dist/{chunk-TEZKQQDT.js → chunk-LOXVHC7B.js} +8 -8
  62. package/dist/{chunk-CGLYG2VF.js → chunk-M3DIFMJX.js} +2 -2
  63. package/dist/{chunk-EJXJE2H3.js → chunk-MKZDHVVE.js} +46 -46
  64. package/dist/{chunk-3HK7VELD.js → chunk-MO4SSEPP.js} +2 -2
  65. package/dist/{chunk-M5GXZEX7.js → chunk-N5O76SCI.js} +4 -4
  66. package/dist/{chunk-5BLBX2Q5.js → chunk-NHGED6BY.js} +9 -9
  67. package/dist/{chunk-LMX4VE4H.js → chunk-NRFE7KLI.js} +4 -4
  68. package/dist/{chunk-C6ERQFEB.js → chunk-ODS5M4Y7.js} +5 -5
  69. package/dist/{chunk-6ODQ5GDZ.js → chunk-OI34XIHM.js} +2 -2
  70. package/dist/{chunk-52VELHIH.js → chunk-OT3DSWIT.js} +5 -5
  71. package/dist/{chunk-6TAYTKFM.js → chunk-P3G2Z2L3.js} +4 -4
  72. package/dist/{chunk-GUHJV7C5.js → chunk-Q25OESFL.js} +3 -3
  73. package/dist/{chunk-4Y3SWNPE.js → chunk-Q2ADIN5G.js} +2 -2
  74. package/dist/{chunk-PC7XEO7F.js → chunk-Q5VLI567.js} +2 -2
  75. package/dist/{chunk-CJ5WRCVE.js → chunk-Q6ZLVVJW.js} +5 -5
  76. package/dist/{chunk-WK5QDV25.js → chunk-QXGRUEU7.js} +3 -3
  77. package/dist/{chunk-CBACTYIC.js → chunk-RQ7EYCPF.js} +6 -6
  78. package/dist/{chunk-5ABAIJVV.js → chunk-TANRKGHA.js} +2 -2
  79. package/dist/{chunk-Z7IINILG.js → chunk-TSCO37LJ.js} +5 -5
  80. package/dist/{chunk-SQVETROU.js → chunk-TW64BHNV.js} +4 -4
  81. package/dist/{chunk-T6KQYCAU.js → chunk-TXA37G44.js} +3 -3
  82. package/dist/{chunk-UN73LNM5.js → chunk-U27YUJE2.js} +4 -4
  83. package/dist/{chunk-7J7YRAZB.js → chunk-U66T5MAB.js} +4 -4
  84. package/dist/{chunk-DORGB2Y2.js → chunk-UEY2ADOJ.js} +2 -2
  85. package/dist/{chunk-4GI22VPJ.js → chunk-UMQRDEZG.js} +4 -4
  86. package/dist/{chunk-RHH6SCB4.js → chunk-UO5ZFNIV.js} +4 -4
  87. package/dist/{chunk-BBFHZMQA.js → chunk-VBOCHX7Y.js} +2 -2
  88. package/dist/{chunk-VEA6EXJL.js → chunk-VEW3ESAC.js} +3 -3
  89. package/dist/{chunk-KNLPGIRY.js → chunk-VRDEZVLP.js} +7 -7
  90. package/dist/{chunk-6L32HAIP.js → chunk-VRHJTYBO.js} +2 -2
  91. package/dist/{chunk-6534P3VH.js → chunk-VZIGBEF4.js} +2 -2
  92. package/dist/{chunk-YAZEB255.js → chunk-WAUIPPMF.js} +2 -2
  93. package/dist/{chunk-HGUQIBYY.js → chunk-WHZJWZTF.js} +7 -7
  94. package/dist/{chunk-745NOWB7.js → chunk-WNDTIUTA.js} +4 -4
  95. package/dist/{chunk-52QAENY6.js → chunk-WYOQNVM2.js} +4 -4
  96. package/dist/{chunk-JXX2QXPP.js → chunk-X7BDJ6WU.js} +2 -2
  97. package/dist/{chunk-EME5G4YP.js → chunk-XGNYUZLW.js} +9 -8
  98. package/dist/{chunk-2SWJ3267.js → chunk-XJ7SRNW2.js} +21 -18
  99. package/dist/{chunk-P3WIMLG2.js → chunk-XNXZZU3W.js} +2 -2
  100. package/dist/{chunk-AD7YILOU.js → chunk-XTDSS57C.js} +8 -8
  101. package/dist/{chunk-OSMPI45P.js → chunk-XXVP7E62.js} +3 -3
  102. package/dist/{chunk-MKRREVNB.js → chunk-Y7TZZ6NW.js} +8 -2
  103. package/dist/{chunk-I52AKG2O.js → chunk-YDGBFJUA.js} +4 -4
  104. package/dist/{chunk-OQMXCNN7.js → chunk-YDZJN26I.js} +4 -4
  105. package/dist/{chunk-WAP5362D.js → chunk-YHENFBYW.js} +2 -2
  106. package/dist/{chunk-OAWBNCME.js → chunk-YLHAGHS6.js} +23 -23
  107. package/dist/{chunk-EBSJUSID.js → chunk-ZBAINZJB.js} +2 -2
  108. package/dist/{chunk-SWQA6SZI.js → chunk-ZCGGTZQY.js} +74 -78
  109. package/dist/{chunk-FVBJKM6N.js → chunk-ZV2AEGZA.js} +2 -2
  110. package/dist/cli.d.ts +3 -3
  111. package/dist/cli.js +46 -46
  112. package/dist/{codegen-command-GGGU6YAP.js → codegen-command-BLQBH3TH.js} +63 -63
  113. package/dist/codegen.d.ts +3 -3
  114. package/dist/{commands-EN4RLPOP.js → commands-VHQIAW5C.js} +3 -3
  115. package/dist/{completion-KH45QD3E.js → completion-6R3KZY4A.js} +3 -3
  116. package/dist/{config-AKHBFTKA.js → config-KGXHN3JU.js} +4 -4
  117. package/dist/{deploy-command-WOHYD22D.js → deploy-command-TID6CA7V.js} +53 -53
  118. package/dist/{deploy-source-QK7Y4Y3V.js → deploy-source-2XGWS4YS.js} +29 -29
  119. package/dist/{dev-env-sync-AMFPULCP.js → dev-env-sync-QJIIUU7R.js} +47 -47
  120. package/dist/{diagnostics-T3RN3372.js → diagnostics-EYMAH4DV.js} +2 -2
  121. package/dist/{display-name-hint-QMT562BI.js → display-name-hint-5UJ3HFXY.js} +11 -11
  122. package/dist/{emit-BfHifhJy.d.ts → emit-CezfsIMN.d.ts} +44 -6
  123. package/dist/{env-example-refresh-F5RTDVJ5.js → env-example-refresh-POWYBDLK.js} +64 -64
  124. package/dist/{env-pull-command-J2ARE33T.js → env-pull-command-7IZ6YGTU.js} +43 -43
  125. package/dist/{env-target-WA4BR6GW.js → env-target-KAVQVPDO.js} +10 -10
  126. package/dist/{env-var-command-WEC22FI5.js → env-var-command-Q5ZWB7GA.js} +39 -39
  127. package/dist/{ephemeral-MNHEWSZ6.js → ephemeral-XJO3TZCY.js} +9 -9
  128. package/dist/{ephemeral-command-EJLS42VJ.js → ephemeral-command-2P6K6LKO.js} +44 -44
  129. package/dist/{ephemeral-state-QTT5JHD5.js → ephemeral-state-X5HR4FAK.js} +8 -8
  130. package/dist/{generate-command-2WHFL4CB.js → generate-command-6EIPQUYK.js} +68 -68
  131. package/dist/{gitignore-OKB3X335.js → gitignore-KNOLQB42.js} +17 -17
  132. package/dist/{guards-N4PUFKN5.js → guards-6KAY65CV.js} +6 -6
  133. package/dist/{impersonate-command-EIWI3FBD.js → impersonate-command-2SZFKFTW.js} +35 -35
  134. package/dist/{import-7HFTOT7M.js → import-7TYP5VND.js} +5 -5
  135. package/dist/index.d.ts +8 -8
  136. package/dist/index.js +11 -11
  137. package/dist/{init-command-POIWZKZ4.js → init-command-25SUJRAE.js} +51 -51
  138. package/dist/{init-modules-S7BR4NIJ.js → init-modules-A73RV2OJ.js} +10 -10
  139. package/dist/{init-web-YCPD6BYN.js → init-web-KRQCA43B.js} +3 -3
  140. package/dist/internal.d.ts +6 -6
  141. package/dist/internal.js +18 -17
  142. package/dist/{keep-data-merge-NXP77QML.js → keep-data-merge-4QFPEJBN.js} +24 -24
  143. package/dist/{lambda-config-reconcile-CC5QIP6E.js → lambda-config-reconcile-GWEMI2PL.js} +3 -3
  144. package/dist/{landing-record-MK44WCRY.js → landing-record-4CZTNKZT.js} +19 -19
  145. package/dist/{live-diff-GZ6JUNP6.js → live-diff-CPFDW6T4.js} +5 -5
  146. package/dist/{local-engine-ai-3XLJLOBP.js → local-engine-ai-6FF34RSX.js} +11 -11
  147. package/dist/{local-engine-choice-7QBML5XF.js → local-engine-choice-P3GZBFTE.js} +37 -37
  148. package/dist/{local-engine-command-N7VDPABW.js → local-engine-command-A76ADITM.js} +43 -43
  149. package/dist/{local-engine-deploy-RYZZYEDQ.js → local-engine-deploy-SEPTWYYD.js} +18 -16
  150. package/dist/{local-engine-lookup-2VSUWEQY.js → local-engine-lookup-C6YIQY7S.js} +3 -3
  151. package/dist/{local-engine-mcp-bridge-ECGTK7LF.js → local-engine-mcp-bridge-HQDIYT26.js} +10 -7
  152. package/dist/{local-engine-mcp-command-A257D3WK.js → local-engine-mcp-command-4OXNZDCM.js} +46 -46
  153. package/dist/{local-engine-process-P5T2766M.js → local-engine-process-YHQTPIK2.js} +22 -12
  154. package/dist/{local-engine-release-OK6GKULS.js → local-engine-release-DV4NJS24.js} +6 -6
  155. package/dist/{local-engine-state-BOKHLNRQ.js → local-engine-state-QJRY4IVD.js} +2 -2
  156. package/dist/{local-engine-update-check-C72LSVUQ.js → local-engine-update-check-YJ655C6V.js} +5 -5
  157. package/dist/{lock-commands-KMWLIGT2.js → lock-commands-CSUAP3CZ.js} +51 -51
  158. package/dist/{login-command-E2KMN6DV.js → login-command-TE4CGIEZ.js} +25 -25
  159. package/dist/{logout-command-AIB446AQ.js → logout-command-YR2G5OIN.js} +13 -13
  160. package/dist/{loop-EMTBWN4X.js → loop-H44NE3R6.js} +5 -5
  161. package/dist/{marketplace-command-YLBFUBHL.js → marketplace-command-4N5IIDSA.js} +32 -32
  162. package/dist/{marketplace-resolve-LT76KHJD.js → marketplace-resolve-NSCLONXK.js} +8 -8
  163. package/dist/{meta-client-AOPF5IQN.js → meta-client-XEMGHUUK.js} +14 -13
  164. package/dist/{module-manifest-B432UFBK.js → module-manifest-FGT5VXFQ.js} +4 -4
  165. package/dist/node.d.ts +7 -7
  166. package/dist/node.js +51 -51
  167. package/dist/{operation-outcome-GBSISFAP.js → operation-outcome-D5QHO5LT.js} +21 -21
  168. package/dist/{output-target-NHJLT4YI.js → output-target-CYAPGP3A.js} +18 -18
  169. package/dist/{plan-disclosure-5HM7CMRW.js → plan-disclosure-MWMOGKX2.js} +16 -16
  170. package/dist/{plugin-contributions-MEXUR7TY.js → plugin-contributions-6FOQ7TWS.js} +5 -5
  171. package/dist/{plugin-prompt-XM4ATAWA.js → plugin-prompt-CP5EVTAD.js} +5 -5
  172. package/dist/{plugin-questions-VGU3B4LE.js → plugin-questions-5R3CBBNM.js} +4 -4
  173. package/dist/{preflight-command-O52GLYGA.js → preflight-command-WT4RIL5P.js} +57 -57
  174. package/dist/{profile-command-NOKUVV3M.js → profile-command-5RXNMDIX.js} +26 -26
  175. package/dist/{profile-pointer-DHOU26Q2.js → profile-pointer-UURS2P3M.js} +4 -4
  176. package/dist/{project-config-SGRYMHBT.js → project-config-2DVU3VV6.js} +6 -6
  177. package/dist/{project-dependency-WTH776QE.js → project-dependency-IEGZVZNO.js} +9 -9
  178. package/dist/{project-sdk-FYNY7RTO.js → project-sdk-ZYTIHEVU.js} +4 -4
  179. package/dist/promote-command-HOW24EMD.js +150 -0
  180. package/dist/{prompt-JVYQH4OR.js → prompt-H2XC5AR7.js} +4 -4
  181. package/dist/{publish-command-LB2XULJA.js → publish-command-E6F5D3FY.js} +56 -56
  182. package/dist/{pull-command-UVNPFY2E.js → pull-command-ZBJJ6MDT.js} +66 -66
  183. package/dist/{pull-superseded-7EZ7M54I.js → pull-superseded-2UECGKGU.js} +4 -4
  184. package/dist/{raw-where-CinW0keO.d.ts → raw-where-B8Bx158p.d.ts} +1 -1
  185. package/dist/{release-command-BGSDY3BE.js → release-command-65Z3VDBQ.js} +61 -61
  186. package/dist/{release-ns-command-IVXK7HEG.js → release-ns-command-CH23BRI3.js} +79 -79
  187. package/dist/{retry-command-HG4IFE65.js → retry-command-FXAPSP5X.js} +8 -8
  188. package/dist/{routes-manifest-N73THJB3.js → routes-manifest-SXKLGPSQ.js} +6 -6
  189. package/dist/{routes-manifest-file-3MDX3JB3.js → routes-manifest-file-NAXVFRVN.js} +9 -9
  190. package/dist/scaffold.js +2 -2
  191. package/dist/{secrets-file-NFNUKRGZ.js → secrets-file-KKGISTCY.js} +17 -17
  192. package/dist/{secrets-fill-command-U5L7IKUO.js → secrets-fill-command-R3JTP2VN.js} +50 -50
  193. package/dist/{seed-M33F4OJW.js → seed-WQJYWO3I.js} +6 -6
  194. package/dist/{source-resolve-MAMVIHDF.js → source-resolve-TS2CWDZ6.js} +19 -19
  195. package/dist/{static-host-HCKD26Q3.js → static-host-K4YVJQNR.js} +5 -5
  196. package/dist/{status-command-VXIN37ET.js → status-command-FWE65NQQ.js} +36 -36
  197. package/dist/{store-Dt-5vOSe.d.ts → store-CscLDS9B.d.ts} +3 -3
  198. package/dist/{store-ZWQFSXH5.js → store-UIIOQ4G3.js} +6 -6
  199. package/dist/{sync-baseline-XLRJQZCS.js → sync-baseline-6J7SQUPN.js} +6 -6
  200. package/dist/{sync-contributions-PGMYJKLG.js → sync-contributions-MV7UXGUN.js} +12 -12
  201. package/dist/{sync-record-UFEJDNLR.js → sync-record-ASVPKPKZ.js} +10 -10
  202. package/dist/{table-JHPGUJ2Z.js → table-RYGYFUV6.js} +8 -8
  203. package/dist/{tables-command-FNBHVJG3.js → tables-command-W3KSMKYR.js} +36 -36
  204. package/dist/{tenant-SSWC7B3V.js → tenant-C7TDXCIN.js} +10 -10
  205. package/dist/{tenant-command-PHNX3PXS.js → tenant-command-ZPNAY7AM.js} +83 -83
  206. package/dist/{test-command-DMMF3RMK.js → test-command-7Z5F5SKW.js} +34 -34
  207. package/dist/{tests-ZFQWDWS2.js → tests-6OXEGO3H.js} +6 -6
  208. package/dist/{token-IHOPB74T.js → token-UPSKG3BH.js} +9 -9
  209. package/dist/{toolchain-hooks-IRPM6LYL.js → toolchain-hooks-GST2SEDT.js} +8 -8
  210. package/dist/{toolchain-modules-V56JXU2E.js → toolchain-modules-V7AOUVZ3.js} +8 -8
  211. package/dist/{toolchain-peers-NOIM44ED.js → toolchain-peers-7PXXNC4P.js} +10 -10
  212. package/dist/{tracked-backend-VKWZKKBG.js → tracked-backend-CCBFWEJV.js} +32 -32
  213. package/dist/{update-check-DZ4YVDNS.js → update-check-D7EVYWDB.js} +49 -49
  214. package/dist/{upgrade-command-EP5WQWFA.js → upgrade-command-7AJQ265B.js} +52 -52
  215. package/dist/{whoami-command-UV6EEDBY.js → whoami-command-LNFEE5XP.js} +12 -12
  216. package/dist/{workspace-6LVJ3LZE.js → workspace-KNMGO3LZ.js} +5 -5
  217. package/dist/{workspace-binding-AUZIERMF.js → workspace-binding-CEB7LD2Y.js} +11 -11
  218. package/dist/{workspace-command-VXOY6KPE.js → workspace-command-DY5K6A5L.js} +79 -79
  219. package/dist/{workspace-env-ZNGE3DFN.js → workspace-env-VPEHJVRV.js} +14 -14
  220. package/dist/{workspace-export-A4L6272C.js → workspace-export-O33G7GRU.js} +5 -5
  221. package/dist/{writable-762DMPHW.js → writable-YP3UI2XU.js} +4 -4
  222. package/dist/{xano-XZN5SRDH.js → xano-Y3J4S433.js} +7 -7
  223. package/dist/{xanosdk-import-FENZ7XMW.js → xanosdk-import-TC2YGIEJ.js} +6 -6
  224. package/dist/{xanosdk-project-K4RKLLNO.js → xanosdk-project-J5VAVLCA.js} +15 -15
  225. package/dist/{xdo-DNGZGO1j.d.ts → xdo-BEYX5ihv.d.ts} +2 -2
  226. package/guides/deploying.md +13 -4
  227. package/guides/environment.md +15 -0
  228. package/llms/kinds-agent-mcp.md +2 -2
  229. package/llms/kinds-core.md +1 -1
  230. package/llms/object-kinds.md +1 -1
  231. package/llms/tests.md +3 -2
  232. package/llms-full.txt +9 -8
  233. package/llms.txt +2 -2
  234. package/manifest.json +1 -1
  235. package/package.json +2 -39
  236. package/skills/xano-backend/SKILL.md +2 -2
  237. package/dist/.build-fingerprint +0 -1
  238. package/dist/promote-command-2NMTINVS.js +0 -150
@@ -10,8 +10,8 @@
10
10
  - `history?` is the server tier for its tools, prompts AND resources alike; an object's own `history` wins. The workspace tier (`workspaceConfig({ history })`) has `prompt` and `resource` keys, both default on.
11
11
  - `oauth?`: per-server sign-in; omit and nothing changes. Union on `mode`; `authTable` (REQUIRED, auth `table()` handle or name) is whose row the signed-in user is — `auth()` on the whole server, `t.auth` in its trigger. Hosted (the platform is the authorization server): `{ mode: "hosted", authTable, loginUrl }` — clients are sent to `loginUrl` (YOUR page, which is also the consent screen) with `mcp_request`; show `s.mcp.oauth.request`, sign the user in, then your endpoint calls `s.mcp.oauth.complete` with their `decision` and the page redirects to the URL it binds. External (your IdP issues tokens): `{ mode: "external", authTable, issuer, column, audience?, audienceAck?, claim?, claimAck?, preset?, allowedClientIds? }` — token `claim` (default `sub`) matched against `column`; `preset` is `auth0|clerk|workos|entra|okta|cognito|generic`. `loginUrl`/`issuer`/`audience` take `env("NAME")` (resolved per environment).
12
12
  - `export()` FAILS: hosted without `loginUrl` (`mcp.oauth-hosted-incomplete`); external without `issuer`/`column` (`mcp.oauth-external-incomplete`); `preset: "clerk"` without `allowedClientIds` (`mcp.oauth-preset-client-ids`); `claim` other than `sub`/`oid`/`email` without `claimAck` (`mcp.oauth-claim-unacked` — users can edit it at most providers). Unknown `mode`/`preset` THROWS, as do `consent`/`branding`/`trustedClients` (not options).
13
- - `prompt({ name, guid?, description?, docs?, title?, icons?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — an MCP prompt; takes `registerPrompts`. `input` is the prompt's arguments (each field's `description`/`required`/enum `values` reach the client; enum values also answer completion requests). `response`: a text value is ONE user message; a list of `{ role: "user" | "assistant", content }` is sent in order, `content` a string or an MCP content block: `s.set_var("m", obj({ list: [obj({ role: c.text("user"), content: ref("body") })] }))`, `response: ref("m.list")`. Without `response` or a top-level `s.return`, `prompts/get` fails.
14
- - `resource({ name, uri, guid?, description?, docs?, mimeType?, title?, icons?, annotations?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — an MCP resource; takes `registerResources`. Clients address it by `uri`, never `name`.
13
+ - `prompt({ name, guid?, description?, docs?, title?, icons?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — an MCP prompt; takes `registerPrompts`. `input` is the prompt's arguments (each field's `description`/`required`/enum `values` reach the client; enum values also answer completion requests). `response`: a text value is ONE user message; a list of `{ role: "user" | "assistant", content }` is sent in order, `content` a string or an MCP content block: `s.set_var("m", obj({ list: [obj({ role: c.text("user"), content: ref("body") })] }))`, `response: ref("m.list")`. Without `response` or a top-level `s.return`, `prompts/get` fails.
14
+ - `resource({ name, uri, guid?, description?, docs?, mimeType?, title?, icons?, annotations?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — an MCP resource; takes `registerResources`. Clients address it by `uri`, never `name`.
15
15
  - `uri`: a literal (`"docs://readme"`, no `input`) or an RFC 6570 LEVEL-1 template (`"orders://{region}/{order_id}"`). It must start with a scheme; each `{variable}` is letters/digits/`_`, one per brace pair, never two adjacent. `input` must be EXACTLY the template's variables, each a single `text`/`int`/`decimal`/`bool`/`enum`/`email`/`uuid` — anything else THROWS. A value that does not convert is refused before the stack runs.
16
16
  - `response`: a string is returned as text; non-UTF-8 content (a file, binary) as a base64 blob. `mimeType?` omitted → derived from what the stack returns.
17
17
  - Not found: a resource has no built-in miss path. Returning a `db.get` result straight through on a miss is an EMPTY SUCCESS — the client attaches an empty document (`text: ""`, `mimeType: "text/plain"`), not an error. Gate it: `s.precondition({ expr: expr(ref("note"), "!=", c.null()), error_type: "notfound", error: c.text("no such note") })` gives a real `resources/read` error (JSON-RPC `-32602`), but ⚠ the AUTHORED message is dropped — the client sees only the generic `Not Found` (unlike a `tool()` precondition).
@@ -43,7 +43,7 @@ to survive a rename).
43
43
  - `middleware({ name, guid?, description?, docs?, resultStrategy?, exceptionPolicy?, tags?, history?, input?, stack?, response?, responseShape?, tests? })` — a pre/post interceptor (function-like `stack`); attach it via a host's `middleware: { pre, post }`. ⚠ `input` ENCODES but an ATTACHED middleware never has it bound — the host request binds its own inputs, so `inp()` inside pre/post fails at runtime with `Unable to locate input` and a declared default does not stand in (`export()` warns). Read the request body with `s.util.get_all_input` instead; it yields a `{ type, vars }` envelope whose `vars` DIFFERS BY PHASE: `pre` → the request inputs (`payload.vars.<field>`); `post` → `{ status, result }`, the host's outcome (`payload.vars.result.<field>`; plus `payload` on an error). A request field read in `post` 500s after the host already ran (`export()` warns); read the request there with `s.util.get_raw_input`. `s.middleware.call` is the one path that DOES bind the declared map.
44
44
  - `resultStrategy?`: `"merge" | "replace"` (default `merge`) — how the middleware `response` folds into its phase's accumulator: in `post` the host's RESULT (changes what the CALLER receives), in `pre` the host's REQUEST INPUTS (changes what the HOST receives). `merge` folds key-by-key, `replace` substitutes wholesale; the next entry in the chain sees the updated value. `pre` + `replace` DISCARDS every caller input the middleware does not re-emit; reading a discarded input 500s, even one declared `required: false` (defaulting already ran).
45
45
  - `exceptionPolicy?`: `"silent" | "rethrow" | "critical"` (default `"rethrow"` — a throw ABORTS the request and surfaces the authored error/status). `"silent"` swallows the throw and admits the request; never use it on a guard. `"critical"` is `"rethrow"` plus skipping the `post` chain.
46
- - `tool({ name, guid?, description?, instructions?, docs?, enabled?, title?, annotations?, icons?, output?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — a function-like operation (`input`/`stack`/`response`) that a toolset (MCP server or agent) exposes. Register it, then reference it from a toolset's `tools`. Name charset as a query's (`A-Za-z0-9_-/{}`, max 200). `instructions` is the description the MODEL/client sees (MCP `description`, agent-tool description) and what a connection trigger rewrites; it REPLACES `description`, which shows only when `instructions` is empty (both set warns `tool.description-shadowed`). `title`/`annotations`/`icons`/`output` are MCP metadata (`llms/kinds-agent-mcp.md`).
46
+ - `tool({ name, guid?, description?, instructions?, docs?, enabled?, title?, annotations?, icons?, output?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — a function-like operation (`input`/`stack`/`response`) that a toolset (MCP server or agent) exposes. Register it, then reference it from a toolset's `tools`. Name charset as a query's (`A-Za-z0-9_-/{}`, max 200). `instructions` is the description the MODEL/client sees (MCP `description`, agent-tool description) and what a connection trigger rewrites; it REPLACES `description`, which shows only when `instructions` is empty (both set warns `tool.description-shadowed`). `title`/`annotations`/`icons`/`output` are MCP metadata (`llms/kinds-agent-mcp.md`).
47
47
  - An addon is a single table-bound db query, NOT a statement stack: `addon({ name, table, tableAlias?, where?, sort?, output: [cols], cardinality?: "single"|"list"|"count"|"exists"|"aggregate", group?, eval?, input?, context? })`, registered via `registerAddons([...])`.
48
48
  - `table` auto-fills the `context.dbo` binding. ⚠ Never author `table: null` — that is a BROKEN table-less addon returning nothing; `codegen` emits it only for an already-broken pulled object.
49
49
  - `tableAlias` is its SQL alias (`context.dbo.as`), qualifying `where`/`sort` columns (`col("merchant.id")`).
@@ -13,7 +13,7 @@ Choose by who or what starts the work.
13
13
  - **AI.** An LLM running inside the backend → `agent()`, started from a stack with `s.ai.agent.run`; it has no public endpoint. An external AI client (Claude, Cursor, any MCP client) calling the backend → `mcpServer()`. Standing instructions for Xano's own builder AI → `knowledge()` (who reads it: `llms/kinds-knowledge.md`). The actions either one calls → `tool()`. What an MCP server serves besides tools (`prompt()`, `resource()`) and when each fits: `llms/kinds-agent-mcp.md`.
14
14
  - **Pushing to connected clients** → `realtimeServer` → `realtimeChannel` → `realtimeMessage` (the handler for a frame a client sends — the realtime analogue of a query). A server-side push from any stack is `s.realtime.publish`; a client polling a `query` is the substitute this replaces.
15
15
  - **Code the typed surface cannot express** → a lambda (`s.lambda`, `fl.lambda`) for a short JavaScript body, LAST, after native filters and expressions (`llms/lambda.md`); a `microservice` for a long-running container or another language; `s.api.request` for a service that already has an HTTP API.
16
- - **Tests** → `tests` on a `query`/`defineFunction`/`middleware` for that one object's input → output; a `workflowTest` for a flow across objects (`s.function.call`, `s.api.call`, `s.task.call`) asserted with `s.expect.*`.
16
+ - **Tests** → `tests` on a `query`/`defineFunction`/`middleware`/`tool`/`prompt`/`resource` for that one object's input → output; a `workflowTest` for a flow across objects (`s.function.call`, `s.api.call`, `s.task.call`) asserted with `s.expect.*`.
17
17
  - **Reacting to the platform** → `errorTrigger` (an error signature first seen, regressing, or marked fixed) and `workspaceTrigger` (branch new/merge/live). What one connection to an MCP server, agent, realtime server or channel may see or do → that object's connection trigger.
18
18
 
19
19
  Composing a workspace from modules: `registerTables(modules.flatMap((m) => m.tables))` does NOT typecheck — `flatMap` (and `.concat()`) binds its element type to the FIRST element, so later tables are checked against that one table's schema; the error names two unrelated columns, not the cause. Pass an array LITERAL (`registerTables([...a.tables, ...b.tables])`), or annotate the module array with the wide aliases `AnyTableDef` / `AnyQueryDef` / `AnyFunctionDef` / `AnyAddonDef`. Widening loses nothing: typing lives on the `table()`/`query()` handle passed to `s.db.*`.
package/llms/tests.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # Saved unit tests, assertions, and mocks
2
2
 
3
- > Read when authoring a `workflowTest()` stack, when a query/function/middleware carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
3
+ > Read when authoring a `workflowTest()` stack, when a query, function, middleware, tool, prompt or resource carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
4
4
 
5
5
  Named input sets run against one object, with assertions on its response — the tests the Xano editor shows. NOT `workflowTest()`, which is a standalone object with its own stack that calls other objects.
6
6
 
7
- - `tests?: TestDef[]` on `query()`, `defineFunction()`, and `middleware()`. No other kind stores them.
7
+ - `tests?: TestDef[]` on `query()`, `defineFunction()`, `middleware()`, `tool()`, `prompt()` and `resource()`. No other kind stores them.
8
8
  - `{ name, id?, description?, datasource?, input?, expect?, token? }`.
9
9
  - `name` is unique within the object and is the key a statement's `mock` resolves against; a duplicate throws.
10
10
  - `id` defaults to a derivation from the owning object plus the name. A pulled test carries the id Xano minted, emitted explicitly.
@@ -70,3 +70,4 @@ Isolation rules; each fails a correct test with a misleading message.
70
70
  - A failing suite exits 5; exit 6 when the suite could not be reached — retry it; a backend that can't be looked up exits 8 (see errors). Having no tests is success.
71
71
  - For CI: the exit code says THAT something failed, the JSON says WHICH. Progress goes to stderr; stdout carries one JSON document when not a terminal, or with `--json`. `run-all` and `run`: `{ kind, env, name, display, total, passed, failed, tests: [{ kind, name, qualified, object?, status: "pass"|"fail", message?, expectations?: [{ index, status, message? }], timing? }] }` (`message`: the first failure; `expectations`: a unit test's every expectation in order, `index` from 0; `env`: an ephemeral's or tenant's name; `name`: the backend's own, a Xano Engine's too; null if none), same keys on an empty suite. `list` is `{ kind, env, name, display, total, tests }`; `deploy --test` nests the run under `testRun`.
72
72
  - `npx @xano/sdk deploy ./index.ts --test` deploys and then runs the suite against what it just shipped. A failure exits 5 WITHOUT retracting the deploy — the environment is live either way.
73
+ - A `tool()`/`prompt()`/`resource()` test runs with the rest, qualified `tool:<name>/<test>` (`prompt:`, `resource:`). ⚠ A backend whose engine predates tests on these kinds lists none of them, so the suite passes without running them.
package/llms-full.txt CHANGED
@@ -1,4 +1,4 @@
1
- # xanosdk v1.0.20
1
+ # xanosdk v1.0.22
2
2
 
3
3
  > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
4
4
 
@@ -40,7 +40,7 @@ plain file read resolves them at the version you have.
40
40
  - [Consuming defs from a client](llms/client.md): Read when a frontend calls the deployed backend or imports a def — request types and zod schemas without the import, its cost, `window.XANO_HOST`, local dev, file URLs, a Node spot-check.
41
41
  - [Toolchain modules](llms/toolchain.md): Read when `package.json` has a `"xanosdk"` block or you run `npx @xano/sdk marketplace`.
42
42
  - [Error index](llms/errors.md): Read when a request, test, build, or pull fails with a message you did not write — the string, its cause, and where the fix is.
43
- - [Saved unit tests, assertions, and mocks](llms/tests.md): Read when authoring a `workflowTest()` stack, when a query/function/middleware carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
43
+ - [Saved unit tests, assertions, and mocks](llms/tests.md): Read when authoring a `workflowTest()` stack, when a query, function, middleware, tool, prompt or resource carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
44
44
  - [Agent and MCP def shapes](llms/kinds-agent-mcp.md): Read when building an MCP server (tools, prompts, resources) or an `agent()`.
45
45
  - [Knowledge def shape](llms/kinds-knowledge.md): Read when the workspace defines a `knowledge()` item.
46
46
  - [Realtime def shapes](llms/kinds-realtime.md): Read when the workspace defines a `realtimeServer()`, `realtimeChannel()`, or `realtimeMessage()` handler.
@@ -492,7 +492,7 @@ Choose by who or what starts the work.
492
492
  - **AI.** An LLM running inside the backend → `agent()`, started from a stack with `s.ai.agent.run`; it has no public endpoint. An external AI client (Claude, Cursor, any MCP client) calling the backend → `mcpServer()`. Standing instructions for Xano's own builder AI → `knowledge()` (who reads it: `llms/kinds-knowledge.md`). The actions either one calls → `tool()`. What an MCP server serves besides tools (`prompt()`, `resource()`) and when each fits: `llms/kinds-agent-mcp.md`.
493
493
  - **Pushing to connected clients** → `realtimeServer` → `realtimeChannel` → `realtimeMessage` (the handler for a frame a client sends — the realtime analogue of a query). A server-side push from any stack is `s.realtime.publish`; a client polling a `query` is the substitute this replaces.
494
494
  - **Code the typed surface cannot express** → a lambda (`s.lambda`, `fl.lambda`) for a short JavaScript body, LAST, after native filters and expressions (`llms/lambda.md`); a `microservice` for a long-running container or another language; `s.api.request` for a service that already has an HTTP API.
495
- - **Tests** → `tests` on a `query`/`defineFunction`/`middleware` for that one object's input → output; a `workflowTest` for a flow across objects (`s.function.call`, `s.api.call`, `s.task.call`) asserted with `s.expect.*`.
495
+ - **Tests** → `tests` on a `query`/`defineFunction`/`middleware`/`tool`/`prompt`/`resource` for that one object's input → output; a `workflowTest` for a flow across objects (`s.function.call`, `s.api.call`, `s.task.call`) asserted with `s.expect.*`.
496
496
  - **Reacting to the platform** → `errorTrigger` (an error signature first seen, regressing, or marked fixed) and `workspaceTrigger` (branch new/merge/live). What one connection to an MCP server, agent, realtime server or channel may see or do → that object's connection trigger.
497
497
 
498
498
  Composing a workspace from modules: `registerTables(modules.flatMap((m) => m.tables))` does NOT typecheck — `flatMap` (and `.concat()`) binds its element type to the FIRST element, so later tables are checked against that one table's schema; the error names two unrelated columns, not the cause. Pass an array LITERAL (`registerTables([...a.tables, ...b.tables])`), or annotate the module array with the wide aliases `AnyTableDef` / `AnyQueryDef` / `AnyFunctionDef` / `AnyAddonDef`. Widening loses nothing: typing lives on the `table()`/`query()` handle passed to `s.db.*`.
@@ -569,7 +569,7 @@ to survive a rename).
569
569
  - `middleware({ name, guid?, description?, docs?, resultStrategy?, exceptionPolicy?, tags?, history?, input?, stack?, response?, responseShape?, tests? })` — a pre/post interceptor (function-like `stack`); attach it via a host's `middleware: { pre, post }`. ⚠ `input` ENCODES but an ATTACHED middleware never has it bound — the host request binds its own inputs, so `inp()` inside pre/post fails at runtime with `Unable to locate input` and a declared default does not stand in (`export()` warns). Read the request body with `s.util.get_all_input` instead; it yields a `{ type, vars }` envelope whose `vars` DIFFERS BY PHASE: `pre` → the request inputs (`payload.vars.<field>`); `post` → `{ status, result }`, the host's outcome (`payload.vars.result.<field>`; plus `payload` on an error). A request field read in `post` 500s after the host already ran (`export()` warns); read the request there with `s.util.get_raw_input`. `s.middleware.call` is the one path that DOES bind the declared map.
570
570
  - `resultStrategy?`: `"merge" | "replace"` (default `merge`) — how the middleware `response` folds into its phase's accumulator: in `post` the host's RESULT (changes what the CALLER receives), in `pre` the host's REQUEST INPUTS (changes what the HOST receives). `merge` folds key-by-key, `replace` substitutes wholesale; the next entry in the chain sees the updated value. `pre` + `replace` DISCARDS every caller input the middleware does not re-emit; reading a discarded input 500s, even one declared `required: false` (defaulting already ran).
571
571
  - `exceptionPolicy?`: `"silent" | "rethrow" | "critical"` (default `"rethrow"` — a throw ABORTS the request and surfaces the authored error/status). `"silent"` swallows the throw and admits the request; never use it on a guard. `"critical"` is `"rethrow"` plus skipping the `post` chain.
572
- - `tool({ name, guid?, description?, instructions?, docs?, enabled?, title?, annotations?, icons?, output?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — a function-like operation (`input`/`stack`/`response`) that a toolset (MCP server or agent) exposes. Register it, then reference it from a toolset's `tools`. Name charset as a query's (`A-Za-z0-9_-/{}`, max 200). `instructions` is the description the MODEL/client sees (MCP `description`, agent-tool description) and what a connection trigger rewrites; it REPLACES `description`, which shows only when `instructions` is empty (both set warns `tool.description-shadowed`). `title`/`annotations`/`icons`/`output` are MCP metadata (`llms/kinds-agent-mcp.md`).
572
+ - `tool({ name, guid?, description?, instructions?, docs?, enabled?, title?, annotations?, icons?, output?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — a function-like operation (`input`/`stack`/`response`) that a toolset (MCP server or agent) exposes. Register it, then reference it from a toolset's `tools`. Name charset as a query's (`A-Za-z0-9_-/{}`, max 200). `instructions` is the description the MODEL/client sees (MCP `description`, agent-tool description) and what a connection trigger rewrites; it REPLACES `description`, which shows only when `instructions` is empty (both set warns `tool.description-shadowed`). `title`/`annotations`/`icons`/`output` are MCP metadata (`llms/kinds-agent-mcp.md`).
573
573
  - An addon is a single table-bound db query, NOT a statement stack: `addon({ name, table, tableAlias?, where?, sort?, output: [cols], cardinality?: "single"|"list"|"count"|"exists"|"aggregate", group?, eval?, input?, context? })`, registered via `registerAddons([...])`.
574
574
  - `table` auto-fills the `context.dbo` binding. ⚠ Never author `table: null` — that is a BROKEN table-less addon returning nothing; `codegen` emits it only for an already-broken pulled object.
575
575
  - `tableAlias` is its SQL alias (`context.dbo.as`), qualifying `where`/`sort` columns (`col("merchant.id")`).
@@ -834,11 +834,11 @@ A failure document's `exitCode` matches.
834
834
 
835
835
  # Saved unit tests, assertions, and mocks
836
836
 
837
- > Read when authoring a `workflowTest()` stack, when a query/function/middleware carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
837
+ > Read when authoring a `workflowTest()` stack, when a query, function, middleware, tool, prompt or resource carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
838
838
 
839
839
  Named input sets run against one object, with assertions on its response — the tests the Xano editor shows. NOT `workflowTest()`, which is a standalone object with its own stack that calls other objects.
840
840
 
841
- - `tests?: TestDef[]` on `query()`, `defineFunction()`, and `middleware()`. No other kind stores them.
841
+ - `tests?: TestDef[]` on `query()`, `defineFunction()`, `middleware()`, `tool()`, `prompt()` and `resource()`. No other kind stores them.
842
842
  - `{ name, id?, description?, datasource?, input?, expect?, token? }`.
843
843
  - `name` is unique within the object and is the key a statement's `mock` resolves against; a duplicate throws.
844
844
  - `id` defaults to a derivation from the owning object plus the name. A pulled test carries the id Xano minted, emitted explicitly.
@@ -904,6 +904,7 @@ Isolation rules; each fails a correct test with a misleading message.
904
904
  - A failing suite exits 5; exit 6 when the suite could not be reached — retry it; a backend that can't be looked up exits 8 (see errors). Having no tests is success.
905
905
  - For CI: the exit code says THAT something failed, the JSON says WHICH. Progress goes to stderr; stdout carries one JSON document when not a terminal, or with `--json`. `run-all` and `run`: `{ kind, env, name, display, total, passed, failed, tests: [{ kind, name, qualified, object?, status: "pass"|"fail", message?, expectations?: [{ index, status, message? }], timing? }] }` (`message`: the first failure; `expectations`: a unit test's every expectation in order, `index` from 0; `env`: an ephemeral's or tenant's name; `name`: the backend's own, a Xano Engine's too; null if none), same keys on an empty suite. `list` is `{ kind, env, name, display, total, tests }`; `deploy --test` nests the run under `testRun`.
906
906
  - `npx @xano/sdk deploy ./index.ts --test` deploys and then runs the suite against what it just shipped. A failure exits 5 WITHOUT retracting the deploy — the environment is live either way.
907
+ - A `tool()`/`prompt()`/`resource()` test runs with the rest, qualified `tool:<name>/<test>` (`prompt:`, `resource:`). ⚠ A backend whose engine predates tests on these kinds lists none of them, so the suite passes without running them.
907
908
 
908
909
  # Agent and MCP def shapes
909
910
 
@@ -917,8 +918,8 @@ Isolation rules; each fails a correct test with a misleading message.
917
918
  - `history?` is the server tier for its tools, prompts AND resources alike; an object's own `history` wins. The workspace tier (`workspaceConfig({ history })`) has `prompt` and `resource` keys, both default on.
918
919
  - `oauth?`: per-server sign-in; omit and nothing changes. Union on `mode`; `authTable` (REQUIRED, auth `table()` handle or name) is whose row the signed-in user is — `auth()` on the whole server, `t.auth` in its trigger. Hosted (the platform is the authorization server): `{ mode: "hosted", authTable, loginUrl }` — clients are sent to `loginUrl` (YOUR page, which is also the consent screen) with `mcp_request`; show `s.mcp.oauth.request`, sign the user in, then your endpoint calls `s.mcp.oauth.complete` with their `decision` and the page redirects to the URL it binds. External (your IdP issues tokens): `{ mode: "external", authTable, issuer, column, audience?, audienceAck?, claim?, claimAck?, preset?, allowedClientIds? }` — token `claim` (default `sub`) matched against `column`; `preset` is `auth0|clerk|workos|entra|okta|cognito|generic`. `loginUrl`/`issuer`/`audience` take `env("NAME")` (resolved per environment).
919
920
  - `export()` FAILS: hosted without `loginUrl` (`mcp.oauth-hosted-incomplete`); external without `issuer`/`column` (`mcp.oauth-external-incomplete`); `preset: "clerk"` without `allowedClientIds` (`mcp.oauth-preset-client-ids`); `claim` other than `sub`/`oid`/`email` without `claimAck` (`mcp.oauth-claim-unacked` — users can edit it at most providers). Unknown `mode`/`preset` THROWS, as do `consent`/`branding`/`trustedClients` (not options).
920
- - `prompt({ name, guid?, description?, docs?, title?, icons?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — an MCP prompt; takes `registerPrompts`. `input` is the prompt's arguments (each field's `description`/`required`/enum `values` reach the client; enum values also answer completion requests). `response`: a text value is ONE user message; a list of `{ role: "user" | "assistant", content }` is sent in order, `content` a string or an MCP content block: `s.set_var("m", obj({ list: [obj({ role: c.text("user"), content: ref("body") })] }))`, `response: ref("m.list")`. Without `response` or a top-level `s.return`, `prompts/get` fails.
921
- - `resource({ name, uri, guid?, description?, docs?, mimeType?, title?, icons?, annotations?, tags?, history?, input?, stack?, response?, responseShape?, middleware? })` — an MCP resource; takes `registerResources`. Clients address it by `uri`, never `name`.
921
+ - `prompt({ name, guid?, description?, docs?, title?, icons?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — an MCP prompt; takes `registerPrompts`. `input` is the prompt's arguments (each field's `description`/`required`/enum `values` reach the client; enum values also answer completion requests). `response`: a text value is ONE user message; a list of `{ role: "user" | "assistant", content }` is sent in order, `content` a string or an MCP content block: `s.set_var("m", obj({ list: [obj({ role: c.text("user"), content: ref("body") })] }))`, `response: ref("m.list")`. Without `response` or a top-level `s.return`, `prompts/get` fails.
922
+ - `resource({ name, uri, guid?, description?, docs?, mimeType?, title?, icons?, annotations?, tags?, history?, input?, stack?, response?, responseShape?, middleware?, tests? })` — an MCP resource; takes `registerResources`. Clients address it by `uri`, never `name`.
922
923
  - `uri`: a literal (`"docs://readme"`, no `input`) or an RFC 6570 LEVEL-1 template (`"orders://{region}/{order_id}"`). It must start with a scheme; each `{variable}` is letters/digits/`_`, one per brace pair, never two adjacent. `input` must be EXACTLY the template's variables, each a single `text`/`int`/`decimal`/`bool`/`enum`/`email`/`uuid` — anything else THROWS. A value that does not convert is refused before the stack runs.
923
924
  - `response`: a string is returned as text; non-UTF-8 content (a file, binary) as a base64 blob. `mimeType?` omitted → derived from what the stack returns.
924
925
  - Not found: a resource has no built-in miss path. Returning a `db.get` result straight through on a miss is an EMPTY SUCCESS — the client attaches an empty document (`text: ""`, `mimeType: "text/plain"`), not an error. Gate it: `s.precondition({ expr: expr(ref("note"), "!=", c.null()), error_type: "notfound", error: c.text("no such note") })` gives a real `resources/read` error (JSON-RPC `-32602`), but ⚠ the AUTHORED message is dropped — the client sees only the generic `Not Found` (unlike a `tool()` precondition).
package/llms.txt CHANGED
@@ -1,4 +1,4 @@
1
- # xanosdk v1.0.20
1
+ # xanosdk v1.0.22
2
2
 
3
3
  > TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.
4
4
 
@@ -40,7 +40,7 @@ plain file read resolves them at the version you have.
40
40
  - [Consuming defs from a client](llms/client.md): Read when a frontend calls the deployed backend or imports a def — request types and zod schemas without the import, its cost, `window.XANO_HOST`, local dev, file URLs, a Node spot-check.
41
41
  - [Toolchain modules](llms/toolchain.md): Read when `package.json` has a `"xanosdk"` block or you run `npx @xano/sdk marketplace`.
42
42
  - [Error index](llms/errors.md): Read when a request, test, build, or pull fails with a message you did not write — the string, its cause, and where the fix is.
43
- - [Saved unit tests, assertions, and mocks](llms/tests.md): Read when authoring a `workflowTest()` stack, when a query/function/middleware carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
43
+ - [Saved unit tests, assertions, and mocks](llms/tests.md): Read when authoring a `workflowTest()` stack, when a query, function, middleware, tool, prompt or resource carries `tests`, when a statement needs a `mock`, or when running a deployed environment's tests.
44
44
  - [Agent and MCP def shapes](llms/kinds-agent-mcp.md): Read when building an MCP server (tools, prompts, resources) or an `agent()`.
45
45
  - [Knowledge def shape](llms/kinds-knowledge.md): Read when the workspace defines a `knowledge()` item.
46
46
  - [Realtime def shapes](llms/kinds-realtime.md): Read when the workspace defines a `realtimeServer()`, `realtimeChannel()`, or `realtimeMessage()` handler.
package/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xanosdk",
3
- "version": "1.0.20",
3
+ "version": "1.0.22",
4
4
  "description": "TypeScript SDK that compiles a typed Xano workspace into the importable packageExport JSON bundle.",
5
5
  "coverage": {
6
6
  "objectKinds": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xano/sdk",
3
- "version": "1.0.20",
3
+ "version": "1.0.22",
4
4
  "description": "The official TypeScript SDK for Xano, one platform to build, run and govern AI-built software. Your coding agent writes the backend in TypeScript, you run it on the Xano Engine on your machine, then deploy it to Xano.",
5
5
  "keywords": [
6
6
  "xanosdk",
@@ -92,44 +92,7 @@
92
92
  ],
93
93
  "scripts": {
94
94
  "build": "tsup",
95
- "codegen": "tsx scripts/codegen.ts",
96
- "codegen:ai-catalog": "tsx scripts/ai-catalog-snapshot.ts",
97
- "codegen:filters": "tsx scripts/codegen-filters.ts",
98
- "codegen:query-filters": "tsx scripts/codegen-query-filters.ts",
99
- "codegen:methods": "tsx scripts/codegen-field-methods.ts",
100
- "codegen:sweep": "tsx scripts/codegen-sweep.ts",
101
- "codegen:replay": "tsx scripts/codegen-replay.ts",
102
- "codegen:imports": "tsx scripts/codegen-imports.ts",
103
- "codegen:surface": "tsx scripts/codegen-surface.ts",
104
- "codegen:themes": "tsx scripts/gen-shadcn-themes.ts",
105
- "codegen:fonts": "tsx scripts/gen-shadcn-fonts.ts",
106
- "audit:spec-drift": "tsx scripts/spec-drift.ts",
107
- "audit:special-required": "tsx scripts/special-required.ts",
108
- "audit:engine-drift": "bash .github/scripts/engine-drift.sh",
109
- "audit:output-flag": "tsx scripts/audit-output-flag.ts",
110
- "audit:decode-coverage": "tsx scripts/audit-decode-coverage.ts",
111
- "audit:dts": "npm run build && tsx scripts/audit-dts.ts",
112
- "eval:skill-trigger": "tsx scripts/eval-skill-trigger.ts",
113
- "eval:skill-scenarios": "tsx scripts/eval-skill-scenarios.ts",
114
- "manifest": "tsx scripts/manifest.ts",
115
- "codes": "tsx scripts/codes.ts",
116
- "changelog": "tsx scripts/changelog.ts",
117
- "measure:llms": "tsx scripts/measure-llms.ts",
118
- "typecheck": "tsc --noEmit",
119
- "test": "vitest run",
120
- "test:watch": "vitest",
121
- "e2e:ephemeral": "bash scripts/e2e-ephemeral.sh",
122
- "e2e:local-engine": "bash scripts/e2e-local-engine.sh",
123
- "lint": "eslint .",
124
- "prepublishOnly": "npm run build",
125
- "prepack": "node scripts/check-dist.mjs",
126
- "release": "npm publish --access public",
127
- "release:beta": "npm version prerelease --preid=beta -m \"chore(release): %s\" && npm publish --tag beta --access public",
128
- "examples:index": "tsx scripts/gen-examples-index.ts",
129
- "examples:check": "npm run examples:index && tsc --noEmit -p examples/sandbox/tsconfig.json",
130
- "examples:statements": "tsx scripts/gen-examples.ts",
131
- "examples:filters": "tsx scripts/gen-filters.ts",
132
- "examples:gen": "tsx scripts/gen-examples.ts && tsx scripts/gen-filters.ts && tsx scripts/gen-examples-index.ts"
95
+ "typecheck": "tsc --noEmit"
133
96
  },
134
97
  "engines": {
135
98
  "node": ">=20"
@@ -14,8 +14,8 @@ description: >-
14
14
  FastAPI) unless the user asks for Xano.
15
15
  license: MIT
16
16
  metadata:
17
- xanosdk-version: "1.0.20"
18
- xanosdk-digest: "sha256:481384ba7086d5be536576c92f29d459e93ab6330ca8feca3b9a76650a2f6458"
17
+ xanosdk-version: "1.0.22"
18
+ xanosdk-digest: "sha256:61bedc91a3772125238639ae7d4f82003edd6b6fe8b106c3886c61f094cd27c9"
19
19
  ---
20
20
 
21
21
  # Xano backend
@@ -1 +0,0 @@
1
- f149162a2ee07de28b92d53906b0b0275dc094dc9e5ac3751db5cf20fe274d0a
@@ -1,150 +0,0 @@
1
- import {
2
- assertNoMergeFlags,
3
- derivedPromoteLabel,
4
- isDerivedPromoteLabel,
5
- reportNotRun,
6
- runPromoteCommand
7
- } from "./chunk-2VHEZDZZ.js";
8
- import "./chunk-TN7ZBZRW.js";
9
- import "./chunk-YRLSJBSY.js";
10
- import "./chunk-EJXJE2H3.js";
11
- import "./chunk-C6ERQFEB.js";
12
- import "./chunk-EPD5J3WA.js";
13
- import "./chunk-SVQMDVND.js";
14
- import "./chunk-MAAQ4ZSN.js";
15
- import "./chunk-DJ7JH4UE.js";
16
- import "./chunk-OSMPI45P.js";
17
- import "./chunk-YAZEB255.js";
18
- import "./chunk-BFM2P47R.js";
19
- import "./chunk-T6GI2AFJ.js";
20
- import "./chunk-KHX6VQ4M.js";
21
- import "./chunk-BBFHZMQA.js";
22
- import "./chunk-Z7IINILG.js";
23
- import "./chunk-X7IBJLAD.js";
24
- import "./chunk-SQVETROU.js";
25
- import "./chunk-7Z43XRBL.js";
26
- import "./chunk-AD7YILOU.js";
27
- import "./chunk-C7KO5KKB.js";
28
- import "./chunk-4PHCBKJI.js";
29
- import "./chunk-3DRXWLJ5.js";
30
- import "./chunk-X4DVXBFY.js";
31
- import "./chunk-G3ZUGFIS.js";
32
- import "./chunk-6L32HAIP.js";
33
- import "./chunk-2TFRR6JV.js";
34
- import "./chunk-P3WIMLG2.js";
35
- import "./chunk-34OZQNKR.js";
36
- import "./chunk-3OR2RCXJ.js";
37
- import "./chunk-ZCXWOGFL.js";
38
- import "./chunk-UN73LNM5.js";
39
- import "./chunk-KMXXOJL2.js";
40
- import "./chunk-5Z4WQQHC.js";
41
- import "./chunk-LLG33KGY.js";
42
- import "./chunk-JXX2QXPP.js";
43
- import "./chunk-6TAYTKFM.js";
44
- import "./chunk-4GI22VPJ.js";
45
- import "./chunk-I52AKG2O.js";
46
- import "./chunk-2MNLRIOX.js";
47
- import "./chunk-745NOWB7.js";
48
- import "./chunk-EBSJUSID.js";
49
- import "./chunk-TEZKQQDT.js";
50
- import "./chunk-CP7OSHLK.js";
51
- import "./chunk-DAXFWXSV.js";
52
- import "./chunk-MKRREVNB.js";
53
- import "./chunk-ZYJP6BOO.js";
54
- import "./chunk-FVZ5C3PF.js";
55
- import "./chunk-RQGSZ7AR.js";
56
- import "./chunk-LMX4VE4H.js";
57
- import "./chunk-7ZVQIKNL.js";
58
- import "./chunk-2H5BQRHF.js";
59
- import "./chunk-52VELHIH.js";
60
- import "./chunk-CGLYG2VF.js";
61
- import "./chunk-E7YXNU57.js";
62
- import "./chunk-QO6BVGS5.js";
63
- import "./chunk-TDSRZDQP.js";
64
- import "./chunk-PC7XEO7F.js";
65
- import "./chunk-622HUCZT.js";
66
- import "./chunk-4DVP42ZC.js";
67
- import "./chunk-OQMXCNN7.js";
68
- import "./chunk-EUUUMY7J.js";
69
- import "./chunk-5ABAIJVV.js";
70
- import "./chunk-4GPIOIAC.js";
71
- import "./chunk-X3LYWTZ5.js";
72
- import "./chunk-EQ2KB5YF.js";
73
- import "./chunk-CJIXD67B.js";
74
- import "./chunk-HU7F56VF.js";
75
- import "./chunk-7J7YRAZB.js";
76
- import "./chunk-ZFDZKNGG.js";
77
- import "./chunk-FWD7AL6N.js";
78
- import "./chunk-IUBGFCJJ.js";
79
- import "./chunk-37BT62SX.js";
80
- import "./chunk-4KHEMC32.js";
81
- import "./chunk-DNBP4GJN.js";
82
- import "./chunk-DORGB2Y2.js";
83
- import "./chunk-WAVNUTMT.js";
84
- import "./chunk-LZDH5COS.js";
85
- import "./chunk-LLNZGEFK.js";
86
- import "./chunk-4Y3SWNPE.js";
87
- import "./chunk-QZ2PC6B7.js";
88
- import "./chunk-Q4R2ABFL.js";
89
- import "./chunk-X2NL4KUO.js";
90
- import "./chunk-3HK7VELD.js";
91
- import "./chunk-O7Z3LF44.js";
92
- import "./chunk-6ODQ5GDZ.js";
93
- import "./chunk-RHH6SCB4.js";
94
- import "./chunk-LJM5CIY4.js";
95
- import "./chunk-7THDHQ4R.js";
96
- import "./chunk-3YW23UFH.js";
97
- import "./chunk-X5NF3ZXW.js";
98
- import "./chunk-6534P3VH.js";
99
- import "./chunk-MGC5S6OE.js";
100
- import "./chunk-52QAENY6.js";
101
- import "./chunk-GUHJV7C5.js";
102
- import "./chunk-EME5G4YP.js";
103
- import "./chunk-TPUAXIPR.js";
104
- import "./chunk-QDPY7RN3.js";
105
- import "./chunk-CJ5WRCVE.js";
106
- import "./chunk-4EVDCSEY.js";
107
- import "./chunk-RLQX6LHW.js";
108
- import "./chunk-U56HK2RG.js";
109
- import "./chunk-6SXKKDGF.js";
110
- import "./chunk-WAP5362D.js";
111
- import "./chunk-GSGDWJB5.js";
112
- import "./chunk-FSHW3GQU.js";
113
- import "./chunk-ERVIASGL.js";
114
- import "./chunk-JHAZK4RY.js";
115
- import "./chunk-H2V3N23D.js";
116
- import "./chunk-3JDU4VRL.js";
117
- import "./chunk-WTPZRR4I.js";
118
- import "./chunk-FMXPV5JI.js";
119
- import "./chunk-UTI5G6OJ.js";
120
- import "./chunk-VQDVEHDB.js";
121
- import "./chunk-5ZSO4T2G.js";
122
- import "./chunk-VQPDATQT.js";
123
- import "./chunk-UDZX2ZL4.js";
124
- import "./chunk-G6BEJ3NA.js";
125
- import "./chunk-F3JK5RIY.js";
126
- import "./chunk-TFFGOFVZ.js";
127
- import "./chunk-4ZV4MDKP.js";
128
- import "./chunk-EHP3WPEG.js";
129
- import "./chunk-XDIPEWLU.js";
130
- import "./chunk-7LLVSTXY.js";
131
- import "./chunk-EAZTRU75.js";
132
- import "./chunk-FTFAPKCW.js";
133
- import "./chunk-EUAU4QKI.js";
134
- import "./chunk-SIW2HT2H.js";
135
- import "./chunk-VAX3UZOY.js";
136
- import "./chunk-FTS42N37.js";
137
- import "./chunk-4BW2SG2N.js";
138
- import "./chunk-GE3JV5SI.js";
139
- import "./chunk-SGEOXJIH.js";
140
- import "./chunk-OHX6MIUZ.js";
141
- import "./chunk-36JUQZVQ.js";
142
- import "./chunk-PZ5AY32C.js";
143
- export {
144
- assertNoMergeFlags,
145
- derivedPromoteLabel,
146
- isDerivedPromoteLabel,
147
- reportNotRun,
148
- runPromoteCommand
149
- };
150
- //# sourceMappingURL=promote-command-2NMTINVS.js.map