digital-ai-testing-mcp 1.2.7 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/README.md +161 -56
  2. package/dist/api/access-level.d.ts +46 -0
  3. package/dist/api/access-level.d.ts.map +1 -0
  4. package/dist/api/access-level.js +183 -0
  5. package/dist/api/access-level.js.map +1 -0
  6. package/dist/api/agents.js +1 -1
  7. package/dist/api/agents.js.map +1 -1
  8. package/dist/api/browser-inspection.d.ts.map +1 -1
  9. package/dist/api/browser-inspection.js +18 -17
  10. package/dist/api/browser-inspection.js.map +1 -1
  11. package/dist/api/client.d.ts +14 -2
  12. package/dist/api/client.d.ts.map +1 -1
  13. package/dist/api/client.js +60 -43
  14. package/dist/api/client.js.map +1 -1
  15. package/dist/api/device-groups.js +1 -1
  16. package/dist/api/device-groups.js.map +1 -1
  17. package/dist/api/license.js +1 -1
  18. package/dist/api/license.js.map +1 -1
  19. package/dist/api/nv-servers.js +1 -1
  20. package/dist/api/nv-servers.js.map +1 -1
  21. package/dist/api/projects.d.ts +16 -3
  22. package/dist/api/projects.d.ts.map +1 -1
  23. package/dist/api/projects.js +60 -18
  24. package/dist/api/projects.js.map +1 -1
  25. package/dist/api/regions.js +1 -1
  26. package/dist/api/regions.js.map +1 -1
  27. package/dist/api/reporter-projects.d.ts.map +1 -1
  28. package/dist/api/reporter-projects.js +2 -1
  29. package/dist/api/reporter-projects.js.map +1 -1
  30. package/dist/api/reporting.d.ts +91 -0
  31. package/dist/api/reporting.d.ts.map +1 -1
  32. package/dist/api/reporting.js +220 -22
  33. package/dist/api/reporting.js.map +1 -1
  34. package/dist/api/sessions.js +1 -1
  35. package/dist/api/sessions.js.map +1 -1
  36. package/dist/api/test-orchestrator.d.ts +59 -0
  37. package/dist/api/test-orchestrator.d.ts.map +1 -0
  38. package/dist/api/test-orchestrator.js +126 -0
  39. package/dist/api/test-orchestrator.js.map +1 -0
  40. package/dist/api/test-runs.d.ts +80 -0
  41. package/dist/api/test-runs.d.ts.map +1 -0
  42. package/dist/api/test-runs.js +209 -0
  43. package/dist/api/test-runs.js.map +1 -0
  44. package/dist/api/test-views.d.ts.map +1 -1
  45. package/dist/api/test-views.js +5 -1
  46. package/dist/api/test-views.js.map +1 -1
  47. package/dist/api/transactions.d.ts +6 -0
  48. package/dist/api/transactions.d.ts.map +1 -1
  49. package/dist/api/transactions.js +19 -3
  50. package/dist/api/transactions.js.map +1 -1
  51. package/dist/api/usage-reports.d.ts.map +1 -1
  52. package/dist/api/usage-reports.js +3 -3
  53. package/dist/api/usage-reports.js.map +1 -1
  54. package/dist/api/webdriver.d.ts +39 -1
  55. package/dist/api/webdriver.d.ts.map +1 -1
  56. package/dist/api/webdriver.js +177 -71
  57. package/dist/api/webdriver.js.map +1 -1
  58. package/dist/index.js +82 -33
  59. package/dist/index.js.map +1 -1
  60. package/dist/tools/agent-tools.js +2 -2
  61. package/dist/tools/agent-tools.js.map +1 -1
  62. package/dist/tools/application-tools.d.ts.map +1 -1
  63. package/dist/tools/application-tools.js +17 -10
  64. package/dist/tools/application-tools.js.map +1 -1
  65. package/dist/tools/boilerplate-tools.d.ts +3 -0
  66. package/dist/tools/boilerplate-tools.d.ts.map +1 -1
  67. package/dist/tools/boilerplate-tools.js +302 -21
  68. package/dist/tools/boilerplate-tools.js.map +1 -1
  69. package/dist/tools/browser-tools.d.ts.map +1 -1
  70. package/dist/tools/browser-tools.js +8 -5
  71. package/dist/tools/browser-tools.js.map +1 -1
  72. package/dist/tools/debug-tools.d.ts.map +1 -1
  73. package/dist/tools/debug-tools.js +6 -3
  74. package/dist/tools/debug-tools.js.map +1 -1
  75. package/dist/tools/device-group-tools.js +5 -5
  76. package/dist/tools/device-group-tools.js.map +1 -1
  77. package/dist/tools/device-tools.d.ts.map +1 -1
  78. package/dist/tools/device-tools.js +5 -4
  79. package/dist/tools/device-tools.js.map +1 -1
  80. package/dist/tools/health-tools.d.ts.map +1 -1
  81. package/dist/tools/health-tools.js +6 -5
  82. package/dist/tools/health-tools.js.map +1 -1
  83. package/dist/tools/inspection-tools.d.ts.map +1 -1
  84. package/dist/tools/inspection-tools.js +122 -22
  85. package/dist/tools/inspection-tools.js.map +1 -1
  86. package/dist/tools/meta-tools.d.ts +4 -1
  87. package/dist/tools/meta-tools.d.ts.map +1 -1
  88. package/dist/tools/meta-tools.js +87 -58
  89. package/dist/tools/meta-tools.js.map +1 -1
  90. package/dist/tools/performance-tools.d.ts.map +1 -1
  91. package/dist/tools/performance-tools.js +2 -8
  92. package/dist/tools/performance-tools.js.map +1 -1
  93. package/dist/tools/project-tools.d.ts.map +1 -1
  94. package/dist/tools/project-tools.js +38 -19
  95. package/dist/tools/project-tools.js.map +1 -1
  96. package/dist/tools/provisioning-profile-tools.d.ts.map +1 -1
  97. package/dist/tools/provisioning-profile-tools.js +5 -4
  98. package/dist/tools/provisioning-profile-tools.js.map +1 -1
  99. package/dist/tools/remediation-tools.d.ts +7 -0
  100. package/dist/tools/remediation-tools.d.ts.map +1 -0
  101. package/dist/tools/remediation-tools.js +50 -0
  102. package/dist/tools/remediation-tools.js.map +1 -0
  103. package/dist/tools/reporting-tools.d.ts.map +1 -1
  104. package/dist/tools/reporting-tools.js +393 -147
  105. package/dist/tools/reporting-tools.js.map +1 -1
  106. package/dist/tools/repository-tools.d.ts.map +1 -1
  107. package/dist/tools/repository-tools.js +5 -4
  108. package/dist/tools/repository-tools.js.map +1 -1
  109. package/dist/tools/reservation-tools.js +2 -2
  110. package/dist/tools/reservation-tools.js.map +1 -1
  111. package/dist/tools/resources.js +2 -2
  112. package/dist/tools/resources.js.map +1 -1
  113. package/dist/tools/test-run-tools.d.ts +3 -0
  114. package/dist/tools/test-run-tools.d.ts.map +1 -0
  115. package/dist/tools/test-run-tools.js +284 -0
  116. package/dist/tools/test-run-tools.js.map +1 -0
  117. package/dist/tools/test-view-tools.d.ts.map +1 -1
  118. package/dist/tools/test-view-tools.js +11 -11
  119. package/dist/tools/test-view-tools.js.map +1 -1
  120. package/dist/tools/toolset-tools.d.ts +8 -0
  121. package/dist/tools/toolset-tools.d.ts.map +1 -0
  122. package/dist/tools/toolset-tools.js +40 -0
  123. package/dist/tools/toolset-tools.js.map +1 -0
  124. package/dist/tools/transaction-tools.d.ts.map +1 -1
  125. package/dist/tools/transaction-tools.js +17 -7
  126. package/dist/tools/transaction-tools.js.map +1 -1
  127. package/dist/tools/usage-report-tools.d.ts.map +1 -1
  128. package/dist/tools/usage-report-tools.js +43 -15
  129. package/dist/tools/usage-report-tools.js.map +1 -1
  130. package/dist/tools/user-tools.js +2 -2
  131. package/dist/tools/user-tools.js.map +1 -1
  132. package/dist/tools/web-inspection-tools.d.ts.map +1 -1
  133. package/dist/tools/web-inspection-tools.js +45 -33
  134. package/dist/tools/web-inspection-tools.js.map +1 -1
  135. package/dist/tools/workflow-tools.js +1 -1
  136. package/dist/types/digital-ai.d.ts +19 -1
  137. package/dist/types/digital-ai.d.ts.map +1 -1
  138. package/dist/utils/access-level.d.ts +39 -0
  139. package/dist/utils/access-level.d.ts.map +1 -0
  140. package/dist/utils/access-level.js +111 -0
  141. package/dist/utils/access-level.js.map +1 -0
  142. package/dist/utils/browser-name.d.ts +2 -0
  143. package/dist/utils/browser-name.d.ts.map +1 -0
  144. package/dist/utils/browser-name.js +19 -0
  145. package/dist/utils/browser-name.js.map +1 -0
  146. package/dist/utils/command-payload.d.ts +19 -0
  147. package/dist/utils/command-payload.d.ts.map +1 -0
  148. package/dist/utils/command-payload.js +13 -0
  149. package/dist/utils/command-payload.js.map +1 -0
  150. package/dist/utils/csv.d.ts +6 -0
  151. package/dist/utils/csv.d.ts.map +1 -1
  152. package/dist/utils/csv.js +28 -2
  153. package/dist/utils/csv.js.map +1 -1
  154. package/dist/utils/download-command.d.ts.map +1 -1
  155. package/dist/utils/download-command.js +5 -4
  156. package/dist/utils/download-command.js.map +1 -1
  157. package/dist/utils/locality.d.ts +7 -0
  158. package/dist/utils/locality.d.ts.map +1 -1
  159. package/dist/utils/locality.js +19 -0
  160. package/dist/utils/locality.js.map +1 -1
  161. package/dist/utils/maestro-flow.d.ts +38 -0
  162. package/dist/utils/maestro-flow.d.ts.map +1 -0
  163. package/dist/utils/maestro-flow.js +114 -0
  164. package/dist/utils/maestro-flow.js.map +1 -0
  165. package/dist/utils/metric-semantics.d.ts +22 -0
  166. package/dist/utils/metric-semantics.d.ts.map +1 -0
  167. package/dist/utils/metric-semantics.js +24 -0
  168. package/dist/utils/metric-semantics.js.map +1 -0
  169. package/dist/utils/pagination.d.ts +11 -0
  170. package/dist/utils/pagination.d.ts.map +1 -1
  171. package/dist/utils/pagination.js +16 -0
  172. package/dist/utils/pagination.js.map +1 -1
  173. package/dist/utils/path-guard.js +1 -1
  174. package/dist/utils/path-guard.js.map +1 -1
  175. package/dist/utils/profile-loader.d.ts +4 -2
  176. package/dist/utils/profile-loader.d.ts.map +1 -1
  177. package/dist/utils/profile-loader.js +5 -4
  178. package/dist/utils/profile-loader.js.map +1 -1
  179. package/dist/utils/remediation.d.ts +113 -0
  180. package/dist/utils/remediation.d.ts.map +1 -0
  181. package/dist/utils/remediation.js +392 -0
  182. package/dist/utils/remediation.js.map +1 -0
  183. package/dist/utils/report-ref.d.ts +23 -0
  184. package/dist/utils/report-ref.d.ts.map +1 -0
  185. package/dist/utils/report-ref.js +31 -0
  186. package/dist/utils/report-ref.js.map +1 -0
  187. package/dist/utils/response-formatter.d.ts +2 -1
  188. package/dist/utils/response-formatter.d.ts.map +1 -1
  189. package/dist/utils/response-formatter.js +32 -21
  190. package/dist/utils/response-formatter.js.map +1 -1
  191. package/dist/utils/test-orchestrator.d.ts +102 -0
  192. package/dist/utils/test-orchestrator.d.ts.map +1 -0
  193. package/dist/utils/test-orchestrator.js +236 -0
  194. package/dist/utils/test-orchestrator.js.map +1 -0
  195. package/dist/utils/test-status.d.ts +48 -0
  196. package/dist/utils/test-status.d.ts.map +1 -0
  197. package/dist/utils/test-status.js +92 -0
  198. package/dist/utils/test-status.js.map +1 -0
  199. package/dist/utils/tool-catalog.d.ts +6 -0
  200. package/dist/utils/tool-catalog.d.ts.map +1 -0
  201. package/dist/utils/tool-catalog.js +15 -0
  202. package/dist/utils/tool-catalog.js.map +1 -0
  203. package/dist/utils/toolsets.d.ts +79 -0
  204. package/dist/utils/toolsets.d.ts.map +1 -0
  205. package/dist/utils/toolsets.js +156 -0
  206. package/dist/utils/toolsets.js.map +1 -0
  207. package/dist/utils/upload-command.d.ts.map +1 -1
  208. package/dist/utils/upload-command.js +5 -4
  209. package/dist/utils/upload-command.js.map +1 -1
  210. package/dist/utils/usage-report-guard.d.ts +7 -0
  211. package/dist/utils/usage-report-guard.d.ts.map +1 -1
  212. package/dist/utils/usage-report-guard.js +18 -1
  213. package/dist/utils/usage-report-guard.js.map +1 -1
  214. package/dist/utils/usage-report-summary.d.ts +12 -0
  215. package/dist/utils/usage-report-summary.d.ts.map +1 -1
  216. package/dist/utils/usage-report-summary.js +25 -6
  217. package/dist/utils/usage-report-summary.js.map +1 -1
  218. package/package.json +40 -4
  219. package/resources/boilerplate/Android-Native/Java JUnit5/gradle +6 -1
  220. package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +6 -1
  221. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +2 -2
  222. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +2 -2
  223. package/resources/boilerplate/Android-Native/java TestNG/gradle +1 -1
  224. package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +1 -1
  225. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle +6 -1
  226. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +6 -1
  227. package/resources/boilerplate/iOS-Native/java-TestNG/gradle +1 -1
  228. package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +1 -1
  229. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +2 -2
  230. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +2 -2
  231. package/resources/test-orchestrator/agent.json +19 -0
@@ -0,0 +1,6 @@
1
+ export declare function setToolCatalog(tools: ReadonlyArray<{
2
+ module: string;
3
+ name: string;
4
+ }>): void;
5
+ export declare function getToolCatalog(): ReadonlyMap<string, readonly string[]>;
6
+ //# sourceMappingURL=tool-catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/utils/tool-catalog.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAG3F;AAED,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAEvE"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Which tools each module registered — filled once at startup from the captured registrations (src/index.ts), so
3
+ * get_server_info reports real per-area counts instead of hand-maintained numbers that drift (they had: "Reporting —
4
+ * 17 tools" while 23 were registered, and whole areas such as test runs were missing).
5
+ */
6
+ const catalog = new Map();
7
+ export function setToolCatalog(tools) {
8
+ catalog.clear();
9
+ for (const { module, name } of tools)
10
+ catalog.set(module, [...(catalog.get(module) ?? []), name]);
11
+ }
12
+ export function getToolCatalog() {
13
+ return catalog;
14
+ }
15
+ //# sourceMappingURL=tool-catalog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-catalog.js","sourceRoot":"","sources":["../../src/utils/tool-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE5C,MAAM,UAAU,cAAc,CAAC,KAAsD;IACnF,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,79 @@
1
+ /**
2
+ * Opt-in toolsets (MCP_TOOLSETS) — cut the context cost of 200 tool definitions WITHOUT weakening the guidance that
3
+ * keeps agents using them correctly.
4
+ *
5
+ * Design constraint (the fidelity concern): many past misuse fixes live in tool descriptions, and descriptions
6
+ * cross-reference each other densely ("install_application first", "then start_inspection_session", prompts that walk
7
+ * five tools). Measured 2026-10-09: a transitive closure over those references pulls 69–79% of all tools into ANY
8
+ * single toolset, so "load only these tools" either saves nothing or leaves guidance pointing at tools that do not exist.
9
+ *
10
+ * So nothing is ever removed. Every tool stays registered under its real name:
11
+ * - tools in a selected toolset (and the core) keep their full description and parameters;
12
+ * - every other tool becomes a SELF-LOADING PLACEHOLDER: a one-line description, no parameters. Calling it loads its
13
+ * whole toolset on the spot (full definitions restored; clients that support tools/list_changed refresh) and returns
14
+ * the tool's FULL description and parameter guidance in the response, asking the agent to call it again — so the
15
+ * guidance arrives at the moment of use, before the real call runs.
16
+ * - Server instructions and prompts are unchanged; every name they mention exists.
17
+ * Unset / "all" registers everything in full — zero behaviour change for existing installs.
18
+ */
19
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
20
+ export type RegisterFn = (server: McpServer) => void;
21
+ export interface CapturedTool {
22
+ name: string;
23
+ module: string;
24
+ description: string;
25
+ shape: Record<string, unknown>;
26
+ callback: (...a: unknown[]) => unknown;
27
+ args: unknown[];
28
+ }
29
+ export interface CapturedOther {
30
+ module: string;
31
+ args: unknown[];
32
+ }
33
+ export interface Captured {
34
+ tools: CapturedTool[];
35
+ prompts: CapturedOther[];
36
+ resources: CapturedOther[];
37
+ }
38
+ /** Run every register function against a recorder; nothing reaches a real server. */
39
+ export declare function captureRegistrations(modules: Array<[string, RegisterFn]>): Captured;
40
+ /** User-facing toolsets → tool modules. Every tool module except the core belongs to exactly one toolset. */
41
+ export declare const TOOLSETS: Record<string, {
42
+ modules: string[];
43
+ description: string;
44
+ }>;
45
+ /** Always loaded in full: connection/environment basics, toolset control, and the test-delivery backstop. */
46
+ export declare const CORE_MODULES: string[];
47
+ export declare const CORE_TOOLS: string[];
48
+ export declare function toolsetOfModule(module: string): string | null;
49
+ export interface Selection {
50
+ all: boolean;
51
+ toolsets: Set<string>;
52
+ unknown: string[];
53
+ }
54
+ export declare function parseToolsetSelection(raw: string | undefined): Selection;
55
+ /** "name (required): description" lines for a zod raw shape — the parameter guidance a placeholder hands back. */
56
+ export declare function describeShape(shape: Record<string, unknown>): string[];
57
+ /** Kept short — it repeats for every unloaded tool. enable_toolset's description explains the mechanism in full. */
58
+ export declare function placeholderDescription(tool: CapturedTool, toolset: string): string;
59
+ export interface ToolsetController {
60
+ /** Toolsets currently loaded in full (all toolsets when selection.all). */
61
+ loaded(): string[];
62
+ /** Load toolsets in full. Returns the tool names that changed from placeholder to full. */
63
+ enable(toolsets: string[]): string[];
64
+ /** Per-toolset summary for get_server_info / enable_toolset. */
65
+ summary(): Array<{
66
+ toolset: string;
67
+ description: string;
68
+ loaded: boolean;
69
+ tools: number;
70
+ }>;
71
+ }
72
+ /**
73
+ * Register every captured tool (full or placeholder), then prompts and resources, onto the real server.
74
+ * Placeholder-to-full restores use RegisteredTool.update(), which emits notifications/tools/list_changed.
75
+ */
76
+ /** Optional callback wrapper (debug mode instruments every tool and placeholder through this). */
77
+ export type ToolWrapper = (name: string, callback: (...a: unknown[]) => unknown, placeholder: boolean) => (...a: unknown[]) => unknown;
78
+ export declare function registerWithToolsets(server: McpServer, captured: Captured, selection: Selection, wrap?: ToolWrapper): ToolsetController;
79
+ //# sourceMappingURL=toolsets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolsets.d.ts","sourceRoot":"","sources":["../../src/utils/toolsets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yCAAyC,CAAC;AAEzF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAErD,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE;AAC5K,MAAM,WAAW,aAAa;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE;AAClE,MAAM,WAAW,QAAQ;IAAG,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,EAAE,aAAa,EAAE,CAAA;CAAE;AAEzG,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,QAAQ,CAkBnF;AAED,6GAA6G;AAC7G,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAS/E,CAAC;AAEF,6GAA6G;AAC7G,eAAO,MAAM,YAAY,UAAuB,CAAC;AACjD,eAAO,MAAM,UAAU,UAA2B,CAAC;AAEnD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,MAAM,WAAW,SAAS;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AAErF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAYxE;AAED,kHAAkH;AAClH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAUtE;AASD,oHAAoH;AACpH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,MAAM,IAAI,MAAM,EAAE,CAAC;IACnB,2FAA2F;IAC3F,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACrC,gEAAgE;IAChE,OAAO,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5F;AAED;;;GAGG;AACH,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEvI,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAqEvI"}
@@ -0,0 +1,156 @@
1
+ /** Run every register function against a recorder; nothing reaches a real server. */
2
+ export function captureRegistrations(modules) {
3
+ const captured = { tools: [], prompts: [], resources: [] };
4
+ for (const [module, register] of modules) {
5
+ const recorder = {
6
+ tool: (...args) => {
7
+ // Every tool module uses server.tool(name, description, shape, callback).
8
+ const [name, description, shape, callback] = args;
9
+ if (typeof name !== 'string' || typeof description !== 'string' || typeof callback !== 'function') {
10
+ throw new Error(`toolsets: unsupported server.tool signature in module ${module} (${String(name)})`);
11
+ }
12
+ captured.tools.push({ name, module, description, shape: shape ?? {}, callback, args });
13
+ },
14
+ prompt: (...args) => { captured.prompts.push({ module, args }); },
15
+ resource: (...args) => { captured.resources.push({ module, args }); },
16
+ };
17
+ register(recorder);
18
+ }
19
+ return captured;
20
+ }
21
+ /** User-facing toolsets → tool modules. Every tool module except the core belongs to exactly one toolset. */
22
+ export const TOOLSETS = {
23
+ devices: { modules: ['devices', 'device-groups', 'reservations', 'health', 'agents', 'regions'], description: 'devices, device groups, reservations, health, agents, regions' },
24
+ apps: { modules: ['applications', 'repository', 'provisioning-profiles'], description: 'application repository, file repository, provisioning profiles' },
25
+ reporting: { modules: ['reporting', 'test-views', 'coverage'], description: 'test reports, analytics, root-cause analysis, test views, coverage' },
26
+ performance: { modules: ['transactions', 'performance', 'nv-servers'], description: 'performance transactions and comparisons, NV servers' },
27
+ inspection: { modules: ['inspection', 'web-inspection', 'debug'], description: 'live device and browser inspection sessions, Android Auto/CarPlay, remote debug' },
28
+ authoring: { modules: ['boilerplate', 'test-runs'], description: 'test boilerplate, Espresso/XCUITest/Maestro test runs' },
29
+ browsers: { modules: ['browsers'], description: 'browser listing and Selenium sessions' },
30
+ admin: { modules: ['users', 'projects', 'backup', 'usage-reports', 'workflows'], description: 'users, projects, backups, usage reports, POC/project workflows' },
31
+ };
32
+ /** Always loaded in full: connection/environment basics, toolset control, and the test-delivery backstop. */
33
+ export const CORE_MODULES = ['meta', 'toolsets'];
34
+ export const CORE_TOOLS = ['validate_test_script'];
35
+ export function toolsetOfModule(module) {
36
+ for (const [name, t] of Object.entries(TOOLSETS))
37
+ if (t.modules.includes(module))
38
+ return name;
39
+ return null;
40
+ }
41
+ export function parseToolsetSelection(raw) {
42
+ const tokens = (raw ?? '').split(',').map((t) => t.trim().toLowerCase()).filter(Boolean);
43
+ if (tokens.length === 0 || tokens.includes('all'))
44
+ return { all: true, toolsets: new Set(Object.keys(TOOLSETS)), unknown: [] };
45
+ const toolsets = new Set();
46
+ const unknown = [];
47
+ // "core" = only the always-loaded core in full (every other tool is a placeholder) — the maximum-savings setting.
48
+ for (const t of tokens) {
49
+ if (t === 'core')
50
+ continue;
51
+ if (TOOLSETS[t])
52
+ toolsets.add(t);
53
+ else
54
+ unknown.push(t);
55
+ }
56
+ return { all: false, toolsets, unknown };
57
+ }
58
+ /** "name (required): description" lines for a zod raw shape — the parameter guidance a placeholder hands back. */
59
+ export function describeShape(shape) {
60
+ const lines = [];
61
+ for (const [key, node] of Object.entries(shape)) {
62
+ let n = node;
63
+ let description = n?.description;
64
+ while (!description && n?._def?.innerType) {
65
+ n = n._def.innerType;
66
+ description = n?.description;
67
+ }
68
+ const optional = typeof node?.isOptional === 'function' && node.isOptional();
69
+ lines.push(`- ${key}${optional ? '' : ' (required)'}: ${description ?? ''}`.trimEnd());
70
+ }
71
+ return lines;
72
+ }
73
+ function firstSentence(text, max = 150) {
74
+ const s = text.replace(/\s+/g, ' ').trim();
75
+ const end = s.search(/[.!?](\s|$)/);
76
+ const one = end > 0 ? s.slice(0, end + 1) : s;
77
+ return one.length > max ? `${one.slice(0, max - 1)}…` : one;
78
+ }
79
+ /** Kept short — it repeats for every unloaded tool. enable_toolset's description explains the mechanism in full. */
80
+ export function placeholderDescription(tool, toolset) {
81
+ return `[${toolset} toolset — loads on first call] ${firstSentence(tool.description, 120)}`;
82
+ }
83
+ export function registerWithToolsets(server, captured, selection, wrap) {
84
+ const s = server;
85
+ const loaded = new Set(selection.toolsets);
86
+ const handles = new Map();
87
+ const isFull = (t, toolset) => selection.all || CORE_MODULES.includes(t.module) || CORE_TOOLS.includes(t.name) || toolset == null || loaded.has(toolset);
88
+ const controller = {
89
+ loaded: () => [...loaded].sort(),
90
+ enable(toolsets) {
91
+ const changed = [];
92
+ // RegisteredTool.update() notifies the client once PER TOOL (44 notifications for one toolset, observed live).
93
+ // Silence it for the batch and send a single tools/list_changed at the end.
94
+ const srv = server;
95
+ const notify = srv.sendToolListChanged;
96
+ srv.sendToolListChanged = () => { };
97
+ try {
98
+ for (const ts of toolsets) {
99
+ if (!TOOLSETS[ts] || loaded.has(ts))
100
+ continue;
101
+ loaded.add(ts);
102
+ for (const { tool, handle, toolset } of handles.values()) {
103
+ if (toolset !== ts || CORE_TOOLS.includes(tool.name))
104
+ continue;
105
+ handle.update({ description: tool.description, paramsSchema: tool.shape, callback: (wrap ? wrap(tool.name, tool.callback, false) : tool.callback) });
106
+ changed.push(tool.name);
107
+ }
108
+ }
109
+ }
110
+ finally {
111
+ srv.sendToolListChanged = notify;
112
+ }
113
+ if (changed.length)
114
+ notify.call(server);
115
+ return changed;
116
+ },
117
+ summary() {
118
+ return Object.entries(TOOLSETS).map(([toolset, t]) => ({
119
+ toolset,
120
+ description: t.description,
121
+ loaded: loaded.has(toolset),
122
+ tools: captured.tools.filter((x) => t.modules.includes(x.module)).length,
123
+ }));
124
+ },
125
+ };
126
+ for (const tool of captured.tools) {
127
+ const toolset = toolsetOfModule(tool.module);
128
+ if (isFull(tool, toolset)) {
129
+ const args = wrap ? [...tool.args.slice(0, -1), wrap(tool.name, tool.callback, false)] : tool.args;
130
+ handles.set(tool.name, { tool, handle: s.tool(...args), toolset });
131
+ continue;
132
+ }
133
+ const ts = toolset;
134
+ const placeholder = async () => {
135
+ controller.enable([ts]);
136
+ const guidance = [
137
+ `The "${ts}" toolset (${TOOLSETS[ts].description}) was not loaded in this server; it is loaded now.`,
138
+ `Nothing was executed. Read ${tool.name}'s full guidance below, then call ${tool.name} again with its parameters.`,
139
+ '',
140
+ `${tool.name} — full description:`,
141
+ tool.description,
142
+ '',
143
+ 'Parameters:',
144
+ ...describeShape(tool.shape),
145
+ ].join('\n');
146
+ return { content: [{ type: 'text', text: guidance }] };
147
+ };
148
+ handles.set(tool.name, { tool, handle: s.tool(tool.name, placeholderDescription(tool, ts), {}, wrap ? wrap(tool.name, placeholder, true) : placeholder), toolset });
149
+ }
150
+ for (const p of captured.prompts)
151
+ s.prompt(...p.args);
152
+ for (const r of captured.resources)
153
+ s.resource(...r.args);
154
+ return controller;
155
+ }
156
+ //# sourceMappingURL=toolsets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolsets.js","sourceRoot":"","sources":["../../src/utils/toolsets.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"upload-command.d.ts","sourceRoot":"","sources":["../../src/utils/upload-command.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/B,uDAAuD;IACvD,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,mGAAmG;IACnG,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CA0D/E"}
1
+ {"version":3,"file":"upload-command.d.ts","sourceRoot":"","sources":["../../src/utils/upload-command.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/B,uDAAuD;IACvD,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,mGAAmG;IACnG,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,CA2D/E"}
@@ -1,13 +1,14 @@
1
- import { getActiveAccessKey, getActiveUrl, getActiveKeyType } from '../api/client.js';
1
+ import { getActiveAccessKey, getActiveUrl, getActiveAuthScheme } from '../api/client.js';
2
2
  export function buildUploadCommand(spec) {
3
3
  const accessKey = getActiveAccessKey();
4
4
  const baseUrl = getActiveUrl();
5
- const isJwt = getActiveKeyType() === 'jwt';
5
+ // Header scheme only (how the credential is presented) — NOT a privilege check.
6
+ const bearerOnly = getActiveAuthScheme() === 'bearer';
6
7
  const isWindows = spec.localPlatform === 'windows';
7
8
  const endpoint = `${baseUrl}${spec.path}`;
8
9
  // curl — works on macOS, Linux, Git Bash, and WSL
9
10
  const curlLines = ['curl -X POST \\'];
10
- if (isJwt) {
11
+ if (bearerOnly) {
11
12
  curlLines.push(` -H "Authorization: Bearer ${accessKey}" \\`);
12
13
  }
13
14
  else {
@@ -23,7 +24,7 @@ export function buildUploadCommand(spec) {
23
24
  const curlCommand = curlLines.join('\n');
24
25
  // PowerShell (Invoke-RestMethod) — Windows native
25
26
  const psLines = ['$headers = @{'];
26
- if (isJwt) {
27
+ if (bearerOnly) {
27
28
  psLines.push(` "Authorization" = "Bearer ${accessKey}"`);
28
29
  }
29
30
  else {
@@ -1 +1 @@
1
- {"version":3,"file":"upload-command.js","sourceRoot":"","sources":["../../src/utils/upload-command.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"upload-command.js","sourceRoot":"","sources":["../../src/utils/upload-command.ts"],"names":[],"mappings":"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"}
@@ -44,5 +44,12 @@ export declare function validateUsageReportParams(params: UsageReportParams): st
44
44
  * anticipated it. Returns null when the request may proceed.
45
45
  */
46
46
  export declare function checkUsageReportSizeGuard(params: UsageReportParams): string | null;
47
+ /** Platform 25.9+ keeps usage data for 2 years; older rows are purged rather than returned. */
48
+ export declare const USAGE_RETENTION_DAYS = 730;
49
+ /**
50
+ * Non-blocking note when the range starts before the retention window — the export still succeeds but silently omits
51
+ * the purged period, which reads as "no usage" unless the caller is told. Returns null when the range is inside it.
52
+ */
53
+ export declare function usageReportRetentionNote(startDate: string, now?: number): string | null;
47
54
  export {};
48
55
  //# sourceMappingURL=usage-report-guard.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"usage-report-guard.d.ts","sourceRoot":"","sources":["../../src/utils/usage-report-guard.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAC;AAEpB,UAAU,kBAAkB;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAO1E,CAAC;AAKF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAInF;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAiBlF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CA8BlF"}
1
+ {"version":3,"file":"usage-report-guard.d.ts","sourceRoot":"","sources":["../../src/utils/usage-report-guard.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAC;AAEpB,UAAU,kBAAkB;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAO1E,CAAC;AAKF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAInF;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAiBlF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAgClF;AAED,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CASnG"}
@@ -82,7 +82,24 @@ export function checkUsageReportSizeGuard(params) {
82
82
  `(measured live: an unfiltered month of License Usage was ~27 MB; an unfiltered week of Device Reservations ` +
83
83
  `was ~6.4 MB). A multi-month or full-year unfiltered export can run into the hundreds of MB and take minutes.\n\n` +
84
84
  `${narrowingAdvice}\n\n` +
85
- `To proceed anyway, include confirmLargeExport: true in your request.\n\n` +
85
+ `Ask the user before going further: offer to narrow the request, or tell them the export may be very large and ` +
86
+ `slow and ask whether to proceed. Set confirmLargeExport: true ONLY after the user explicitly agrees to the large ` +
87
+ `export — never decide it on their behalf.\n\n` +
86
88
  `No download was attempted.`);
87
89
  }
90
+ /** Platform 25.9+ keeps usage data for 2 years; older rows are purged rather than returned. */
91
+ export const USAGE_RETENTION_DAYS = 730;
92
+ /**
93
+ * Non-blocking note when the range starts before the retention window — the export still succeeds but silently omits
94
+ * the purged period, which reads as "no usage" unless the caller is told. Returns null when the range is inside it.
95
+ */
96
+ export function usageReportRetentionNote(startDate, now = Date.now()) {
97
+ const startMs = usageReportUtcMs(startDate, 'start');
98
+ const cutoffMs = now - USAGE_RETENTION_DAYS * 86_400_000;
99
+ if (Number.isNaN(startMs) || startMs >= cutoffMs)
100
+ return null;
101
+ const cutoff = new Date(cutoffMs).toISOString().slice(0, 10);
102
+ return (`Note: usage data is retained for 2 years (platform 25.9+). Data before about ${cutoff} has been purged, so the ` +
103
+ `${startDate} to ${cutoff} portion of this range will be empty or partial — that is not evidence of no usage.`);
104
+ }
88
105
  //# sourceMappingURL=usage-report-guard.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"usage-report-guard.js","sourceRoot":"","sources":["../../src/utils/usage-report-guard.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"usage-report-guard.js","sourceRoot":"","sources":["../../src/utils/usage-report-guard.ts"],"names":[],"mappings":"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"}
@@ -3,6 +3,11 @@ export interface SummarizeOptions {
3
3
  groupBy: string;
4
4
  sumColumn?: string;
5
5
  topN?: number;
6
+ /**
7
+ * Split comma-separated cells into one bucket per value. Defaults to true for a tag column (the 26.2 "User Tag"
8
+ * cell holds e.g. "fiserv-poc, jpmcpoc, okta-poc") and false otherwise.
9
+ */
10
+ splitValues?: boolean;
6
11
  }
7
12
  export interface GroupResult {
8
13
  value: string;
@@ -15,6 +20,13 @@ export interface SummaryResult {
15
20
  groups: GroupResult[];
16
21
  truncated: boolean;
17
22
  availableColumns: string[];
23
+ /** True when multi-value cells were split — a row then counts (and sums) once in EACH of its values. */
24
+ valuesSplit?: boolean;
18
25
  }
19
26
  export declare function summarizeRows(parsed: ParsedCsv, opts: SummarizeOptions): SummaryResult;
27
+ /**
28
+ * Picks the section of a multi-section report that has the requested columns (first match wins). Errors list every
29
+ * section's columns so the caller can retry with a real name.
30
+ */
31
+ export declare function pickSection(sections: ParsedCsv[], opts: SummarizeOptions): ParsedCsv;
20
32
  //# sourceMappingURL=usage-report-summary.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"usage-report-summary.d.ts","sourceRoot":"","sources":["../../src/utils/usage-report-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQ1C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CA6CtF"}
1
+ {"version":3,"file":"usage-report-summary.d.ts","sourceRoot":"","sources":["../../src/utils/usage-report-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQ1C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wGAAwG;IACxG,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAgDtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAQpF"}
@@ -16,21 +16,23 @@ export function summarizeRows(parsed, opts) {
16
16
  throw new Error(`sumColumn "${opts.sumColumn}" not found. Available columns: ${headers.join(', ')}`);
17
17
  }
18
18
  }
19
+ const splitValues = opts.splitValues ?? /\btags?\b/i.test(headers[groupIdx]);
19
20
  const buckets = new Map();
20
21
  let countedRows = 0;
21
22
  for (const row of rows) {
22
23
  if (row.every((cell) => cell === ''))
23
24
  continue; // skip fully-blank rows (trailing-newline artifacts)
24
25
  countedRows++;
25
- const key = row[groupIdx] ?? '';
26
- const entry = buckets.get(key) ?? { count: 0, sum: 0 };
27
- entry.count += 1;
28
- if (sumIdx !== -1) {
29
- const n = Number(row[sumIdx]);
26
+ const cell = row[groupIdx] ?? '';
27
+ const parts = splitValues ? cell.split(',').map((v) => v.trim()).filter(Boolean) : [cell];
28
+ const n = sumIdx !== -1 ? Number(row[sumIdx]) : NaN;
29
+ for (const key of parts.length ? parts : ['']) {
30
+ const entry = buckets.get(key) ?? { count: 0, sum: 0 };
31
+ entry.count += 1;
30
32
  if (!Number.isNaN(n))
31
33
  entry.sum += n;
34
+ buckets.set(key, entry);
32
35
  }
33
- buckets.set(key, entry);
34
36
  }
35
37
  const sorted = [...buckets.entries()]
36
38
  .map(([value, { count, sum }]) => (sumIdx !== -1 ? { value, count, sum: Math.round(sum * 100) / 100 } : { value, count }))
@@ -43,6 +45,23 @@ export function summarizeRows(parsed, opts) {
43
45
  groups: sorted.slice(0, topN),
44
46
  truncated,
45
47
  availableColumns: headers,
48
+ ...(splitValues ? { valuesSplit: true } : {}),
46
49
  };
47
50
  }
51
+ /**
52
+ * Picks the section of a multi-section report that has the requested columns (first match wins). Errors list every
53
+ * section's columns so the caller can retry with a real name.
54
+ */
55
+ export function pickSection(sections, opts) {
56
+ if (sections.length === 0)
57
+ return { headers: [], rows: [] };
58
+ const wanted = [opts.groupBy, ...(opts.sumColumn !== undefined ? [opts.sumColumn] : [])];
59
+ const match = sections.find((sec) => wanted.every((name) => findColumnIndex(sec.headers, name) !== -1));
60
+ if (match)
61
+ return match;
62
+ if (sections.length === 1)
63
+ return sections[0]; // summarizeRows reports the missing column
64
+ const listing = sections.map((sec, i) => `section ${i + 1}: ${sec.headers.join(', ')}`).join('; ');
65
+ throw new Error(`No single section of this report has ${wanted.map((w) => `"${w}"`).join(' and ')}. Available columns — ${listing}`);
66
+ }
48
67
  //# sourceMappingURL=usage-report-summary.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"usage-report-summary.js","sourceRoot":"","sources":["../../src/utils/usage-report-summary.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"usage-report-summary.js","sourceRoot":"","sources":["../../src/utils/usage-report-summary.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,17 @@
1
1
  {
2
2
  "name": "digital-ai-testing-mcp",
3
- "version": "1.2.7",
4
- "description": "MCP server for Digital.ai Testing — device farm management, app lifecycle, and test automation",
3
+ "version": "2.0.0",
4
+ "description": "MCP server for Digital.ai Testing — device farm, app lifecycle, test runs, reporting and analytics, performance, live mobile and browser inspection, and test authoring",
5
+ "keywords": [
6
+ "mcp",
7
+ "model-context-protocol",
8
+ "digital.ai",
9
+ "mobile-testing",
10
+ "appium",
11
+ "selenium",
12
+ "device-farm",
13
+ "test-automation"
14
+ ],
5
15
  "type": "module",
6
16
  "main": "dist/index.js",
7
17
  "bin": {
@@ -9,7 +19,8 @@
9
19
  },
10
20
  "files": [
11
21
  "dist",
12
- "resources/boilerplate"
22
+ "resources/boilerplate",
23
+ "resources/test-orchestrator"
13
24
  ],
14
25
  "engines": {
15
26
  "node": ">=22"
@@ -41,13 +52,38 @@
41
52
  "test:health": "vitest run tests/health.test.ts",
42
53
  "test:utils": "vitest run tests/utils.test.ts",
43
54
  "test:reporting": "vitest run tests/reporting.test.ts",
55
+ "test:video": "vitest run tests/test-video.test.ts",
56
+ "test:maestro": "vitest run tests/maestro-flow.test.ts",
57
+ "test:find-elements": "vitest run tests/find-elements.test.ts",
58
+ "test:remediation": "vitest run tests/remediation.test.ts",
59
+ "test:remediation-digest": "vitest run tests/remediation-digest.test.ts",
60
+ "test:tool-catalog": "vitest run tests/tool-catalog.test.ts",
61
+ "test:appium3-gestures": "vitest run tests/appium3-gestures.test.ts",
62
+ "test:backlog-batch": "vitest run tests/backlog-batch.test.ts",
63
+ "test:examples-doc": "vitest run tests/examples-doc.test.ts",
64
+ "remediation:digest": "tsx tests/remediation-intake/digest.ts",
44
65
  "test:test-views": "vitest run tests/test-views.test.ts",
45
66
  "test:transactions": "vitest run tests/transactions.test.ts",
46
67
  "test:analytics": "vitest run tests/analytics.test.ts",
47
68
  "test:infrastructure": "vitest run tests/infrastructure.test.ts",
48
69
  "test:performance": "vitest run tests/performance.test.ts",
49
70
  "test:tools": "vitest run tests/tools.test.ts",
50
- "test:usage-reports": "vitest run tests/usage-reports.test.ts"
71
+ "test:usage-reports": "vitest run tests/usage-reports.test.ts",
72
+ "test:access-level": "vitest run tests/access-level.test.ts",
73
+ "test:reporting-sort": "vitest run tests/reporting-sort.test.ts",
74
+ "test:boilerplate-templates": "vitest run tests/boilerplate-templates.test.ts",
75
+ "test:test-orchestrator": "vitest run tests/test-orchestrator.test.ts",
76
+ "test:boilerplate-orchestration": "vitest run tests/boilerplate-orchestration.test.ts",
77
+ "test:test-status": "vitest run tests/test-status.test.ts",
78
+ "test:report-ref": "vitest run tests/report-ref.test.ts",
79
+ "test:project-settings": "vitest run tests/project-settings.test.ts",
80
+ "test:automotive": "vitest run tests/automotive.test.ts",
81
+ "test:test-runs": "vitest run tests/test-runs.test.ts",
82
+ "test:rca": "vitest run tests/rca.test.ts",
83
+ "test:toolsets": "vitest run tests/toolsets.test.ts",
84
+ "test:fidelity-score": "vitest run tests/fidelity-score.test.ts",
85
+ "test:uat-fixes": "vitest run tests/uat-fixes.test.ts",
86
+ "test:fidelity": "npm run build && tsx tests/fidelity/run.ts"
51
87
  },
52
88
  "dependencies": {
53
89
  "@modelcontextprotocol/sdk": "^1.30.0",
@@ -1,7 +1,12 @@
1
1
  apply plugin: 'java'
2
2
 
3
3
  // Standalone use only — remove if this module is part of a larger Gradle project
4
- // repositories { mavenCentral() }
4
+ repositories { mavenCentral() }
5
+
6
+ // JUnit 5 runs on the JUnit Platform — without this Gradle finds ZERO tests and still reports success
7
+ test {
8
+ useJUnitPlatform()
9
+ }
5
10
 
6
11
  dependencies {
7
12
  testImplementation group: 'org.junit.jupiter', name: 'junit-jupiter', version: '5.9.3'
@@ -1,7 +1,12 @@
1
1
  apply plugin: 'java'
2
2
 
3
3
  // Standalone use only — remove if this module is part of a larger Gradle project
4
- // repositories { mavenCentral() }
4
+ repositories { mavenCentral() }
5
+
6
+ // JUnit 5 runs on the JUnit Platform — without this Gradle finds ZERO tests and still reports success
7
+ test {
8
+ useJUnitPlatform()
9
+ }
5
10
 
6
11
  dependencies {
7
12
  testImplementation group: 'org.junit.jupiter', name: 'junit-jupiter', version: '5.10.2'