digital-ai-testing-mcp 1.2.8 → 2.0.1

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 (191) hide show
  1. package/README.md +148 -46
  2. package/dist/api/browser-inspection.d.ts.map +1 -1
  3. package/dist/api/browser-inspection.js +14 -15
  4. package/dist/api/browser-inspection.js.map +1 -1
  5. package/dist/api/client.d.ts +7 -0
  6. package/dist/api/client.d.ts.map +1 -1
  7. package/dist/api/client.js +9 -0
  8. package/dist/api/client.js.map +1 -1
  9. package/dist/api/projects.d.ts +16 -3
  10. package/dist/api/projects.d.ts.map +1 -1
  11. package/dist/api/projects.js +60 -18
  12. package/dist/api/projects.js.map +1 -1
  13. package/dist/api/reporting.d.ts +91 -0
  14. package/dist/api/reporting.d.ts.map +1 -1
  15. package/dist/api/reporting.js +182 -8
  16. package/dist/api/reporting.js.map +1 -1
  17. package/dist/api/test-orchestrator.d.ts +59 -0
  18. package/dist/api/test-orchestrator.d.ts.map +1 -0
  19. package/dist/api/test-orchestrator.js +126 -0
  20. package/dist/api/test-orchestrator.js.map +1 -0
  21. package/dist/api/test-runs.d.ts +80 -0
  22. package/dist/api/test-runs.d.ts.map +1 -0
  23. package/dist/api/test-runs.js +209 -0
  24. package/dist/api/test-runs.js.map +1 -0
  25. package/dist/api/test-views.d.ts.map +1 -1
  26. package/dist/api/test-views.js +5 -1
  27. package/dist/api/test-views.js.map +1 -1
  28. package/dist/api/transactions.d.ts +6 -0
  29. package/dist/api/transactions.d.ts.map +1 -1
  30. package/dist/api/transactions.js +19 -3
  31. package/dist/api/transactions.js.map +1 -1
  32. package/dist/api/usage-reports.d.ts.map +1 -1
  33. package/dist/api/usage-reports.js +3 -3
  34. package/dist/api/usage-reports.js.map +1 -1
  35. package/dist/api/webdriver.d.ts +44 -1
  36. package/dist/api/webdriver.d.ts.map +1 -1
  37. package/dist/api/webdriver.js +194 -67
  38. package/dist/api/webdriver.js.map +1 -1
  39. package/dist/index.js +80 -32
  40. package/dist/index.js.map +1 -1
  41. package/dist/tools/agent-tools.js +2 -2
  42. package/dist/tools/agent-tools.js.map +1 -1
  43. package/dist/tools/application-tools.d.ts.map +1 -1
  44. package/dist/tools/application-tools.js +5 -4
  45. package/dist/tools/application-tools.js.map +1 -1
  46. package/dist/tools/boilerplate-tools.d.ts +3 -0
  47. package/dist/tools/boilerplate-tools.d.ts.map +1 -1
  48. package/dist/tools/boilerplate-tools.js +301 -20
  49. package/dist/tools/boilerplate-tools.js.map +1 -1
  50. package/dist/tools/browser-tools.d.ts.map +1 -1
  51. package/dist/tools/browser-tools.js +8 -5
  52. package/dist/tools/browser-tools.js.map +1 -1
  53. package/dist/tools/device-group-tools.js +5 -5
  54. package/dist/tools/device-group-tools.js.map +1 -1
  55. package/dist/tools/device-tools.d.ts.map +1 -1
  56. package/dist/tools/device-tools.js +5 -4
  57. package/dist/tools/device-tools.js.map +1 -1
  58. package/dist/tools/health-tools.d.ts.map +1 -1
  59. package/dist/tools/health-tools.js +5 -4
  60. package/dist/tools/health-tools.js.map +1 -1
  61. package/dist/tools/inspection-tools.d.ts.map +1 -1
  62. package/dist/tools/inspection-tools.js +112 -10
  63. package/dist/tools/inspection-tools.js.map +1 -1
  64. package/dist/tools/meta-tools.d.ts +4 -1
  65. package/dist/tools/meta-tools.d.ts.map +1 -1
  66. package/dist/tools/meta-tools.js +62 -36
  67. package/dist/tools/meta-tools.js.map +1 -1
  68. package/dist/tools/performance-tools.d.ts.map +1 -1
  69. package/dist/tools/performance-tools.js +1 -7
  70. package/dist/tools/performance-tools.js.map +1 -1
  71. package/dist/tools/project-tools.d.ts.map +1 -1
  72. package/dist/tools/project-tools.js +38 -19
  73. package/dist/tools/project-tools.js.map +1 -1
  74. package/dist/tools/provisioning-profile-tools.d.ts.map +1 -1
  75. package/dist/tools/provisioning-profile-tools.js +5 -4
  76. package/dist/tools/provisioning-profile-tools.js.map +1 -1
  77. package/dist/tools/remediation-tools.d.ts +7 -0
  78. package/dist/tools/remediation-tools.d.ts.map +1 -0
  79. package/dist/tools/remediation-tools.js +50 -0
  80. package/dist/tools/remediation-tools.js.map +1 -0
  81. package/dist/tools/reporting-tools.d.ts.map +1 -1
  82. package/dist/tools/reporting-tools.js +369 -136
  83. package/dist/tools/reporting-tools.js.map +1 -1
  84. package/dist/tools/repository-tools.d.ts.map +1 -1
  85. package/dist/tools/repository-tools.js +5 -4
  86. package/dist/tools/repository-tools.js.map +1 -1
  87. package/dist/tools/reservation-tools.js +2 -2
  88. package/dist/tools/reservation-tools.js.map +1 -1
  89. package/dist/tools/test-run-tools.d.ts +3 -0
  90. package/dist/tools/test-run-tools.d.ts.map +1 -0
  91. package/dist/tools/test-run-tools.js +284 -0
  92. package/dist/tools/test-run-tools.js.map +1 -0
  93. package/dist/tools/test-view-tools.d.ts.map +1 -1
  94. package/dist/tools/test-view-tools.js +11 -11
  95. package/dist/tools/test-view-tools.js.map +1 -1
  96. package/dist/tools/toolset-tools.d.ts +8 -0
  97. package/dist/tools/toolset-tools.d.ts.map +1 -0
  98. package/dist/tools/toolset-tools.js +40 -0
  99. package/dist/tools/toolset-tools.js.map +1 -0
  100. package/dist/tools/transaction-tools.d.ts.map +1 -1
  101. package/dist/tools/transaction-tools.js +17 -7
  102. package/dist/tools/transaction-tools.js.map +1 -1
  103. package/dist/tools/usage-report-tools.d.ts.map +1 -1
  104. package/dist/tools/usage-report-tools.js +43 -15
  105. package/dist/tools/usage-report-tools.js.map +1 -1
  106. package/dist/tools/user-tools.js +2 -2
  107. package/dist/tools/user-tools.js.map +1 -1
  108. package/dist/tools/web-inspection-tools.d.ts.map +1 -1
  109. package/dist/tools/web-inspection-tools.js +39 -26
  110. package/dist/tools/web-inspection-tools.js.map +1 -1
  111. package/dist/tools/workflow-tools.js +1 -1
  112. package/dist/types/digital-ai.d.ts +18 -3
  113. package/dist/types/digital-ai.d.ts.map +1 -1
  114. package/dist/utils/browser-name.d.ts +2 -0
  115. package/dist/utils/browser-name.d.ts.map +1 -0
  116. package/dist/utils/browser-name.js +19 -0
  117. package/dist/utils/browser-name.js.map +1 -0
  118. package/dist/utils/command-payload.d.ts +19 -0
  119. package/dist/utils/command-payload.d.ts.map +1 -0
  120. package/dist/utils/command-payload.js +13 -0
  121. package/dist/utils/command-payload.js.map +1 -0
  122. package/dist/utils/csv.d.ts +6 -0
  123. package/dist/utils/csv.d.ts.map +1 -1
  124. package/dist/utils/csv.js +28 -2
  125. package/dist/utils/csv.js.map +1 -1
  126. package/dist/utils/locality.d.ts +7 -0
  127. package/dist/utils/locality.d.ts.map +1 -1
  128. package/dist/utils/locality.js +19 -0
  129. package/dist/utils/locality.js.map +1 -1
  130. package/dist/utils/maestro-flow.d.ts +38 -0
  131. package/dist/utils/maestro-flow.d.ts.map +1 -0
  132. package/dist/utils/maestro-flow.js +114 -0
  133. package/dist/utils/maestro-flow.js.map +1 -0
  134. package/dist/utils/metric-semantics.d.ts +22 -0
  135. package/dist/utils/metric-semantics.d.ts.map +1 -0
  136. package/dist/utils/metric-semantics.js +24 -0
  137. package/dist/utils/metric-semantics.js.map +1 -0
  138. package/dist/utils/pagination.d.ts +11 -0
  139. package/dist/utils/pagination.d.ts.map +1 -1
  140. package/dist/utils/pagination.js +16 -0
  141. package/dist/utils/pagination.js.map +1 -1
  142. package/dist/utils/remediation.d.ts +130 -0
  143. package/dist/utils/remediation.d.ts.map +1 -0
  144. package/dist/utils/remediation.js +424 -0
  145. package/dist/utils/remediation.js.map +1 -0
  146. package/dist/utils/report-ref.d.ts +23 -0
  147. package/dist/utils/report-ref.d.ts.map +1 -0
  148. package/dist/utils/report-ref.js +31 -0
  149. package/dist/utils/report-ref.js.map +1 -0
  150. package/dist/utils/response-formatter.d.ts +2 -1
  151. package/dist/utils/response-formatter.d.ts.map +1 -1
  152. package/dist/utils/response-formatter.js +32 -21
  153. package/dist/utils/response-formatter.js.map +1 -1
  154. package/dist/utils/test-orchestrator.d.ts +102 -0
  155. package/dist/utils/test-orchestrator.d.ts.map +1 -0
  156. package/dist/utils/test-orchestrator.js +236 -0
  157. package/dist/utils/test-orchestrator.js.map +1 -0
  158. package/dist/utils/test-status.d.ts +48 -0
  159. package/dist/utils/test-status.d.ts.map +1 -0
  160. package/dist/utils/test-status.js +92 -0
  161. package/dist/utils/test-status.js.map +1 -0
  162. package/dist/utils/tool-catalog.d.ts +6 -0
  163. package/dist/utils/tool-catalog.d.ts.map +1 -0
  164. package/dist/utils/tool-catalog.js +15 -0
  165. package/dist/utils/tool-catalog.js.map +1 -0
  166. package/dist/utils/toolsets.d.ts +79 -0
  167. package/dist/utils/toolsets.d.ts.map +1 -0
  168. package/dist/utils/toolsets.js +156 -0
  169. package/dist/utils/toolsets.js.map +1 -0
  170. package/dist/utils/usage-report-guard.d.ts +7 -0
  171. package/dist/utils/usage-report-guard.d.ts.map +1 -1
  172. package/dist/utils/usage-report-guard.js +18 -1
  173. package/dist/utils/usage-report-guard.js.map +1 -1
  174. package/dist/utils/usage-report-summary.d.ts +12 -0
  175. package/dist/utils/usage-report-summary.d.ts.map +1 -1
  176. package/dist/utils/usage-report-summary.js +25 -6
  177. package/dist/utils/usage-report-summary.js.map +1 -1
  178. package/package.json +41 -4
  179. package/resources/boilerplate/Android-Native/Java JUnit5/gradle +6 -1
  180. package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +6 -1
  181. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +2 -2
  182. package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +2 -2
  183. package/resources/boilerplate/Android-Native/java TestNG/gradle +1 -1
  184. package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +1 -1
  185. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle +6 -1
  186. package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +6 -1
  187. package/resources/boilerplate/iOS-Native/java-TestNG/gradle +1 -1
  188. package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +1 -1
  189. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +2 -2
  190. package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +2 -2
  191. package/resources/test-orchestrator/agent.json +19 -0
@@ -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":"AA0BA,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,MAAM,QAAQ,GAAa,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACrE,KAAK,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC3B,0EAA0E;gBAC1E,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,IAA+E,CAAC;gBAC7H,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;oBAClG,MAAM,IAAI,KAAK,CAAC,yDAAyD,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvG,CAAC;gBACD,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5E,QAAQ,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SACjF,CAAC;QACF,QAAQ,CAAC,QAAgC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,6GAA6G;AAC7G,MAAM,CAAC,MAAM,QAAQ,GAA+D;IAClF,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE;IAC/K,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,EAAE,uBAAuB,CAAC,EAAE,WAAW,EAAE,gEAAgE,EAAE;IACzJ,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,oEAAoE,EAAE;IAClJ,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE;IAC5I,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,iFAAiF,EAAE;IAClK,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAC1H,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACzF,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,gEAAgE,EAAE;CACjK,CAAC;AAEF,6GAA6G;AAC7G,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAEnD,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9F,OAAO,IAAI,CAAC;AACd,CAAC;AAID,MAAM,UAAU,qBAAqB,CAAC,GAAuB;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/H,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,kHAAkH;IAClH,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,MAAM;YAAE,SAAS;QAC3B,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC3C,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG,IAAwG,CAAC;QACjH,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,CAAC;QACjC,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAqB,CAAC;YAAC,WAAW,GAAG,CAAC,EAAE,WAAW,CAAC;QAAC,CAAC;QAC9G,MAAM,QAAQ,GAAG,OAAQ,IAAuC,EAAE,UAAU,KAAK,UAAU,IAAK,IAAsC,CAAC,UAAU,EAAE,CAAC;QACpJ,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,WAAW,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,GAAG,GAAG,GAAG;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC9D,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,sBAAsB,CAAC,IAAkB,EAAE,OAAe;IACxE,OAAO,IAAI,OAAO,mCAAmC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9F,CAAC;AAkBD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,QAAkB,EAAE,SAAoB,EAAE,IAAkB;IAClH,MAAM,CAAC,GAAG,MAAgJ,CAAC;IAC3J,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,SAAS,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkF,CAAC;IAC1G,MAAM,MAAM,GAAG,CAAC,CAAe,EAAE,OAAsB,EAAE,EAAE,CACzD,SAAS,CAAC,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5H,MAAM,UAAU,GAAsB;QACpC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE;QAChC,MAAM,CAAC,QAAQ;YACb,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,+GAA+G;YAC/G,4EAA4E;YAC5E,MAAM,GAAG,GAAG,MAAwD,CAAC;YACrE,MAAM,MAAM,GAAG,GAAG,CAAC,mBAAmB,CAAC;YACvC,GAAG,CAAC,mBAAmB,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;YACnC,IAAI,CAAC;gBACL,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;oBAC1B,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;wBAAE,SAAS;oBAC9C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACf,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;wBACzD,IAAI,OAAO,KAAK,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;4BAAE,SAAS;wBAC/D,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC,KAAc,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAU,EAAE,CAAC,CAAC;wBACvK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;YACD,CAAC;oBAAS,CAAC;gBACT,GAAG,CAAC,mBAAmB,GAAG,MAAM,CAAC;YACnC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO;YACL,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrD,OAAO;gBACP,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;aACzE,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,OAAQ,CAAC;QACpB,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;YAC7B,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG;gBACf,QAAQ,EAAE,cAAc,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,oDAAoD;gBACpG,8BAA8B,IAAI,CAAC,IAAI,qCAAqC,IAAI,CAAC,IAAI,6BAA6B;gBAClH,EAAE;gBACF,GAAG,IAAI,CAAC,IAAI,sBAAsB;gBAClC,IAAI,CAAC,WAAW;gBAChB,EAAE;gBACF,aAAa;gBACb,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;aAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAClE,CAAC,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,sBAAsB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACtK,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO;QAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,SAAS;QAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,UAAU,CAAC;AACpB,CAAC"}
@@ -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.8",
4
- "description": "MCP server for Digital.ai Testing — device farm management, app lifecycle, and test automation",
3
+ "version": "2.0.1",
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,39 @@
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:uat-2026-10-10": "vitest run tests/uat-2026-10-10.test.ts",
62
+ "test:appium3-gestures": "vitest run tests/appium3-gestures.test.ts",
63
+ "test:backlog-batch": "vitest run tests/backlog-batch.test.ts",
64
+ "test:examples-doc": "vitest run tests/examples-doc.test.ts",
65
+ "remediation:digest": "tsx tests/remediation-intake/digest.ts",
44
66
  "test:test-views": "vitest run tests/test-views.test.ts",
45
67
  "test:transactions": "vitest run tests/transactions.test.ts",
46
68
  "test:analytics": "vitest run tests/analytics.test.ts",
47
69
  "test:infrastructure": "vitest run tests/infrastructure.test.ts",
48
70
  "test:performance": "vitest run tests/performance.test.ts",
49
71
  "test:tools": "vitest run tests/tools.test.ts",
50
- "test:usage-reports": "vitest run tests/usage-reports.test.ts"
72
+ "test:usage-reports": "vitest run tests/usage-reports.test.ts",
73
+ "test:access-level": "vitest run tests/access-level.test.ts",
74
+ "test:reporting-sort": "vitest run tests/reporting-sort.test.ts",
75
+ "test:boilerplate-templates": "vitest run tests/boilerplate-templates.test.ts",
76
+ "test:test-orchestrator": "vitest run tests/test-orchestrator.test.ts",
77
+ "test:boilerplate-orchestration": "vitest run tests/boilerplate-orchestration.test.ts",
78
+ "test:test-status": "vitest run tests/test-status.test.ts",
79
+ "test:report-ref": "vitest run tests/report-ref.test.ts",
80
+ "test:project-settings": "vitest run tests/project-settings.test.ts",
81
+ "test:automotive": "vitest run tests/automotive.test.ts",
82
+ "test:test-runs": "vitest run tests/test-runs.test.ts",
83
+ "test:rca": "vitest run tests/rca.test.ts",
84
+ "test:toolsets": "vitest run tests/toolsets.test.ts",
85
+ "test:fidelity-score": "vitest run tests/fidelity-score.test.ts",
86
+ "test:uat-fixes": "vitest run tests/uat-fixes.test.ts",
87
+ "test:fidelity": "npm run build && tsx tests/fidelity/run.ts"
51
88
  },
52
89
  "dependencies": {
53
90
  "@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'
@@ -10,7 +10,7 @@ public class LocalAndroidTest {
10
10
 
11
11
  private AndroidDriver driver;
12
12
 
13
- @BeforeTest
13
+ @BeforeMethod
14
14
  public void setUp() throws MalformedURLException {
15
15
  UiAutomator2Options options = new UiAutomator2Options();
16
16
  options.setCapability("digitalai:testName", "[Enter Test Name here]");
@@ -44,7 +44,7 @@ public class LocalAndroidTest {
44
44
  // [END_DEMO_STEPS]
45
45
  }
46
46
 
47
- @AfterTest
47
+ @AfterMethod
48
48
  public void tearDown() {
49
49
  if (driver == null) return;
50
50
  try {
@@ -16,7 +16,7 @@ public class LocalAndroidTest {
16
16
  DesiredCapabilities dc = new DesiredCapabilities();
17
17
  private String accessKey = "[Enter Your Access key here]";
18
18
 
19
- @BeforeTest
19
+ @BeforeMethod
20
20
  public void setUp() throws MalformedURLException {
21
21
  dc.setCapability("digitalai:testName", "[Enter Test Name here]");
22
22
  dc.setCapability("digitalai:accessKey", accessKey);
@@ -53,7 +53,7 @@ public class LocalAndroidTest {
53
53
  // [END_DEMO_STEPS]
54
54
  }
55
55
 
56
- @AfterTest
56
+ @AfterMethod
57
57
  public void tearDown() {
58
58
  if (driver == null) return;
59
59
  try {
@@ -1,7 +1,7 @@
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
5
 
6
6
  test {
7
7
  useTestNG()
@@ -1,7 +1,7 @@
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
5
 
6
6
  test {
7
7
  useTestNG()
@@ -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'
@@ -1,7 +1,7 @@
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
5
 
6
6
  test {
7
7
  useTestNG()
@@ -1,7 +1,7 @@
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
5
 
6
6
  test {
7
7
  useTestNG()
@@ -10,7 +10,7 @@ public class LocaliOSTest {
10
10
 
11
11
  private IOSDriver driver;
12
12
 
13
- @BeforeTest
13
+ @BeforeMethod
14
14
  public void setUp() throws MalformedURLException {
15
15
  XCUITestOptions options = new XCUITestOptions();
16
16
  options.setCapability("digitalai:testName", "[Enter Test Name here]");
@@ -38,7 +38,7 @@ public class LocaliOSTest {
38
38
  // [END_DEMO_STEPS]
39
39
  }
40
40
 
41
- @AfterTest
41
+ @AfterMethod
42
42
  public void tearDown() {
43
43
  if (driver == null) return;
44
44
  try {
@@ -16,7 +16,7 @@ public class LocaliOSTest {
16
16
  DesiredCapabilities dc = new DesiredCapabilities();
17
17
  private String accessKey = "[Enter Your Access key here]";
18
18
 
19
- @BeforeTest
19
+ @BeforeMethod
20
20
  public void setUp() throws MalformedURLException {
21
21
  dc.setCapability("digitalai:testName", "[Enter Test Name here]");
22
22
  dc.setCapability("digitalai:accessKey", accessKey);
@@ -45,7 +45,7 @@ public class LocaliOSTest {
45
45
  // [END_DEMO_STEPS]
46
46
  }
47
47
 
48
- @AfterTest
48
+ @AfterMethod
49
49
  public void tearDown() {
50
50
  if (driver == null) return;
51
51
  try {
@@ -0,0 +1,19 @@
1
+ {
2
+ "name": "Digital.ai Test Orchestrator (Smart Agent)",
3
+ "version": "1.0-SNAPSHOT",
4
+ "sha256": "b3128d8956b3f5bd2259cc8c0474020466327c96858de737391636766905ba95",
5
+ "size": 11801724,
6
+ "source": {
7
+ "description": "Default download location, fetched on demand by install_test_orchestrator_agent: the Digital.ai sample repository, pinned to an immutable commit and verified by SHA-256. To move to a permanent production location, update downloadUrl + sha256 here, or set TEST_ORCHESTRATOR_JAR_URL + TEST_ORCHESTRATOR_JAR_SHA256 at runtime.",
8
+ "repository": "https://github.com/raheekhandigitalai/Digital.ai-Testing-Test-Orchestrator",
9
+ "commit": "3bb383499de771cf8b53e604d52652391ea0b066",
10
+ "path": "lib/smart-agent-1.0-SNAPSHOT.jar",
11
+ "downloadUrl": "https://raw.githubusercontent.com/raheekhandigitalai/Digital.ai-Testing-Test-Orchestrator/3bb383499de771cf8b53e604d52652391ea0b066/lib/smart-agent-1.0-SNAPSHOT.jar"
12
+ },
13
+ "requirements": {
14
+ "java": "17 or 21 (Java 25 support is in progress upstream)",
15
+ "frameworks": "JUnit 5 (Jupiter) or TestNG 7+",
16
+ "appiumJavaClient": "8, 9 or 10",
17
+ "projectMode": "Appium Server (OSS) projects only"
18
+ }
19
+ }