digital-ai-testing-mcp 1.2.2

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 (333) hide show
  1. package/LICENSE +197 -0
  2. package/README.md +984 -0
  3. package/dist/api/agents.d.ts +5 -0
  4. package/dist/api/agents.d.ts.map +1 -0
  5. package/dist/api/agents.js +33 -0
  6. package/dist/api/agents.js.map +1 -0
  7. package/dist/api/applications.d.ts +35 -0
  8. package/dist/api/applications.d.ts.map +1 -0
  9. package/dist/api/applications.js +162 -0
  10. package/dist/api/applications.js.map +1 -0
  11. package/dist/api/backup.d.ts +4 -0
  12. package/dist/api/backup.d.ts.map +1 -0
  13. package/dist/api/backup.js +13 -0
  14. package/dist/api/backup.js.map +1 -0
  15. package/dist/api/browser-inspection.d.ts +33 -0
  16. package/dist/api/browser-inspection.d.ts.map +1 -0
  17. package/dist/api/browser-inspection.js +273 -0
  18. package/dist/api/browser-inspection.js.map +1 -0
  19. package/dist/api/browsers.d.ts +20 -0
  20. package/dist/api/browsers.d.ts.map +1 -0
  21. package/dist/api/browsers.js +31 -0
  22. package/dist/api/browsers.js.map +1 -0
  23. package/dist/api/client.d.ts +33 -0
  24. package/dist/api/client.d.ts.map +1 -0
  25. package/dist/api/client.js +200 -0
  26. package/dist/api/client.js.map +1 -0
  27. package/dist/api/device-groups.d.ts +15 -0
  28. package/dist/api/device-groups.d.ts.map +1 -0
  29. package/dist/api/device-groups.js +106 -0
  30. package/dist/api/device-groups.js.map +1 -0
  31. package/dist/api/devices.d.ts +32 -0
  32. package/dist/api/devices.d.ts.map +1 -0
  33. package/dist/api/devices.js +192 -0
  34. package/dist/api/devices.js.map +1 -0
  35. package/dist/api/license.d.ts +3 -0
  36. package/dist/api/license.d.ts.map +1 -0
  37. package/dist/api/license.js +11 -0
  38. package/dist/api/license.js.map +1 -0
  39. package/dist/api/nv-servers.d.ts +4 -0
  40. package/dist/api/nv-servers.d.ts.map +1 -0
  41. package/dist/api/nv-servers.js +20 -0
  42. package/dist/api/nv-servers.js.map +1 -0
  43. package/dist/api/projects.d.ts +36 -0
  44. package/dist/api/projects.d.ts.map +1 -0
  45. package/dist/api/projects.js +246 -0
  46. package/dist/api/projects.js.map +1 -0
  47. package/dist/api/provisioning-profiles.d.ts +7 -0
  48. package/dist/api/provisioning-profiles.d.ts.map +1 -0
  49. package/dist/api/provisioning-profiles.js +54 -0
  50. package/dist/api/provisioning-profiles.js.map +1 -0
  51. package/dist/api/regions.d.ts +4 -0
  52. package/dist/api/regions.d.ts.map +1 -0
  53. package/dist/api/regions.js +20 -0
  54. package/dist/api/regions.js.map +1 -0
  55. package/dist/api/reporter-projects.d.ts +3 -0
  56. package/dist/api/reporter-projects.d.ts.map +1 -0
  57. package/dist/api/reporter-projects.js +13 -0
  58. package/dist/api/reporter-projects.js.map +1 -0
  59. package/dist/api/reporting.d.ts +28 -0
  60. package/dist/api/reporting.d.ts.map +1 -0
  61. package/dist/api/reporting.js +340 -0
  62. package/dist/api/reporting.js.map +1 -0
  63. package/dist/api/repository.d.ts +17 -0
  64. package/dist/api/repository.d.ts.map +1 -0
  65. package/dist/api/repository.js +81 -0
  66. package/dist/api/repository.js.map +1 -0
  67. package/dist/api/reservations.d.ts +9 -0
  68. package/dist/api/reservations.d.ts.map +1 -0
  69. package/dist/api/reservations.js +72 -0
  70. package/dist/api/reservations.js.map +1 -0
  71. package/dist/api/sessions.d.ts +3 -0
  72. package/dist/api/sessions.d.ts.map +1 -0
  73. package/dist/api/sessions.js +12 -0
  74. package/dist/api/sessions.js.map +1 -0
  75. package/dist/api/test-views.d.ts +9 -0
  76. package/dist/api/test-views.d.ts.map +1 -0
  77. package/dist/api/test-views.js +77 -0
  78. package/dist/api/test-views.js.map +1 -0
  79. package/dist/api/transactions.d.ts +4 -0
  80. package/dist/api/transactions.d.ts.map +1 -0
  81. package/dist/api/transactions.js +28 -0
  82. package/dist/api/transactions.js.map +1 -0
  83. package/dist/api/usage-reports.d.ts +24 -0
  84. package/dist/api/usage-reports.d.ts.map +1 -0
  85. package/dist/api/usage-reports.js +47 -0
  86. package/dist/api/usage-reports.js.map +1 -0
  87. package/dist/api/users.d.ts +14 -0
  88. package/dist/api/users.d.ts.map +1 -0
  89. package/dist/api/users.js +77 -0
  90. package/dist/api/users.js.map +1 -0
  91. package/dist/api/webdriver.d.ts +97 -0
  92. package/dist/api/webdriver.d.ts.map +1 -0
  93. package/dist/api/webdriver.js +1183 -0
  94. package/dist/api/webdriver.js.map +1 -0
  95. package/dist/index.d.ts +3 -0
  96. package/dist/index.d.ts.map +1 -0
  97. package/dist/index.js +130 -0
  98. package/dist/index.js.map +1 -0
  99. package/dist/tools/agent-tools.d.ts +3 -0
  100. package/dist/tools/agent-tools.d.ts.map +1 -0
  101. package/dist/tools/agent-tools.js +74 -0
  102. package/dist/tools/agent-tools.js.map +1 -0
  103. package/dist/tools/application-tools.d.ts +3 -0
  104. package/dist/tools/application-tools.d.ts.map +1 -0
  105. package/dist/tools/application-tools.js +816 -0
  106. package/dist/tools/application-tools.js.map +1 -0
  107. package/dist/tools/backup-tools.d.ts +3 -0
  108. package/dist/tools/backup-tools.d.ts.map +1 -0
  109. package/dist/tools/backup-tools.js +33 -0
  110. package/dist/tools/backup-tools.js.map +1 -0
  111. package/dist/tools/boilerplate-tools.d.ts +9 -0
  112. package/dist/tools/boilerplate-tools.d.ts.map +1 -0
  113. package/dist/tools/boilerplate-tools.js +1365 -0
  114. package/dist/tools/boilerplate-tools.js.map +1 -0
  115. package/dist/tools/browser-tools.d.ts +3 -0
  116. package/dist/tools/browser-tools.d.ts.map +1 -0
  117. package/dist/tools/browser-tools.js +108 -0
  118. package/dist/tools/browser-tools.js.map +1 -0
  119. package/dist/tools/coverage-tools.d.ts +3 -0
  120. package/dist/tools/coverage-tools.d.ts.map +1 -0
  121. package/dist/tools/coverage-tools.js +148 -0
  122. package/dist/tools/coverage-tools.js.map +1 -0
  123. package/dist/tools/debug-tools.d.ts +3 -0
  124. package/dist/tools/debug-tools.d.ts.map +1 -0
  125. package/dist/tools/debug-tools.js +315 -0
  126. package/dist/tools/debug-tools.js.map +1 -0
  127. package/dist/tools/device-group-tools.d.ts +3 -0
  128. package/dist/tools/device-group-tools.d.ts.map +1 -0
  129. package/dist/tools/device-group-tools.js +284 -0
  130. package/dist/tools/device-group-tools.js.map +1 -0
  131. package/dist/tools/device-tools.d.ts +3 -0
  132. package/dist/tools/device-tools.d.ts.map +1 -0
  133. package/dist/tools/device-tools.js +757 -0
  134. package/dist/tools/device-tools.js.map +1 -0
  135. package/dist/tools/health-tools.d.ts +3 -0
  136. package/dist/tools/health-tools.d.ts.map +1 -0
  137. package/dist/tools/health-tools.js +368 -0
  138. package/dist/tools/health-tools.js.map +1 -0
  139. package/dist/tools/inspection-tools.d.ts +3 -0
  140. package/dist/tools/inspection-tools.d.ts.map +1 -0
  141. package/dist/tools/inspection-tools.js +1170 -0
  142. package/dist/tools/inspection-tools.js.map +1 -0
  143. package/dist/tools/meta-tools.d.ts +4 -0
  144. package/dist/tools/meta-tools.d.ts.map +1 -0
  145. package/dist/tools/meta-tools.js +412 -0
  146. package/dist/tools/meta-tools.js.map +1 -0
  147. package/dist/tools/nv-server-tools.d.ts +3 -0
  148. package/dist/tools/nv-server-tools.d.ts.map +1 -0
  149. package/dist/tools/nv-server-tools.js +67 -0
  150. package/dist/tools/nv-server-tools.js.map +1 -0
  151. package/dist/tools/performance-tools.d.ts +3 -0
  152. package/dist/tools/performance-tools.d.ts.map +1 -0
  153. package/dist/tools/performance-tools.js +295 -0
  154. package/dist/tools/performance-tools.js.map +1 -0
  155. package/dist/tools/project-tools.d.ts +3 -0
  156. package/dist/tools/project-tools.d.ts.map +1 -0
  157. package/dist/tools/project-tools.js +577 -0
  158. package/dist/tools/project-tools.js.map +1 -0
  159. package/dist/tools/prompt-tools.d.ts +3 -0
  160. package/dist/tools/prompt-tools.d.ts.map +1 -0
  161. package/dist/tools/prompt-tools.js +570 -0
  162. package/dist/tools/prompt-tools.js.map +1 -0
  163. package/dist/tools/provisioning-profile-tools.d.ts +3 -0
  164. package/dist/tools/provisioning-profile-tools.d.ts.map +1 -0
  165. package/dist/tools/provisioning-profile-tools.js +169 -0
  166. package/dist/tools/provisioning-profile-tools.js.map +1 -0
  167. package/dist/tools/region-tools.d.ts +3 -0
  168. package/dist/tools/region-tools.d.ts.map +1 -0
  169. package/dist/tools/region-tools.js +46 -0
  170. package/dist/tools/region-tools.js.map +1 -0
  171. package/dist/tools/reporting-tools.d.ts +3 -0
  172. package/dist/tools/reporting-tools.d.ts.map +1 -0
  173. package/dist/tools/reporting-tools.js +1105 -0
  174. package/dist/tools/reporting-tools.js.map +1 -0
  175. package/dist/tools/repository-tools.d.ts +3 -0
  176. package/dist/tools/repository-tools.d.ts.map +1 -0
  177. package/dist/tools/repository-tools.js +208 -0
  178. package/dist/tools/repository-tools.js.map +1 -0
  179. package/dist/tools/reservation-tools.d.ts +3 -0
  180. package/dist/tools/reservation-tools.d.ts.map +1 -0
  181. package/dist/tools/reservation-tools.js +199 -0
  182. package/dist/tools/reservation-tools.js.map +1 -0
  183. package/dist/tools/resources.d.ts +3 -0
  184. package/dist/tools/resources.d.ts.map +1 -0
  185. package/dist/tools/resources.js +91 -0
  186. package/dist/tools/resources.js.map +1 -0
  187. package/dist/tools/test-view-tools.d.ts +3 -0
  188. package/dist/tools/test-view-tools.d.ts.map +1 -0
  189. package/dist/tools/test-view-tools.js +242 -0
  190. package/dist/tools/test-view-tools.js.map +1 -0
  191. package/dist/tools/transaction-tools.d.ts +3 -0
  192. package/dist/tools/transaction-tools.d.ts.map +1 -0
  193. package/dist/tools/transaction-tools.js +391 -0
  194. package/dist/tools/transaction-tools.js.map +1 -0
  195. package/dist/tools/usage-report-tools.d.ts +3 -0
  196. package/dist/tools/usage-report-tools.d.ts.map +1 -0
  197. package/dist/tools/usage-report-tools.js +160 -0
  198. package/dist/tools/usage-report-tools.js.map +1 -0
  199. package/dist/tools/user-tools.d.ts +3 -0
  200. package/dist/tools/user-tools.d.ts.map +1 -0
  201. package/dist/tools/user-tools.js +279 -0
  202. package/dist/tools/user-tools.js.map +1 -0
  203. package/dist/tools/web-inspection-tools.d.ts +3 -0
  204. package/dist/tools/web-inspection-tools.d.ts.map +1 -0
  205. package/dist/tools/web-inspection-tools.js +416 -0
  206. package/dist/tools/web-inspection-tools.js.map +1 -0
  207. package/dist/tools/workflow-tools.d.ts +3 -0
  208. package/dist/tools/workflow-tools.d.ts.map +1 -0
  209. package/dist/tools/workflow-tools.js +1136 -0
  210. package/dist/tools/workflow-tools.js.map +1 -0
  211. package/dist/types/digital-ai.d.ts +691 -0
  212. package/dist/types/digital-ai.d.ts.map +1 -0
  213. package/dist/types/digital-ai.js +3 -0
  214. package/dist/types/digital-ai.js.map +1 -0
  215. package/dist/utils/csv.d.ts +6 -0
  216. package/dist/utils/csv.d.ts.map +1 -0
  217. package/dist/utils/csv.js +77 -0
  218. package/dist/utils/csv.js.map +1 -0
  219. package/dist/utils/destructive-guard.d.ts +2 -0
  220. package/dist/utils/destructive-guard.d.ts.map +1 -0
  221. package/dist/utils/destructive-guard.js +13 -0
  222. package/dist/utils/destructive-guard.js.map +1 -0
  223. package/dist/utils/device-resolver.d.ts +22 -0
  224. package/dist/utils/device-resolver.d.ts.map +1 -0
  225. package/dist/utils/device-resolver.js +69 -0
  226. package/dist/utils/device-resolver.js.map +1 -0
  227. package/dist/utils/download-command.d.ts +18 -0
  228. package/dist/utils/download-command.d.ts.map +1 -0
  229. package/dist/utils/download-command.js +54 -0
  230. package/dist/utils/download-command.js.map +1 -0
  231. package/dist/utils/locality.d.ts +9 -0
  232. package/dist/utils/locality.d.ts.map +1 -0
  233. package/dist/utils/locality.js +22 -0
  234. package/dist/utils/locality.js.map +1 -0
  235. package/dist/utils/output-format.d.ts +13 -0
  236. package/dist/utils/output-format.d.ts.map +1 -0
  237. package/dist/utils/output-format.js +13 -0
  238. package/dist/utils/output-format.js.map +1 -0
  239. package/dist/utils/pagination.d.ts +12 -0
  240. package/dist/utils/pagination.d.ts.map +1 -0
  241. package/dist/utils/pagination.js +24 -0
  242. package/dist/utils/pagination.js.map +1 -0
  243. package/dist/utils/path-guard.d.ts +17 -0
  244. package/dist/utils/path-guard.d.ts.map +1 -0
  245. package/dist/utils/path-guard.js +41 -0
  246. package/dist/utils/path-guard.js.map +1 -0
  247. package/dist/utils/performance-comparison.d.ts +53 -0
  248. package/dist/utils/performance-comparison.d.ts.map +1 -0
  249. package/dist/utils/performance-comparison.js +286 -0
  250. package/dist/utils/performance-comparison.js.map +1 -0
  251. package/dist/utils/performance-stats.d.ts +72 -0
  252. package/dist/utils/performance-stats.d.ts.map +1 -0
  253. package/dist/utils/performance-stats.js +124 -0
  254. package/dist/utils/performance-stats.js.map +1 -0
  255. package/dist/utils/profile-loader.d.ts +37 -0
  256. package/dist/utils/profile-loader.d.ts.map +1 -0
  257. package/dist/utils/profile-loader.js +80 -0
  258. package/dist/utils/profile-loader.js.map +1 -0
  259. package/dist/utils/response-formatter.d.ts +27 -0
  260. package/dist/utils/response-formatter.d.ts.map +1 -0
  261. package/dist/utils/response-formatter.js +493 -0
  262. package/dist/utils/response-formatter.js.map +1 -0
  263. package/dist/utils/timestamp.d.ts +12 -0
  264. package/dist/utils/timestamp.d.ts.map +1 -0
  265. package/dist/utils/timestamp.js +22 -0
  266. package/dist/utils/timestamp.js.map +1 -0
  267. package/dist/utils/tool-registry.d.ts +21 -0
  268. package/dist/utils/tool-registry.d.ts.map +1 -0
  269. package/dist/utils/tool-registry.js +137 -0
  270. package/dist/utils/tool-registry.js.map +1 -0
  271. package/dist/utils/upload-command.d.ts +20 -0
  272. package/dist/utils/upload-command.d.ts.map +1 -0
  273. package/dist/utils/upload-command.js +64 -0
  274. package/dist/utils/upload-command.js.map +1 -0
  275. package/dist/utils/usage-report-guard.d.ts +48 -0
  276. package/dist/utils/usage-report-guard.d.ts.map +1 -0
  277. package/dist/utils/usage-report-guard.js +88 -0
  278. package/dist/utils/usage-report-guard.js.map +1 -0
  279. package/dist/utils/usage-report-summary.d.ts +20 -0
  280. package/dist/utils/usage-report-summary.d.ts.map +1 -0
  281. package/dist/utils/usage-report-summary.js +48 -0
  282. package/dist/utils/usage-report-summary.js.map +1 -0
  283. package/dist/utils/version.d.ts +2 -0
  284. package/dist/utils/version.d.ts.map +1 -0
  285. package/dist/utils/version.js +24 -0
  286. package/dist/utils/version.js.map +1 -0
  287. package/package.json +73 -0
  288. package/resources/boilerplate/Android-Native/Java JUnit5/AndroidNative-oss.java +58 -0
  289. package/resources/boilerplate/Android-Native/Java JUnit5/AndroidNative.java +67 -0
  290. package/resources/boilerplate/Android-Native/Java JUnit5/gradle +10 -0
  291. package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +10 -0
  292. package/resources/boilerplate/Android-Native/Java JUnit5/maven +42 -0
  293. package/resources/boilerplate/Android-Native/Java JUnit5/maven-oss +42 -0
  294. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/AndroidNative.js +30 -0
  295. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/Shell +19 -0
  296. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/Shell-oss +19 -0
  297. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/package-oss.json +12 -0
  298. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/package.json +12 -0
  299. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/wdio-oss.conf.js +40 -0
  300. package/resources/boilerplate/Android-Native/NodeJS (WebDriver)/wdio.conf.js +44 -0
  301. package/resources/boilerplate/Android-Native/Python/AndroidNative-oss.py +49 -0
  302. package/resources/boilerplate/Android-Native/Python/AndroidNative.py +69 -0
  303. package/resources/boilerplate/Android-Native/Python/pip +2 -0
  304. package/resources/boilerplate/Android-Native/Python/pip-oss +1 -0
  305. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +58 -0
  306. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +67 -0
  307. package/resources/boilerplate/Android-Native/java TestNG/gradle +13 -0
  308. package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +13 -0
  309. package/resources/boilerplate/Android-Native/java TestNG/maven +42 -0
  310. package/resources/boilerplate/Android-Native/java TestNG/maven-oss +42 -0
  311. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/Shell-oss.txt +19 -0
  312. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/Shell.txt +19 -0
  313. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/iOSNative.js +30 -0
  314. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/package-oss.json +12 -0
  315. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/package.json +12 -0
  316. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/wdio-oss.conf.js +35 -0
  317. package/resources/boilerplate/iOS-Native/NodeJS (WebDriver)/wdio.conf.js +39 -0
  318. package/resources/boilerplate/iOS-Native/Python/iOSNative-oss.py +44 -0
  319. package/resources/boilerplate/iOS-Native/Python/iOSNative.py +62 -0
  320. package/resources/boilerplate/iOS-Native/Python/pip-oss.txt +1 -0
  321. package/resources/boilerplate/iOS-Native/Python/pip.txt +2 -0
  322. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle +10 -0
  323. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +10 -0
  324. package/resources/boilerplate/iOS-Native/java-JUnit5/iOSNative-oss.java +52 -0
  325. package/resources/boilerplate/iOS-Native/java-JUnit5/iOSNative.java +59 -0
  326. package/resources/boilerplate/iOS-Native/java-JUnit5/maven +42 -0
  327. package/resources/boilerplate/iOS-Native/java-JUnit5/maven-oss +42 -0
  328. package/resources/boilerplate/iOS-Native/java-TestNG/gradle +13 -0
  329. package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +13 -0
  330. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +52 -0
  331. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +59 -0
  332. package/resources/boilerplate/iOS-Native/java-TestNG/maven +42 -0
  333. package/resources/boilerplate/iOS-Native/java-TestNG/maven-oss +42 -0
@@ -0,0 +1,391 @@
1
+ import { z } from 'zod';
2
+ import { listTransactions, getTransaction } from '../api/transactions.js';
3
+ import { formatTransactionList, formatTransaction, } from '../utils/response-formatter.js';
4
+ import { applyMaxResults, appendTruncationNotice } from '../utils/pagination.js';
5
+ import { outputFormatParam, respond } from '../utils/output-format.js';
6
+ // Transaction endpoints work for all access levels. Cloud Admin sees all projects;
7
+ // project-level keys (Project Admin and Project User) see only their own project.
8
+ // Server-side filtering is CSRF-blocked; all filters are applied client-side.
9
+ export function registerTransactionTools(server) {
10
+ server.tool('list_transactions', 'List performance transaction records — instrumented segments of mobile test sessions ' +
11
+ 'that capture CPU, memory, battery, network, and Speed Index metrics between developer-marked start/end points. ' +
12
+ 'Use this for performance regression analysis: compare metrics across app versions, devices, or network profiles. ' +
13
+ 'SPEED INDEX is a composite visual-progress score (WebPageTest methodology — the integral of (1 − VisualCompletion(t)) ' +
14
+ 'over the render window), NOT a duration: a lower value means content was visible more completely earlier in the ' +
15
+ 'render window. Do not read a Speed Index delta as "rendered N ms sooner". ' +
16
+ 'If these transactions were collected without a verified NV server connection (see list_nv_servers), Speed Index ' +
17
+ 'values may be invalid. ' +
18
+ 'Server-side filtering is not available; all filters are applied client-side. ' +
19
+ 'All access levels — project keys see only their own project\'s transactions.', {
20
+ appName: z.string().optional().describe('Filter by app package/bundle name (case-insensitive substring match).'),
21
+ appVersion: z.string().optional().describe('Filter by app version string (case-insensitive substring match).'),
22
+ transactionName: z.string().optional().describe('Filter by transaction name (case-insensitive substring match, e.g. "Login", "Checkout").'),
23
+ deviceOs: z.enum(['Android', 'iOS']).optional().describe('Filter by device OS.'),
24
+ deviceName: z.string().optional().describe('Filter by device name (case-insensitive substring match).'),
25
+ networkProfile: z.string().optional().describe('Filter by network profile name (case-insensitive substring match). Empty string to find transactions with no network profile.'),
26
+ startDate: z.string().optional().describe('ISO 8601 start of date range (inclusive), e.g. "2026-01-01".'),
27
+ endDate: z.string().optional().describe('ISO 8601 end of date range (inclusive), e.g. "2026-06-01".'),
28
+ minDurationMs: z.number().optional().describe('Minimum transaction duration in milliseconds.'),
29
+ maxDurationMs: z.number().optional().describe('Maximum transaction duration in milliseconds.'),
30
+ projectId: z.number().int().optional().describe('Filter by project ID.'),
31
+ maxResults: z.number().optional().default(50).describe('Maximum number of results to return (default: 50).'),
32
+ outputFormat: outputFormatParam,
33
+ }, async ({ appName, appVersion, transactionName, deviceOs, deviceName, networkProfile, startDate, endDate, minDurationMs, maxDurationMs, projectId, maxResults, outputFormat }) => {
34
+ try {
35
+ let txs = await listTransactions();
36
+ if (appName) {
37
+ const q = appName.toLowerCase();
38
+ txs = txs.filter(t => t.appName.toLowerCase().includes(q));
39
+ }
40
+ if (appVersion) {
41
+ const q = appVersion.toLowerCase();
42
+ txs = txs.filter(t => t.appVersion.toLowerCase().includes(q));
43
+ }
44
+ if (transactionName) {
45
+ const q = transactionName.toLowerCase();
46
+ txs = txs.filter(t => t.name.toLowerCase().includes(q));
47
+ }
48
+ if (deviceOs) {
49
+ txs = txs.filter(t => t.deviceOs === deviceOs);
50
+ }
51
+ if (deviceName) {
52
+ const q = deviceName.toLowerCase();
53
+ txs = txs.filter(t => t.deviceName.toLowerCase().includes(q));
54
+ }
55
+ if (networkProfile !== undefined) {
56
+ if (networkProfile === '') {
57
+ txs = txs.filter(t => !t.networkProfile);
58
+ }
59
+ else {
60
+ const q = networkProfile.toLowerCase();
61
+ txs = txs.filter(t => t.networkProfile.toLowerCase().includes(q));
62
+ }
63
+ }
64
+ if (startDate) {
65
+ const start = new Date(startDate).getTime();
66
+ txs = txs.filter(t => new Date(t.startTime).getTime() >= start);
67
+ }
68
+ if (endDate) {
69
+ const end = new Date(endDate + 'T23:59:59Z').getTime();
70
+ txs = txs.filter(t => new Date(t.startTime).getTime() <= end);
71
+ }
72
+ if (minDurationMs !== undefined) {
73
+ txs = txs.filter(t => t.duration >= minDurationMs);
74
+ }
75
+ if (maxDurationMs !== undefined) {
76
+ txs = txs.filter(t => t.duration <= maxDurationMs);
77
+ }
78
+ if (projectId !== undefined) {
79
+ txs = txs.filter(t => t.projectId === projectId);
80
+ }
81
+ // Sort newest first by default
82
+ txs = [...txs].sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
83
+ const paged = applyMaxResults(txs, maxResults);
84
+ const structured = {
85
+ total: paged.total,
86
+ returned: paged.returned,
87
+ truncated: paged.truncated,
88
+ transactions: paged.items.map(t => ({
89
+ id: t.id,
90
+ name: t.name,
91
+ appName: t.appName,
92
+ appVersion: t.appVersion,
93
+ date: t.date,
94
+ startTime: t.startTime,
95
+ duration: t.duration,
96
+ deviceOs: t.deviceOs,
97
+ deviceVersion: t.deviceVersion,
98
+ deviceName: t.deviceName,
99
+ networkProfile: t.networkProfile,
100
+ cpuAvg: t.cpuAvg,
101
+ cpuMax: t.cpuMax,
102
+ memAvg: t.memAvg,
103
+ memMax: t.memMax,
104
+ batteryAvg: t.batteryAvg,
105
+ totalUploadedBytes: t.totalUploadedBytes,
106
+ totalDownloadedBytes: t.totalDownloadedBytes,
107
+ speedIndex: t.speedIndex,
108
+ testId: t.testId,
109
+ projectId: t.projectId,
110
+ })),
111
+ };
112
+ const humanText = appendTruncationNotice(`Found ${paged.total} transaction(s):\n\n${formatTransactionList(paged.items)}`, paged);
113
+ return respond(outputFormat, structured, humanText);
114
+ }
115
+ catch (e) {
116
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
117
+ }
118
+ });
119
+ server.tool('get_transaction', 'Get full details for a single performance transaction, including time-series sample arrays for CPU, memory, battery, ' +
120
+ 'and network metrics sampled throughout the transaction duration. Use this to drill into a specific transaction after ' +
121
+ 'identifying it via list_transactions. Works with all access levels.', {
122
+ transactionId: z.number().int().describe('Numeric transaction ID from list_transactions.'),
123
+ outputFormat: outputFormatParam,
124
+ }, async ({ transactionId, outputFormat }) => {
125
+ try {
126
+ const tx = await getTransaction(transactionId);
127
+ const structured = {
128
+ ...tx,
129
+ sampleCounts: {
130
+ cpu: tx.cpuSamples?.length ?? 0,
131
+ memory: tx.memorySamples?.length ?? 0,
132
+ battery: tx.batterySamples?.length ?? 0,
133
+ networkDownload: tx.networkDownloadSamples?.length ?? 0,
134
+ networkUpload: tx.networkUploadSamples?.length ?? 0,
135
+ },
136
+ };
137
+ return respond(outputFormat, structured, formatTransaction(tx));
138
+ }
139
+ catch (e) {
140
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
141
+ }
142
+ });
143
+ server.tool('get_transaction_performance_summary', 'Aggregate performance metrics across transactions for regression and hardware analysis. ' +
144
+ 'NOTE: avgCpuPct can legitimately exceed 100 on iOS — the platform reports CPU per-core ' +
145
+ '(e.g. 119% on a dual-core device running one core at 100% and one at 19%). This is expected ' +
146
+ 'and preserved as-is because it carries diagnostic value for identifying CPU saturation. ' +
147
+ 'groupBy controls what dimension is compared:\n' +
148
+ ' "appVersion" — compare how metrics changed across releases (regression testing)\n' +
149
+ ' "name" — find which transaction types (Login, Checkout, etc.) are slowest\n' +
150
+ ' "deviceModel" — compare Speed Index and CPU across device models (hardware analysis)\n' +
151
+ ' "deviceType" — compare PHONE vs TABLET performance\n' +
152
+ ' "deviceScreen" — compare by screen resolution\n' +
153
+ ' "deviceName" — compare by full device name\n' +
154
+ ' "networkProfile" — compare performance under different network conditions\n' +
155
+ 'Results are sorted by avgSpeedIndex descending so the worst-performing group appears first. ' +
156
+ 'avgSpeedIndex is a composite visual-progress score (area above the progressive-render curve), NOT elapsed time. ' +
157
+ 'Compare it directionally (lower is better) but do not interpret a delta as a shift in render-completion time. ' +
158
+ 'Accepts the same filters as list_transactions to scope the analysis. ' +
159
+ 'All access levels — project keys see only their own project\'s transactions.', {
160
+ groupBy: z
161
+ .enum(['appVersion', 'name', 'deviceModel', 'deviceType', 'deviceScreen', 'deviceName', 'networkProfile'])
162
+ .default('appVersion')
163
+ .describe('Dimension to group and aggregate by. Use "deviceModel" or "deviceType" for hardware comparison.'),
164
+ appName: z.string().optional().describe('Scope to this app (case-insensitive substring match).'),
165
+ appVersion: z.string().optional().describe('Scope to this app version (case-insensitive substring match). Useful with groupBy=deviceModel.'),
166
+ transactionName: z.string().optional().describe('Scope to transactions with this name (substring match).'),
167
+ deviceOs: z.enum(['Android', 'iOS']).optional().describe('Scope to one OS.'),
168
+ deviceName: z.string().optional().describe('Scope to a specific device (substring match).'),
169
+ networkProfile: z.string().optional().describe('Scope to a specific network profile.'),
170
+ startDate: z.string().optional().describe('ISO 8601 start of date range.'),
171
+ endDate: z.string().optional().describe('ISO 8601 end of date range.'),
172
+ outputFormat: outputFormatParam,
173
+ }, async ({ groupBy, appName, appVersion, transactionName, deviceOs, deviceName, networkProfile, startDate, endDate, outputFormat }) => {
174
+ try {
175
+ let txs = await listTransactions();
176
+ if (appName) {
177
+ const q = appName.toLowerCase();
178
+ txs = txs.filter(t => t.appName.toLowerCase().includes(q));
179
+ }
180
+ if (appVersion) {
181
+ const q = appVersion.toLowerCase();
182
+ txs = txs.filter(t => t.appVersion.toLowerCase().includes(q));
183
+ }
184
+ if (transactionName) {
185
+ const q = transactionName.toLowerCase();
186
+ txs = txs.filter(t => t.name.toLowerCase().includes(q));
187
+ }
188
+ if (deviceOs) {
189
+ txs = txs.filter(t => t.deviceOs === deviceOs);
190
+ }
191
+ if (deviceName) {
192
+ const q = deviceName.toLowerCase();
193
+ txs = txs.filter(t => t.deviceName.toLowerCase().includes(q));
194
+ }
195
+ if (networkProfile !== undefined) {
196
+ txs = networkProfile === '' ? txs.filter(t => !t.networkProfile) : txs.filter(t => t.networkProfile.toLowerCase().includes(networkProfile.toLowerCase()));
197
+ }
198
+ if (startDate) {
199
+ const start = new Date(startDate).getTime();
200
+ txs = txs.filter(t => new Date(t.startTime).getTime() >= start);
201
+ }
202
+ if (endDate) {
203
+ const end = new Date(endDate + 'T23:59:59Z').getTime();
204
+ txs = txs.filter(t => new Date(t.startTime).getTime() <= end);
205
+ }
206
+ if (txs.length === 0) {
207
+ return respond(outputFormat, { groups: [] }, 'No transactions match the specified filters.');
208
+ }
209
+ // Extract the grouping key from a transaction
210
+ const getKey = (t) => {
211
+ switch (groupBy) {
212
+ case 'appVersion': return t.appVersion || 'unknown';
213
+ case 'name': return t.name;
214
+ case 'deviceModel': return t.deviceModel || 'unknown';
215
+ case 'deviceType': return t.deviceType || 'unknown';
216
+ case 'deviceScreen': return t.deviceScreen || 'unknown';
217
+ case 'deviceName': return t.deviceName || 'unknown';
218
+ case 'networkProfile': return t.networkProfile || '(none)';
219
+ }
220
+ };
221
+ const groups = {};
222
+ for (const t of txs) {
223
+ const key = getKey(t);
224
+ if (!groups[key])
225
+ groups[key] = [];
226
+ groups[key].push(t);
227
+ }
228
+ const avg = (arr) => {
229
+ const nums = arr.filter((v) => v != null);
230
+ return nums.length ? nums.reduce((a, b) => a + b, 0) / nums.length : null;
231
+ };
232
+ const max = (arr) => {
233
+ const nums = arr.filter((v) => v != null);
234
+ return nums.length ? Math.max(...nums) : null;
235
+ };
236
+ const min = (arr) => {
237
+ const nums = arr.filter((v) => v != null);
238
+ return nums.length ? Math.min(...nums) : null;
239
+ };
240
+ const aggregated = Object.entries(groups)
241
+ .map(([key, group]) => ({
242
+ [groupBy]: key,
243
+ count: group.length,
244
+ avgSpeedIndex: avg(group.map(t => t.speedIndex)),
245
+ minSpeedIndex: min(group.map(t => t.speedIndex)),
246
+ maxSpeedIndex: max(group.map(t => t.speedIndex)),
247
+ avgDurationMs: avg(group.map(t => t.duration)),
248
+ maxDurationMs: max(group.map(t => t.duration)),
249
+ avgCpuPct: avg(group.map(t => t.cpuAvg)),
250
+ maxCpuPct: max(group.map(t => t.cpuMax)),
251
+ avgMemMB: avg(group.map(t => t.memAvg)),
252
+ maxMemMB: max(group.map(t => t.memMax)),
253
+ avgBatteryMW: avg(group.map(t => t.batteryAvg)),
254
+ totalUploadedBytes: group.reduce((s, t) => s + t.totalUploadedBytes, 0),
255
+ totalDownloadedBytes: group.reduce((s, t) => s + t.totalDownloadedBytes, 0),
256
+ }))
257
+ // Sort worst Speed Index first so regressions/outliers surface immediately
258
+ .sort((a, b) => (b.avgSpeedIndex ?? 0) - (a.avgSpeedIndex ?? 0));
259
+ const structured = { groupBy, totalTransactions: txs.length, groups: aggregated };
260
+ // Human-readable output
261
+ const label = {
262
+ appVersion: 'App Version', name: 'Transaction Name', deviceModel: 'Device Model',
263
+ deviceType: 'Device Type', deviceScreen: 'Screen Resolution',
264
+ deviceName: 'Device Name', networkProfile: 'Network Profile',
265
+ };
266
+ const lines = [
267
+ `📊 Performance Summary by ${label[groupBy]} (${txs.length} transactions across ${aggregated.length} groups)`,
268
+ ` Sorted by avg Speed Index (highest = slowest rendering first)\n`,
269
+ ];
270
+ for (const g of aggregated) {
271
+ const si = g.avgSpeedIndex != null ? `${g.avgSpeedIndex.toFixed(0)} SI` : 'n/a';
272
+ const siRange = g.minSpeedIndex != null && g.maxSpeedIndex != null
273
+ ? ` [${g.minSpeedIndex}–${g.maxSpeedIndex} SI]` : '';
274
+ const dur = g.avgDurationMs != null ? `${(g.avgDurationMs / 1000).toFixed(2)}s` : 'n/a';
275
+ const cpu = g.avgCpuPct != null ? `${g.avgCpuPct.toFixed(1)}%` : 'n/a';
276
+ const mem = g.avgMemMB != null ? `${g.avgMemMB.toFixed(0)}MB` : 'n/a';
277
+ lines.push(` ${g[groupBy]} (${g.count} runs)`);
278
+ lines.push(` Speed Index: ${si}${siRange} | Duration: ${dur} | CPU: ${cpu} | Mem: ${mem}`);
279
+ }
280
+ return respond(outputFormat, structured, lines.join('\n'));
281
+ }
282
+ catch (e) {
283
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
284
+ }
285
+ });
286
+ // ─── get_performance_trend ────────────────────────────────────────────────
287
+ server.tool('get_performance_trend', 'Show how performance metrics (Speed Index, CPU, memory, duration) change over time, ' +
288
+ 'bucketed by day, week, or month. Use this to detect sprint-over-sprint regressions, ' +
289
+ 'confirm that a performance fix held, or identify when a regression was introduced. ' +
290
+ 'Accepts the same filters as list_transactions. All access levels — project keys see only their own project\'s transactions.', {
291
+ bucketBy: z.enum(['day', 'week', 'month']).optional().default('week')
292
+ .describe('Time bucket size: "day", "week" (default), or "month".'),
293
+ lookbackDays: z.number().int().min(1).max(730).optional().default(90)
294
+ .describe('How many days back to analyse (default: 90).'),
295
+ appName: z.string().optional().describe('Scope to this app (substring match).'),
296
+ appVersion: z.string().optional().describe('Scope to this app version (substring match).'),
297
+ transactionName: z.string().optional().describe('Scope to transactions with this name.'),
298
+ deviceOs: z.enum(['Android', 'iOS']).optional().describe('Scope to one OS.'),
299
+ networkProfile: z.string().optional().describe('Scope to a specific network profile.'),
300
+ outputFormat: outputFormatParam,
301
+ }, async ({ bucketBy, lookbackDays, appName, appVersion, transactionName, deviceOs, networkProfile, outputFormat }) => {
302
+ try {
303
+ let txs = await listTransactions();
304
+ const cutoff = Date.now() - lookbackDays * 86400000;
305
+ txs = txs.filter(t => new Date(t.startTime ?? t.startTime).getTime() >= cutoff);
306
+ if (appName) {
307
+ const q = appName.toLowerCase();
308
+ txs = txs.filter(t => t.appName.toLowerCase().includes(q));
309
+ }
310
+ if (appVersion) {
311
+ const q = appVersion.toLowerCase();
312
+ txs = txs.filter(t => t.appVersion.toLowerCase().includes(q));
313
+ }
314
+ if (transactionName) {
315
+ const q = transactionName.toLowerCase();
316
+ txs = txs.filter(t => t.name.toLowerCase().includes(q));
317
+ }
318
+ if (deviceOs) {
319
+ txs = txs.filter(t => t.deviceOs === deviceOs);
320
+ }
321
+ if (networkProfile !== undefined) {
322
+ txs = networkProfile === ''
323
+ ? txs.filter(t => !t.networkProfile)
324
+ : txs.filter(t => t.networkProfile.toLowerCase().includes(networkProfile.toLowerCase()));
325
+ }
326
+ if (txs.length === 0) {
327
+ return respond(outputFormat, { buckets: [] }, `No transactions found in the last ${lookbackDays} days matching the specified filters.`);
328
+ }
329
+ const bucketKey = (iso) => {
330
+ const d = new Date(iso);
331
+ if (bucketBy === 'month')
332
+ return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`;
333
+ if (bucketBy === 'week') {
334
+ const day = d.getUTCDay() || 7;
335
+ const monday = new Date(d);
336
+ monday.setUTCDate(d.getUTCDate() - (day - 1));
337
+ return monday.toISOString().slice(0, 10);
338
+ }
339
+ return d.toISOString().slice(0, 10);
340
+ };
341
+ const buckets = {};
342
+ for (const t of txs) {
343
+ const key = bucketKey(t.startTime);
344
+ if (!buckets[key])
345
+ buckets[key] = { count: 0, speedIndex: [], duration: [], cpu: [], mem: [] };
346
+ const b = buckets[key];
347
+ b.count++;
348
+ if (t.speedIndex != null)
349
+ b.speedIndex.push(t.speedIndex);
350
+ if (t.duration != null)
351
+ b.duration.push(t.duration);
352
+ if (t.cpuAvg != null)
353
+ b.cpu.push(t.cpuAvg);
354
+ if (t.memAvg != null)
355
+ b.mem.push(t.memAvg);
356
+ }
357
+ const avgOf = (arr) => arr.length ? arr.reduce((a, b) => a + b, 0) / arr.length : null;
358
+ const fmt1 = (n, unit = '') => n == null ? 'n/a' : `${n.toFixed(1)}${unit}`;
359
+ const sorted = Object.entries(buckets).sort(([a], [b]) => a.localeCompare(b));
360
+ const structured = {
361
+ bucketBy, lookbackDays,
362
+ totalTransactions: txs.length,
363
+ buckets: sorted.map(([period, b]) => ({
364
+ period,
365
+ count: b.count,
366
+ avgSpeedIndex: avgOf(b.speedIndex) != null ? parseFloat(avgOf(b.speedIndex).toFixed(0)) : null,
367
+ avgDurationMs: avgOf(b.duration) != null ? parseFloat(avgOf(b.duration).toFixed(0)) : null,
368
+ avgCpuPct: avgOf(b.cpu) != null ? parseFloat(avgOf(b.cpu).toFixed(1)) : null,
369
+ avgMemMB: avgOf(b.mem) != null ? parseFloat(avgOf(b.mem).toFixed(0)) : null,
370
+ })),
371
+ };
372
+ const lines = [
373
+ `📈 Performance trend (${bucketBy === 'week' ? 'weekly' : bucketBy === 'month' ? 'monthly' : 'daily'}, last ${lookbackDays} days — ${txs.length} transactions)\n`,
374
+ ` ${'Period'.padEnd(12)} ${'Runs'.padStart(5)} ${'SpeedIdx'.padStart(9)} ${'Duration'.padStart(9)} ${'CPU%'.padStart(6)} ${'Mem MB'.padStart(7)}`,
375
+ ` ${'─'.repeat(52)}`,
376
+ ...sorted.map(([period, b]) => {
377
+ const si = fmt1(avgOf(b.speedIndex), ' SI');
378
+ const dur = avgOf(b.duration) != null ? `${(avgOf(b.duration) / 1000).toFixed(2)}s` : 'n/a';
379
+ const cpu = fmt1(avgOf(b.cpu), '%');
380
+ const mem = avgOf(b.mem) != null ? `${avgOf(b.mem).toFixed(0)}` : 'n/a';
381
+ return ` ${period.padEnd(12)} ${String(b.count).padStart(5)} ${si.padStart(9)} ${dur.padStart(9)} ${cpu.padStart(6)} ${mem.padStart(7)}`;
382
+ }),
383
+ ];
384
+ return respond(outputFormat, structured, lines.join('\n'));
385
+ }
386
+ catch (e) {
387
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
388
+ }
389
+ });
390
+ }
391
+ //# sourceMappingURL=transaction-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transaction-tools.js","sourceRoot":"","sources":["../../src/tools/transaction-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ export declare function registerUsageReportTools(server: McpServer): void;
3
+ //# sourceMappingURL=usage-report-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-report-tools.d.ts","sourceRoot":"","sources":["../../src/tools/usage-report-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmIhE"}
@@ -0,0 +1,160 @@
1
+ import { z } from 'zod';
2
+ import { downloadUsageReport, summarizeUsageReport, buildUsageReportPath } from '../api/usage-reports.js';
3
+ import { validateUsageReportParams, checkUsageReportSizeGuard, MAX_UNSCOPED_RANGE_DAYS } from '../utils/usage-report-guard.js';
4
+ import { validateOutputPath } from '../utils/path-guard.js';
5
+ import { SERVER_FS_DOWNLOAD_NOTICE, SERVER_FS_OUTPUT_PARAM } from '../utils/locality.js';
6
+ import { buildDownloadCommand } from '../utils/download-command.js';
7
+ import { outputFormatParam, respond } from '../utils/output-format.js';
8
+ const REPORT_TYPE_ENUM = z.enum([
9
+ 'Device Reservations',
10
+ 'Users Usage',
11
+ 'Devices Usage',
12
+ 'Browser Usage',
13
+ 'Users Statistics',
14
+ 'License Usage',
15
+ ]);
16
+ // Columns and guidance below reflect real live samples, not the object-type name alone — pick the
17
+ // NARROWEST report that has the field you need; "License Usage" is the largest and slowest (~27 MB
18
+ // for one unfiltered month, measured live) and should be a last resort, not a default.
19
+ const REPORT_TYPE_DESCRIPTION = 'Which platform usage-report CSV to fetch:\n' +
20
+ '- "Device Reservations": columns Project, Start Date, End Date, Total Reservation Time (hours)[, Tokens]. ' +
21
+ 'One row per project. Use for capacity planning / chargeback-by-project ("how many device-hours did project X use").\n' +
22
+ '- "Users Usage": SAME columns/shape as Device Reservations. Without a userId it returns IDENTICAL project-aggregate ' +
23
+ 'rows to Device Reservations (confirmed live) — redundant; call Device Reservations instead in that case. Only ' +
24
+ 'meaningful with a specific non-zero userId, which narrows to that one user\'s reservation-hours per project.\n' +
25
+ '- "Devices Usage": columns Device ID, Device name, OS, OS Version, Project, Total duration (hours). One row per ' +
26
+ 'device. Use for per-device utilization / idle-device audits, NOT per-user or per-session questions.\n' +
27
+ '- "Browser Usage": columns session start/end timestamp+time, duration, session host, browser platform/name/version, ' +
28
+ 'username, email, project, execution type. One row per Selenium/browser session. Use for browser-version ' +
29
+ 'distribution and web-session audit trails, NOT mobile device usage.\n' +
30
+ '- "Users Statistics": columns time logged, user, project, clicks, swipe distance, keys sent, installs, screens ' +
31
+ 'sent, screen time min/max/avg (ms), user tag. Per-INTERACTION-EVENT telemetry from interactive/manual sessions — ' +
32
+ 'NOT reservation-time totals and NOT automated test results. Use for manual-session engagement/activity analysis only.\n' +
33
+ '- "License Usage": columns full per-session detail (timestamps, user, project, session/license type, device, ' +
34
+ 'product). No project/user filter exists — always platform-wide. The largest, slowest report; use only when a ' +
35
+ 'coarser report above does not have the field you need (license-seat exhaustion, per-product consumption, full ' +
36
+ 'session-level compliance audit).';
37
+ const START_DATE_DESC = 'Inclusive start date, "YYYY-MM-DD". Interpreted as UTC 00:00:00.000 — NOT your local timezone.';
38
+ const END_DATE_DESC = 'Inclusive end date, "YYYY-MM-DD". Interpreted as UTC 23:59:59.999 — NOT your local timezone.';
39
+ const PROJECT_ID_DESC = 'Numeric project ID to scope to a single project. Omit or 0 for all projects. Not supported by "License Usage".';
40
+ const USER_ID_DESC = 'Numeric user ID to scope to a single user. Omit or 0 for all users. Not supported by "License Usage", "Devices Usage", or "Browser Usage".';
41
+ const CONFIRM_LARGE_DESC = `Set true to proceed with an unfiltered export spanning more than ${MAX_UNSCOPED_RANGE_DAYS} days despite the size guard.`;
42
+ function formatBytes(n) {
43
+ if (n < 1024)
44
+ return `${n} B`;
45
+ if (n < 1024 * 1024)
46
+ return `${(n / 1024).toFixed(1)} KB`;
47
+ return `${(n / (1024 * 1024)).toFixed(1)} MB`;
48
+ }
49
+ export function registerUsageReportTools(server) {
50
+ server.tool('download_usage_report', 'Downloads one of six platform usage-report CSVs — Device Reservations, Users Usage, Devices Usage, Browser Usage, ' +
51
+ 'Users Statistics, or License Usage. Cloud Admin only. Unfiltered multi-week exports can be large and slow ' +
52
+ '(measured live: ~27 MB for one unfiltered month of License Usage, ~6.4 MB for one unfiltered week of Device ' +
53
+ `Reservations) — beyond ${MAX_UNSCOPED_RANGE_DAYS} days with no project/user filter, a size guard blocks the ` +
54
+ 'download until you narrow the request or pass confirmLargeExport: true.' +
55
+ SERVER_FS_DOWNLOAD_NOTICE, {
56
+ reportType: REPORT_TYPE_ENUM.describe(REPORT_TYPE_DESCRIPTION),
57
+ startDate: z.string().describe(START_DATE_DESC),
58
+ endDate: z.string().describe(END_DATE_DESC),
59
+ projectId: z.number().optional().describe(PROJECT_ID_DESC),
60
+ userId: z.number().optional().describe(USER_ID_DESC),
61
+ localPath: z.string().describe(SERVER_FS_OUTPUT_PARAM),
62
+ confirmLargeExport: z.boolean().optional().describe(CONFIRM_LARGE_DESC),
63
+ }, async ({ reportType, startDate, endDate, projectId, userId, localPath, confirmLargeExport }) => {
64
+ const params = { reportType, startDate, endDate, projectId, userId, confirmLargeExport };
65
+ const validationErr = validateUsageReportParams(params);
66
+ if (validationErr)
67
+ return { content: [{ type: 'text', text: `Error: ${validationErr}` }], isError: true };
68
+ const pathErr = validateOutputPath(localPath);
69
+ if (pathErr)
70
+ return { content: [{ type: 'text', text: `Error: ${pathErr}` }], isError: true };
71
+ const guardMsg = checkUsageReportSizeGuard(params);
72
+ if (guardMsg)
73
+ return { content: [{ type: 'text', text: guardMsg }] };
74
+ try {
75
+ const { bytes } = await downloadUsageReport(reportType, { startDate, endDate, projectId, userId }, localPath);
76
+ return {
77
+ content: [{ type: 'text', text: `✅ "${reportType}" report (${formatBytes(bytes)}) downloaded to: ${localPath}` }],
78
+ };
79
+ }
80
+ catch (e) {
81
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
82
+ }
83
+ });
84
+ server.tool('get_usage_report_download_command', 'Generates a ready-to-run curl or PowerShell command for downloading a usage-report CSV directly to the user\'s ' +
85
+ 'local machine. Use this instead of download_usage_report when the MCP server runs in Docker/remote and the ' +
86
+ 'written file would be inaccessible to the user — this is the preferred path for large exports, since the ' +
87
+ 'download runs on the user\'s own network instead of proxying through the MCP process. Same date/filter/size-guard ' +
88
+ 'rules as download_usage_report.\n\n' +
89
+ 'WARNING: The generated command embeds the active access key in plaintext. Run immediately, do not save or share.', {
90
+ reportType: REPORT_TYPE_ENUM.describe(REPORT_TYPE_DESCRIPTION),
91
+ startDate: z.string().describe(START_DATE_DESC),
92
+ endDate: z.string().describe(END_DATE_DESC),
93
+ projectId: z.number().optional().describe(PROJECT_ID_DESC),
94
+ userId: z.number().optional().describe(USER_ID_DESC),
95
+ localPath: z.string().describe('Path on the user\'s local machine to save the CSV.'),
96
+ localPlatform: z
97
+ .enum(['windows', 'macos', 'linux'])
98
+ .describe('Platform of the machine that will run the command. "windows" emits both Git Bash curl and PowerShell. Cannot be inferred — the MCP runs in Docker.'),
99
+ confirmLargeExport: z.boolean().optional().describe(CONFIRM_LARGE_DESC),
100
+ outputFormat: outputFormatParam,
101
+ }, async ({ reportType, startDate, endDate, projectId, userId, localPath, localPlatform, confirmLargeExport, outputFormat }) => {
102
+ const params = { reportType, startDate, endDate, projectId, userId, confirmLargeExport };
103
+ const validationErr = validateUsageReportParams(params);
104
+ if (validationErr)
105
+ return { content: [{ type: 'text', text: `Error: ${validationErr}` }], isError: true };
106
+ const guardMsg = checkUsageReportSizeGuard(params);
107
+ if (guardMsg)
108
+ return { content: [{ type: 'text', text: guardMsg }] };
109
+ const path = buildUsageReportPath(reportType, { startDate, endDate, projectId, userId });
110
+ const result = buildDownloadCommand({
111
+ path,
112
+ localPath,
113
+ localPlatform,
114
+ notes: [`Report: "${reportType}" (${startDate} to ${endDate}, inclusive UTC calendar days)`],
115
+ });
116
+ return respond(outputFormat, { endpoint: result.endpoint, curlCommand: result.curlCommand, psCommand: result.psCommand }, result.humanText);
117
+ });
118
+ server.tool('summarize_usage_report', 'Fetches a usage-report CSV and aggregates it by a column (e.g. session counts by username) WITHOUT writing any ' +
119
+ 'file — the result is a compact JSON summary returned directly. Use this instead of download_usage_report when ' +
120
+ 'you want a count/breakdown rather than the raw CSV, and especially when the caller\'s filesystem is not the MCP ' +
121
+ 'server\'s own (e.g. a remote/sandboxed client) — a written file is often unreachable in that case, while this ' +
122
+ 'tool never writes one. Same reportType/date/filter/size-guard rules as download_usage_report.\n\n' +
123
+ 'groupBy must name an actual column in that report\'s CSV — if it doesn\'t match, the error lists the real ' +
124
+ 'column names so you can retry correctly. Common groupBy values: "Username" (License Usage, Browser Usage), ' +
125
+ '"User" (Users Statistics), "Project" (Device Reservations, Users Usage, Devices Usage).', {
126
+ reportType: REPORT_TYPE_ENUM.describe(REPORT_TYPE_DESCRIPTION),
127
+ startDate: z.string().describe(START_DATE_DESC),
128
+ endDate: z.string().describe(END_DATE_DESC),
129
+ projectId: z.number().optional().describe(PROJECT_ID_DESC),
130
+ userId: z.number().optional().describe(USER_ID_DESC),
131
+ groupBy: z.string().describe('Column name to group rows by, e.g. "Username" or "Project". Case-insensitive, must match a real column in this report\'s CSV header.'),
132
+ sumColumn: z.string().optional().describe('Optional numeric column to sum per group, e.g. "Session Duration (in hours)".'),
133
+ topN: z.number().optional().describe('Max number of groups to return, sorted by count descending (default 50). Excess groups are noted as truncated, not silently dropped.'),
134
+ confirmLargeExport: z.boolean().optional().describe(CONFIRM_LARGE_DESC),
135
+ outputFormat: outputFormatParam,
136
+ }, async ({ reportType, startDate, endDate, projectId, userId, groupBy, sumColumn, topN, confirmLargeExport, outputFormat }) => {
137
+ const params = { reportType, startDate, endDate, projectId, userId, confirmLargeExport };
138
+ const validationErr = validateUsageReportParams(params);
139
+ if (validationErr)
140
+ return { content: [{ type: 'text', text: `Error: ${validationErr}` }], isError: true };
141
+ const guardMsg = checkUsageReportSizeGuard(params);
142
+ if (guardMsg)
143
+ return { content: [{ type: 'text', text: guardMsg }] };
144
+ try {
145
+ const summary = await summarizeUsageReport(reportType, { startDate, endDate, projectId, userId }, { groupBy, sumColumn, topN });
146
+ const lines = [
147
+ `"${reportType}" grouped by "${groupBy}"${sumColumn ? ` (summing "${sumColumn}")` : ''}: ${summary.totalRows} row(s), ${summary.totalGroups} group(s)${summary.truncated ? ` — showing top ${summary.groups.length}` : ''}`,
148
+ '',
149
+ ...summary.groups.map((g) => `- ${g.value || '(blank)'}: ${g.count}${g.sum !== undefined ? ` (sum: ${g.sum})` : ''}`),
150
+ ];
151
+ if (summary.truncated)
152
+ lines.push('', `⚠️ Truncated to top ${summary.groups.length} of ${summary.totalGroups} groups. Narrow the date range or filters to see the rest.`);
153
+ return respond(outputFormat, summary, lines.join('\n'));
154
+ }
155
+ catch (e) {
156
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
157
+ }
158
+ });
159
+ }
160
+ //# sourceMappingURL=usage-report-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-report-tools.js","sourceRoot":"","sources":["../../src/tools/usage-report-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9B,qBAAqB;IACrB,aAAa;IACb,eAAe;IACf,eAAe;IACf,kBAAkB;IAClB,eAAe;CAChB,CAAC,CAAC;AAEH,kGAAkG;AAClG,mGAAmG;AACnG,uFAAuF;AACvF,MAAM,uBAAuB,GAC3B,6CAA6C;IAC7C,4GAA4G;IAC5G,uHAAuH;IACvH,sHAAsH;IACtH,gHAAgH;IAChH,gHAAgH;IAChH,kHAAkH;IAClH,uGAAuG;IACvG,sHAAsH;IACtH,0GAA0G;IAC1G,uEAAuE;IACvE,iHAAiH;IACjH,mHAAmH;IACnH,yHAAyH;IACzH,+GAA+G;IAC/G,+GAA+G;IAC/G,gHAAgH;IAChH,kCAAkC,CAAC;AAErC,MAAM,eAAe,GAAG,gGAAgG,CAAC;AACzH,MAAM,aAAa,GAAG,8FAA8F,CAAC;AACrH,MAAM,eAAe,GAAG,gHAAgH,CAAC;AACzI,MAAM,YAAY,GAAG,4IAA4I,CAAC;AAClK,MAAM,kBAAkB,GAAG,oEAAoE,uBAAuB,+BAA+B,CAAC;AAEtJ,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1D,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,oHAAoH;QAClH,4GAA4G;QAC5G,8GAA8G;QAC9G,0BAA0B,uBAAuB,6DAA6D;QAC9G,yEAAyE;QACzE,yBAAyB,EAC3B;QACE,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACtD,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KACxE,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,EAAE;QAC7F,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAEzF,MAAM,aAAa,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,aAAa;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,aAAa,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAE1G,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAE9F,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;YAC9G,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,aAAa,WAAW,CAAC,KAAK,CAAC,oBAAoB,SAAS,EAAE,EAAE,CAAC;aAClH,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAW,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChG,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mCAAmC,EACnC,iHAAiH;QAC/G,6GAA6G;QAC7G,2GAA2G;QAC3G,oHAAoH;QACpH,qCAAqC;QACrC,kHAAkH,EACpH;QACE,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACpF,aAAa,EAAE,CAAC;aACb,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;aACnC,QAAQ,CAAC,oJAAoJ,CAAC;QACjK,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvE,YAAY,EAAE,iBAAiB;KAChC,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,EAAE,EAAE;QAC1H,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAEzF,MAAM,aAAa,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,aAAa;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,aAAa,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAE1G,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAErE,MAAM,IAAI,GAAG,oBAAoB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,IAAI;YACJ,SAAS;YACT,aAAa;YACb,KAAK,EAAE,CAAC,YAAY,UAAU,MAAM,SAAS,OAAO,OAAO,gCAAgC,CAAC;SAC7F,CAAC,CAAC;QACH,OAAO,OAAO,CACZ,YAAY,EACZ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAC3F,MAAM,CAAC,SAAS,CACjB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,iHAAiH;QAC/G,gHAAgH;QAChH,kHAAkH;QAClH,gHAAgH;QAChH,mGAAmG;QACnG,4GAA4G;QAC5G,6GAA6G;QAC7G,yFAAyF,EAC3F;QACE,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sIAAsI,CAAC;QACpK,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;QAC1H,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sIAAsI,CAAC;QAC5K,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvE,YAAY,EAAE,iBAAiB;KAChC,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,EAAE,EAAE;QAC1H,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QAEzF,MAAM,aAAa,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,aAAa;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,aAAa,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAE1G,MAAM,QAAQ,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChI,MAAM,KAAK,GAAG;gBACZ,IAAI,UAAU,iBAAiB,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,cAAc,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,SAAS,YAAY,OAAO,CAAC,WAAW,YAAY,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC3N,EAAE;gBACF,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,SAAS,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;aACtH,CAAC;YACF,IAAI,OAAO,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,OAAO,CAAC,MAAM,CAAC,MAAM,OAAO,OAAO,CAAC,WAAW,4DAA4D,CAAC,CAAC;YAC1K,OAAO,OAAO,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAW,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChG,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ export declare function registerUserTools(server: McpServer): void;
3
+ //# sourceMappingURL=user-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../src/tools/user-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8TzD"}