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,67 @@
1
+ import { z } from 'zod';
2
+ import { getNvServers, getNvServer } from '../api/nv-servers.js';
3
+ import { formatNvServerList } from '../utils/response-formatter.js';
4
+ import { outputFormatParam, respond } from '../utils/output-format.js';
5
+ const regionName = (r) => typeof r === 'object' && r !== null ? r.name : (r ?? '');
6
+ export function registerNvServerTools(server) {
7
+ server.tool('list_nv_servers', 'List all Network Virtualization (NV) servers. Shows status, region, host, and tunneling connectivity. NV servers enable network condition simulation (latency, packet loss, bandwidth throttling) during test sessions. ' +
8
+ 'CALL THIS BEFORE running any performance-instrumented test session: a performance transaction records nothing unless an NV server in the device\'s region is ONLINE and tunnel-connected. Speed Index and network metrics collected without a connected NV server are unreliable and will produce misleading compare_performance_transactions results. Filter with region=<device region> and connectedOnly=true to confirm one is available. Cloud Admin only.', {
9
+ region: z.string().optional().describe('Filter by region name (client-side, partial match). E.g. "US1", "SG1".'),
10
+ connectedOnly: z.boolean().optional().describe('If true, return only NV servers with active tunneling connections.'),
11
+ outputFormat: outputFormatParam,
12
+ }, async ({ region, connectedOnly, outputFormat }) => {
13
+ try {
14
+ let servers = await getNvServers();
15
+ if (region) {
16
+ const q = region.toLowerCase();
17
+ servers = servers.filter(s => regionName(s.region).toLowerCase().includes(q));
18
+ }
19
+ if (connectedOnly) {
20
+ servers = servers.filter(s => s.tunnelingConnected);
21
+ }
22
+ const structured = {
23
+ nvServers: servers.map(s => ({
24
+ id: s.id,
25
+ name: s.name,
26
+ region: regionName(s.region),
27
+ hostOrIp: s.hostOrIp,
28
+ status: s.status,
29
+ tunnelingConnected: s.tunnelingConnected,
30
+ proxyServerPort: s.proxyServerPort,
31
+ tunnelingPort: s.tunnelingPort,
32
+ version: s.version,
33
+ error: s.error,
34
+ })),
35
+ total: servers.length,
36
+ };
37
+ return respond(outputFormat, structured, formatNvServerList(servers));
38
+ }
39
+ catch (e) {
40
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
41
+ }
42
+ });
43
+ server.tool('get_nv_server', 'Get details for a specific NV server by ID. Cloud Admin only.', {
44
+ nvServerId: z.number().int().describe('Numeric NV server ID from list_nv_servers.'),
45
+ outputFormat: outputFormatParam,
46
+ }, async ({ nvServerId, outputFormat }) => {
47
+ try {
48
+ const server_data = await getNvServer(nvServerId);
49
+ const lines = [
50
+ `NV Server: ${server_data.name} (ID: ${server_data.id})`,
51
+ `Region: ${regionName(server_data.region)}`,
52
+ `Host: ${server_data.hostOrIp}`,
53
+ `Status: ${server_data.status}`,
54
+ `Tunneling: ${server_data.tunnelingConnected ? '✅ Connected' : '❌ Disconnected'}`,
55
+ server_data.proxyServerPort ? `Proxy Port: ${server_data.proxyServerPort}` : '',
56
+ server_data.tunnelingPort ? `Tunnel Port: ${server_data.tunnelingPort}` : '',
57
+ server_data.version ? `Version: ${server_data.version}` : '',
58
+ server_data.error ? `⚠️ Error: ${server_data.error}` : '',
59
+ ].filter(Boolean).join('\n');
60
+ return respond(outputFormat, server_data, lines);
61
+ }
62
+ catch (e) {
63
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
64
+ }
65
+ });
66
+ }
67
+ //# sourceMappingURL=nv-server-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nv-server-tools.js","sourceRoot":"","sources":["../../src/tools/nv-server-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 registerPerformanceTools(server: McpServer): void;
3
+ //# sourceMappingURL=performance-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"performance-tools.d.ts","sourceRoot":"","sources":["../../src/tools/performance-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmJzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiMhE"}
@@ -0,0 +1,295 @@
1
+ import { z } from 'zod';
2
+ import { listTransactions, getTransaction } from '../api/transactions.js';
3
+ import { performanceTransaction } from '../api/webdriver.js';
4
+ import { outputFormatParam, respond } from '../utils/output-format.js';
5
+ import { buildComparison, buildConfoundAssessment, buildOutlierReport, } from '../utils/performance-comparison.js';
6
+ // ─── Shared schema fragments ──────────────────────────────────────────────────
7
+ const filterShape = {
8
+ appName: z.string().optional().describe('App package/bundle name (case-insensitive substring).'),
9
+ appVersion: z.string().optional().describe('App version string (substring).'),
10
+ transactionName: z.string().optional().describe('Transaction name, e.g. "Login" (substring).'),
11
+ deviceOs: z.enum(['Android', 'iOS']).optional().describe('Device OS.'),
12
+ deviceName: z.string().optional().describe('Full device name (substring).'),
13
+ deviceModel: z.string().optional().describe('Device model code or name (substring), e.g. "SM-G991U".'),
14
+ deviceVersion: z.string().optional().describe('OS version string (substring), e.g. "12.0".'),
15
+ networkProfile: z.string().optional().describe('Network profile (substring); empty string matches transactions with no profile.'),
16
+ projectName: z.string().optional().describe('Project name (substring).'),
17
+ testId: z.number().int().optional().describe('Exact reporter test_id — use to compare two specific automation runs.'),
18
+ startDate: z.string().optional().describe('ISO 8601 start of range (inclusive).'),
19
+ endDate: z.string().optional().describe('ISO 8601 end of range (inclusive).'),
20
+ };
21
+ const sideFilterSchema = z.object(filterShape).optional();
22
+ const comparisonDimensionEnum = z.enum([
23
+ 'appVersion', 'deviceModel', 'deviceOs', 'deviceVersion',
24
+ 'networkProfile', 'deviceName', 'projectName', 'name', 'region', 'testId',
25
+ ]);
26
+ const metricEnum = z.enum([
27
+ 'speedIndex', 'cpuAvg', 'memAvg', 'batteryAvg', 'duration',
28
+ 'totalDownloadedBytes', 'totalUploadedBytes',
29
+ ]);
30
+ const METRIC_LABEL = {
31
+ speedIndex: 'Speed Index', cpuAvg: 'CPU avg', memAvg: 'Memory avg', batteryAvg: 'Battery avg',
32
+ duration: 'Duration', totalDownloadedBytes: 'Downloaded', totalUploadedBytes: 'Uploaded',
33
+ };
34
+ // Speed Index is a composite visual-progress score (area above the render curve,
35
+ // WebPageTest methodology), NOT elapsed time. A delta of N SI does NOT mean the
36
+ // screen rendered N ms sooner — it means cumulative rendering quality across the
37
+ // whole render window improved. Surface this everywhere the metric appears (v42).
38
+ const SPEED_INDEX_SEMANTICS = 'area above the visual-progress curve (WebPageTest methodology); a lower value means content was visible ' +
39
+ 'more completely earlier across the render window. A delta is NOT a shift in render-completion time.';
40
+ const SPEED_INDEX_SEMANTICS_SHORT = 'area above the visual-progress curve; lower = content visible earlier';
41
+ // Force speedIndex to be present and first so it always anchors outlier exclusion
42
+ // and delta ranking. Returns the normalized list and whether it was adjusted (v42 FP2).
43
+ function normalizeMetrics(requested) {
44
+ const base = (requested && requested.length ? [...requested] : ['speedIndex']);
45
+ if (base[0] === 'speedIndex')
46
+ return { metrics: base, adjusted: false };
47
+ const without = base.filter((m) => m !== 'speedIndex');
48
+ return { metrics: ['speedIndex', ...without], adjusted: true };
49
+ }
50
+ function buildSide(label, ids, filter) {
51
+ return { label, transactionIds: ids, filter };
52
+ }
53
+ // Build the transaction pool the compute layer will resolve sides against.
54
+ //
55
+ // listTransactions() is PROJECT-SCOPED to the active JWT's reporter context, so
56
+ // transactions created under a different project's reporter instance are absent
57
+ // from it. getTransaction(id) is a direct GET that works across scopes. So:
58
+ // - explicit IDs are always resolved directly (cross-scope, and bounded by the
59
+ // number of IDs given — no full-list fetch when both sides are explicit);
60
+ // - the bulk list is fetched ONLY when a side uses a filter (which needs it).
61
+ async function gatherPool(sides) {
62
+ const pool = new Map();
63
+ const needList = sides.some((s) => !s.transactionIds || s.transactionIds.length === 0);
64
+ if (needList) {
65
+ for (const t of await listTransactions())
66
+ pool.set(t.id, t);
67
+ }
68
+ const explicitIds = [...new Set(sides.flatMap((s) => s.transactionIds ?? []))];
69
+ const missing = explicitIds.filter((id) => !pool.has(id));
70
+ const fetched = await Promise.all(missing.map((id) => getTransaction(id).catch(() => null)));
71
+ for (const t of fetched)
72
+ if (t)
73
+ pool.set(t.id, t);
74
+ return [...pool.values()];
75
+ }
76
+ function num(n, digits = 1) {
77
+ return n == null ? 'n/a' : n.toFixed(digits);
78
+ }
79
+ // ─── Human-readable renderers ─────────────────────────────────────────────────
80
+ function renderComparison(cmp) {
81
+ const lines = [
82
+ `📊 Performance comparison — "${cmp.sideA.label}" (A) vs "${cmp.sideB.label}" (B)`,
83
+ ` A: ${cmp.sideA.n} sample(s)${cmp.sideA.excludedIds.length ? ` (excluded ${cmp.sideA.excludedIds.length} outlier: ${cmp.sideA.excludedIds.join(', ')})` : ''}`,
84
+ ` B: ${cmp.sideB.n} sample(s)${cmp.sideB.excludedIds.length ? ` (excluded ${cmp.sideB.excludedIds.length} outlier: ${cmp.sideB.excludedIds.join(', ')})` : ''}`,
85
+ ` Outlier exclusion: ${cmp.outlierExclusionApplied ? `on (MAD, trim ${(cmp.trimFraction * 100).toFixed(0)}%)` : 'off'}`,
86
+ '',
87
+ ];
88
+ for (const m of cmp.metrics) {
89
+ const a = m.sideA, b = m.sideB;
90
+ const pct = m.percentChangeTrimmedMean;
91
+ const dir = pct == null ? '' : pct > 0 ? ' ▲' : pct < 0 ? ' ▼' : ' ●';
92
+ const composite = m.metric === 'speedIndex' ? ' ⚠️ composite visual-progress score, NOT elapsed time' : '';
93
+ lines.push(` ${METRIC_LABEL[m.metric] ?? m.metric} (${m.unit})${composite}`);
94
+ lines.push(` A trimmed=${num(a.trimmedMean)} median=${num(a.median)} mean=${num(a.mean)} [min ${num(a.min)} / max ${num(a.max)}] n=${a.n} CV=${a.cv == null ? 'n/a' : (a.cv * 100).toFixed(1) + '%'}`);
95
+ lines.push(` B trimmed=${num(b.trimmedMean)} median=${num(b.median)} mean=${num(b.mean)} [min ${num(b.min)} / max ${num(b.max)}] n=${b.n} CV=${b.cv == null ? 'n/a' : (b.cv * 100).toFixed(1) + '%'}`);
96
+ lines.push(` Δ trimmed=${num(m.deltaTrimmedMean)} median=${num(m.deltaMedian)} mean=${num(m.deltaMean)}${pct == null ? '' : ` (${pct > 0 ? '+' : ''}${pct.toFixed(1)}% on trimmed mean)${dir}`}`);
97
+ lines.push('');
98
+ }
99
+ for (const n of cmp.notes)
100
+ lines.push(` ⚠️ ${n}`);
101
+ return lines.join('\n');
102
+ }
103
+ function renderConfounds(a) {
104
+ const icon = a.validity === 'clean' ? '✅' : a.validity === 'caveated' ? '⚠️' : '⛔';
105
+ const sevIcon = { high: '⛔', medium: '⚠️', low: 'ℹ️', info: 'ℹ️' };
106
+ const lines = [
107
+ `${icon} Confound assessment — validity: ${a.validity.toUpperCase()}`,
108
+ ` Declared comparison axis: ${a.comparisonAxis.join(', ') || '(none)'}`,
109
+ '',
110
+ ` ${a.summary}`,
111
+ '',
112
+ ];
113
+ if (a.flags.length === 0) {
114
+ lines.push(' No confounding factors detected.');
115
+ }
116
+ else {
117
+ lines.push(' Factors:');
118
+ for (const f of a.flags) {
119
+ lines.push(` ${sevIcon[f.severity]} [${f.severity}/${f.kind}] ${f.dimension}: ${f.message}`);
120
+ }
121
+ }
122
+ return lines.join('\n');
123
+ }
124
+ // ─── Tool registration ─────────────────────────────────────────────────────────
125
+ export function registerPerformanceTools(server) {
126
+ // ── compare_performance_transactions ──────────────────────────────────────
127
+ server.tool('compare_performance_transactions', 'Compare performance (Speed Index and optionally CPU/memory/battery/duration) between TWO sets of ' +
128
+ 'transactions, reporting trimmed mean, median, AND raw mean for each side plus the delta and % change. ' +
129
+ 'This is the analytical core of a performance comparison report — for the full guided sequence use the ' +
130
+ 'performance_comparison_report prompt. ' +
131
+ 'PREREQUISITE WORKFLOW — before trusting any delta this tool produces, you should already have: ' +
132
+ '(a) confirmed via list_nv_servers that an NV server in the device region was ONLINE during the runs — ' +
133
+ 'Speed Index collected without active NV instrumentation is unreliable; ' +
134
+ '(b) run detect_performance_outliers on each side and addressed flagged samples (needs ≥4 samples per side, ' +
135
+ 'or outlier exclusion is skipped); ' +
136
+ '(c) run assess_comparison_confounds with the intended comparisonAxis and gotten a clean/caveated verdict. ' +
137
+ 'This tool\'s built-in MAD exclusion is a safety net, NOT a substitute for those steps. ' +
138
+ 'Define each side either by explicit transactionIds (from list_transactions) OR by a filter object ' +
139
+ '(appVersion, deviceModel, networkProfile, etc.). Common comparisons: app v1 vs v2 on the same device; ' +
140
+ 'device A vs device B on the same app; one region vs another; two automation test scripts (by testId). ' +
141
+ 'STRONGLY RECOMMENDED: pass comparisonAxis (what is SUPPOSED to differ) so the tool also runs a confound check ' +
142
+ 'and tells you whether the delta is attributable to that axis or polluted by an uncontrolled factor — a raw delta ' +
143
+ 'without a confound check is easy to misread (e.g. a Speed Index gap that is really a device-model difference). ' +
144
+ 'All access levels — project keys see only their own project\'s transactions.', {
145
+ sideALabel: z.string().describe('Human label for side A, e.g. "v1.0" or "Galaxy S21".'),
146
+ sideBLabel: z.string().describe('Human label for side B, e.g. "v2.0" or "Pixel 7".'),
147
+ sideATransactionIds: z.array(z.number().int()).optional().describe('Explicit transaction IDs for side A. Provide this OR sideAFilter.'),
148
+ sideBTransactionIds: z.array(z.number().int()).optional().describe('Explicit transaction IDs for side B. Provide this OR sideBFilter.'),
149
+ sideAFilter: sideFilterSchema.describe('Filter selecting side A transactions (used when sideATransactionIds is omitted).'),
150
+ sideBFilter: sideFilterSchema.describe('Filter selecting side B transactions (used when sideBTransactionIds is omitted).'),
151
+ metrics: z.array(metricEnum).optional().describe('Metrics to compare. Speed Index is ALWAYS included and forced to the front — it is the platform\'s primary UX latency signal and the anchor for outlier exclusion and delta ranking; if you omit it or list it later it is auto-inserted first. NOTE: speedIndex is a composite visual-progress score (' + SPEED_INDEX_SEMANTICS_SHORT + '), NOT a duration. Add cpuAvg/memAvg/batteryAvg/duration as secondary metrics. Default ["speedIndex"].'),
152
+ comparisonAxis: z.array(comparisonDimensionEnum).optional().describe('The dimension(s) that are SUPPOSED to differ. When provided, a confound assessment is embedded in the result.'),
153
+ trimFraction: z.number().min(0).max(0.49).optional().default(0.1).describe('Fraction trimmed from each end for the trimmed mean. Default 0.1 (10%).'),
154
+ excludeOutliers: z.boolean().optional().default(true).describe('Drop MAD outliers (on the primary metric) before aggregating. Default true.'),
155
+ outlierK: z.number().min(1).optional().default(3.5).describe('Modified z-score threshold for outlier exclusion. Default 3.5.'),
156
+ outputFormat: outputFormatParam,
157
+ }, async (args) => {
158
+ try {
159
+ const sideA = buildSide(args.sideALabel, args.sideATransactionIds, args.sideAFilter);
160
+ const sideB = buildSide(args.sideBLabel, args.sideBTransactionIds, args.sideBFilter);
161
+ const all = await gatherPool([sideA, sideB]);
162
+ const { metrics, adjusted } = normalizeMetrics(args.metrics);
163
+ const cmp = buildComparison(all, sideA, sideB, {
164
+ metrics,
165
+ trimFraction: args.trimFraction,
166
+ excludeOutliers: args.excludeOutliers,
167
+ outlierK: args.outlierK,
168
+ });
169
+ if (adjusted) {
170
+ cmp.notes.unshift('Speed Index was inserted as the primary metric (it anchors outlier exclusion and delta ranking).');
171
+ }
172
+ if (cmp.sideA.n === 0 || cmp.sideB.n === 0) {
173
+ const which = [cmp.sideA.n === 0 ? `"${args.sideALabel}"` : null, cmp.sideB.n === 0 ? `"${args.sideBLabel}"` : null].filter(Boolean).join(' and ');
174
+ return {
175
+ content: [{ type: 'text', text: `No transactions matched side ${which}. Verify the IDs or widen the filter with list_transactions first.` }],
176
+ isError: true,
177
+ };
178
+ }
179
+ let confounds;
180
+ if (args.comparisonAxis && args.comparisonAxis.length) {
181
+ confounds = buildConfoundAssessment(all, sideA, sideB, args.comparisonAxis);
182
+ }
183
+ const structured = {
184
+ comparison: cmp,
185
+ metricSemantics: { speedIndex: { isCompositeMetric: true, unit: 'SI', meaning: SPEED_INDEX_SEMANTICS } },
186
+ ...(confounds && { confounds }),
187
+ };
188
+ const human = [renderComparison(cmp), ...(confounds ? ['', renderConfounds(confounds)] : [])].join('\n');
189
+ return respond(args.outputFormat, structured, human);
190
+ }
191
+ catch (e) {
192
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
193
+ }
194
+ });
195
+ // ── assess_comparison_confounds ───────────────────────────────────────────
196
+ server.tool('assess_comparison_confounds', 'Check whether a planned two-set performance comparison is sound, BEFORE trusting any delta. Given the two ' +
197
+ 'sides and the comparisonAxis (the dimension that is SUPPOSED to differ — e.g. "appVersion"), it flags every ' +
198
+ 'OTHER dimension (device model, OS, OS version, network profile, project, transaction name) that varies across ' +
199
+ 'or within the sides, plus transactions missing CPU/memory telemetry and sample-size imbalance. Returns a ' +
200
+ 'validity verdict: clean / caveated / confounded. Use this to scrub a comparison plan during the planning phase, ' +
201
+ 'or to explain why a surprising delta is untrustworthy. All access levels — project keys see only their own project\'s transactions.', {
202
+ sideALabel: z.string().describe('Human label for side A.'),
203
+ sideBLabel: z.string().describe('Human label for side B.'),
204
+ sideATransactionIds: z.array(z.number().int()).optional().describe('Explicit transaction IDs for side A. Provide this OR sideAFilter.'),
205
+ sideBTransactionIds: z.array(z.number().int()).optional().describe('Explicit transaction IDs for side B. Provide this OR sideBFilter.'),
206
+ sideAFilter: sideFilterSchema.describe('Filter selecting side A transactions.'),
207
+ sideBFilter: sideFilterSchema.describe('Filter selecting side B transactions.'),
208
+ comparisonAxis: z.array(comparisonDimensionEnum).min(1).describe('The dimension(s) that SHOULD differ between sides. Everything else that differs is reported as a confound.'),
209
+ outputFormat: outputFormatParam,
210
+ }, async (args) => {
211
+ try {
212
+ const sideA = buildSide(args.sideALabel, args.sideATransactionIds, args.sideAFilter);
213
+ const sideB = buildSide(args.sideBLabel, args.sideBTransactionIds, args.sideBFilter);
214
+ const all = await gatherPool([sideA, sideB]);
215
+ const assessment = buildConfoundAssessment(all, sideA, sideB, args.comparisonAxis);
216
+ return respond(args.outputFormat, { confounds: assessment }, renderConfounds(assessment));
217
+ }
218
+ catch (e) {
219
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
220
+ }
221
+ });
222
+ // ── detect_performance_outliers ───────────────────────────────────────────
223
+ server.tool('detect_performance_outliers', 'Flag outlier transactions within a SINGLE set using a robust median/MAD modified z-score (default threshold ' +
224
+ '3.5). Returns each transaction with its score, the kept set, and the recommended exclusions — use it to decide ' +
225
+ 'which samples to re-run or drop before computing a comparison aggregate. Robust for the small samples (N=5–10) ' +
226
+ 'this workflow uses, where one bad run would inflate a standard-deviation bound enough to hide itself. ' +
227
+ 'All access levels — project keys see only their own project\'s transactions.', {
228
+ label: z.string().optional().default('set').describe('Optional label for the set in output.'),
229
+ transactionIds: z.array(z.number().int()).optional().describe('Explicit transaction IDs. Provide this OR filter.'),
230
+ filter: sideFilterSchema.describe('Filter selecting the transactions (used when transactionIds is omitted).'),
231
+ metric: metricEnum.optional().default('speedIndex').describe('Metric to test for outliers. Default speedIndex.'),
232
+ outlierK: z.number().min(1).optional().default(3.5).describe('Modified z-score threshold. Default 3.5.'),
233
+ outputFormat: outputFormatParam,
234
+ }, async (args) => {
235
+ try {
236
+ const sel = buildSide(args.label ?? 'set', args.transactionIds, args.filter);
237
+ const all = await gatherPool([sel]);
238
+ const report = buildOutlierReport(all, sel, args.metric, args.outlierK);
239
+ const lines = [
240
+ `🔍 Outlier scan on ${METRIC_LABEL[report.metric] ?? report.metric} (${report.unit}) — "${args.label}"`,
241
+ ` median=${num(report.median)} scaledMAD=${num(report.madScaled)} threshold=±${report.threshold}` +
242
+ (report.degenerate ? ' (MAD=0: >50% identical values — no scoring possible)' : ''),
243
+ '',
244
+ ];
245
+ for (const e of report.entries) {
246
+ lines.push(` ${e.isOutlier ? '⛔' : ' '} tx ${e.transactionId} (${e.deviceName}): ${num(e.value)} ${report.unit} z=${num(e.score, 2)}${e.isOutlier ? ' ← OUTLIER' : ''}`);
247
+ }
248
+ if (report.missingMetricIds.length) {
249
+ lines.push('', ` ⚠️ No ${report.metric} value: ${report.missingMetricIds.join(', ')}`);
250
+ }
251
+ lines.push('', ` Keep: ${report.keptTransactionIds.join(', ') || '—'}`);
252
+ if (report.outlierTransactionIds.length)
253
+ lines.push(` Exclude/re-run: ${report.outlierTransactionIds.join(', ')}`);
254
+ return respond(args.outputFormat, { outliers: report }, lines.join('\n'));
255
+ }
256
+ catch (e) {
257
+ return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
258
+ }
259
+ });
260
+ // ── performance_transaction_control (phase 2 — generate fresh samples) ─────
261
+ server.tool('performance_transaction_control', 'Generate a FRESH performance transaction inside a live inspection session (start_inspection_session). ' +
262
+ 'Call action:"start" with a networkProfile, then perform ONLY the UI steps you want measured using the normal ' +
263
+ 'tap_element / type_into_element / launch_app tools, then call action:"end" with a transactionName. The platform ' +
264
+ 'records CPU/memory/battery/network + Speed Index for the window between start and end. ' +
265
+ 'Use networkProfile:"Monitor" to measure current performance WITHOUT throttling (the usual choice); only pass a ' +
266
+ 'throttling profile ("3G-average", "wifi", …) when constrained network conditions ARE what you want to measure. ' +
267
+ 'WORKFLOW for a comparison sample series: per comparison point, repeat [start → run the SAME verified flow → end] ' +
268
+ 'N times. The flow MUST be verified first (real selectors from get_element_tree — never fabricated), or every ' +
269
+ 'sample is garbage. ' +
270
+ 'PRE-REQUISITE: the NV server for the device\'s region must be ONLINE and tunnel-connected — verify with ' +
271
+ 'list_nv_servers(region=<device region>) BEFORE starting, or the transaction silently records nothing. ' +
272
+ 'CAVEATS: (1) a THROTTLING profile activates NV shaping immediately — an app doing background network on the ' +
273
+ 'measured screen may ANR; keep the window tight. "Monitor" is pass-through and carries no such risk. ' +
274
+ '(2) The recorded transaction appears in the reporter ~1 minute AFTER end (not instantly) — wait, then read it ' +
275
+ 'with list_transactions(transactionName, deviceName, startDate) → get_transaction. ' +
276
+ '(3) networkProfile must exist on the NV server ("Monitor" is broadly guaranteed; others are deployment-specific). ' +
277
+ 'All access levels — project keys see only their own project\'s transactions.', {
278
+ handle: z.string().describe('Inspection session handle from start_inspection_session.'),
279
+ action: z.enum(['start', 'end']).describe('"start" begins measurement (needs networkProfile); "end" finalizes it (needs transactionName).'),
280
+ networkProfile: z.string().optional().describe('NV network profile for action:"start". Use "Monitor" to observe without throttling (default choice); "3G-average"/"wifi" apply network conditions. Required to start; must exist on the NV server.'),
281
+ transactionName: z.string().optional().describe('Name for action:"end", e.g. "Login". This is how you find the record afterward via list_transactions.'),
282
+ }, async (args) => {
283
+ try {
284
+ const result = await performanceTransaction(args.handle, args.action, {
285
+ networkProfile: args.networkProfile,
286
+ transactionName: args.transactionName,
287
+ });
288
+ return { content: [{ type: 'text', text: `✅ ${result}` }] };
289
+ }
290
+ catch (e) {
291
+ return { content: [{ type: 'text', text: `Error (${args.action} performance transaction): ${e.message}` }], isError: true };
292
+ }
293
+ });
294
+ }
295
+ //# sourceMappingURL=performance-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"performance-tools.js","sourceRoot":"","sources":["../../src/tools/performance-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 registerProjectTools(server: McpServer): void;
3
+ //# sourceMappingURL=project-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-tools.d.ts","sourceRoot":"","sources":["../../src/tools/project-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAirB5D"}