digital-ai-testing-mcp 1.2.8 → 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 (191) hide show
  1. package/README.md +147 -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 +178 -6
  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 +39 -1
  36. package/dist/api/webdriver.d.ts.map +1 -1
  37. package/dist/api/webdriver.js +169 -65
  38. package/dist/api/webdriver.js.map +1 -1
  39. package/dist/index.js +79 -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 +110 -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 +59 -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 +334 -134
  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 +14 -1
  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 +113 -0
  143. package/dist/utils/remediation.d.ts.map +1 -0
  144. package/dist/utils/remediation.js +392 -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 +40 -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,48 @@
1
+ /**
2
+ * Reporter test statuses — one definition of the status set, how each counts, and the pass rate.
3
+ *
4
+ * Verified live (2026-10-09) on POST /reporter/api/tests/grouped with pivotBy ["status"]: the reporter has SIX statuses,
5
+ * not three. Tools that hardcoded Passed/Failed/Incomplete silently dropped the rest — on the dev tenant ~27k Error
6
+ * records (the second-largest failure bucket) never appeared in any summary. Platform 26.9 made this worse: tests
7
+ * interrupted by a client crash or an infrastructure problem now end as Error ("Device Session ended before test
8
+ * completion") instead of Incomplete.
9
+ *
10
+ * status_code values observed live: Healed=5, Error=4, Skipped=3. `success` is FALSE for Healed (and for Error and
11
+ * Skipped), so `success` alone is not a reliable "passed" signal — classify by status.
12
+ */
13
+ export declare const TEST_STATUSES: readonly ["Passed", "Failed", "Error", "Incomplete", "Skipped", "Healed"];
14
+ export type TestStatus = (typeof TEST_STATUSES)[number];
15
+ /** Passed outright, or passed after self-healing a locator. */
16
+ export declare const PASSING_STATUSES: readonly TestStatus[];
17
+ /** Failed an assertion (Failed) or ended abnormally — crash, infrastructure, session ended early (Error). */
18
+ export declare const FAILING_STATUSES: readonly TestStatus[];
19
+ export declare const PASS_RATE_BASIS = "(Passed + Healed) / (Passed + Healed + Failed + Error). Incomplete (still running, or ended without a verdict) and Skipped are excluded.";
20
+ export type StatusOutcome = 'pass' | 'fail' | 'other';
21
+ export declare function statusOutcome(status: string | null | undefined): StatusOutcome;
22
+ export interface StatusCounts {
23
+ passed: number;
24
+ failed: number;
25
+ error: number;
26
+ incomplete: number;
27
+ skipped: number;
28
+ healed: number;
29
+ /** Every record, including any status this code does not know yet. */
30
+ total: number;
31
+ }
32
+ export declare function emptyStatusCounts(): StatusCounts;
33
+ /**
34
+ * Counts from a reporter pivot row — the shape returned by both POST /reporter/api/tests/grouped (pivotBy ["status"])
35
+ * and GET /reporter/api/testView/{id}/summary: { passedCount, failedCount, incompleteCount, skippedCount, errorCount,
36
+ * healedCount, _count_ }. Missing columns count as 0; `total` prefers the server's `_count_` so a status added later
37
+ * still shows up in the total even before this code learns its name.
38
+ */
39
+ export declare function countsFromPivotRow(row: Record<string, unknown> | null | undefined): StatusCounts;
40
+ /** Tally a list of records (each with a `status`) — for client-side buckets over list results. */
41
+ export declare function tallyStatuses(records: Array<{
42
+ status?: string | null;
43
+ }>): StatusCounts;
44
+ /** Pass rate in percent (1 decimal) over decided outcomes — see PASS_RATE_BASIS. null when nothing has a verdict. */
45
+ export declare function passRate(c: StatusCounts): number | null;
46
+ /** Records not covered by the six known statuses (non-zero only if the platform adds a status). */
47
+ export declare function unknownStatusCount(c: StatusCounts): number;
48
+ //# sourceMappingURL=test-status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-status.d.ts","sourceRoot":"","sources":["../../src/utils/test-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,aAAa,2EAA4E,CAAC;AACvG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAyB,CAAC;AAC5E,6GAA6G;AAC7G,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAwB,CAAC;AAE3E,eAAO,MAAM,eAAe,6IACgH,CAAC;AAE7I,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAI9E;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAiBhG;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,YAAY,CAetF;AAED,qHAAqH;AACrH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAE1D"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Reporter test statuses — one definition of the status set, how each counts, and the pass rate.
3
+ *
4
+ * Verified live (2026-10-09) on POST /reporter/api/tests/grouped with pivotBy ["status"]: the reporter has SIX statuses,
5
+ * not three. Tools that hardcoded Passed/Failed/Incomplete silently dropped the rest — on the dev tenant ~27k Error
6
+ * records (the second-largest failure bucket) never appeared in any summary. Platform 26.9 made this worse: tests
7
+ * interrupted by a client crash or an infrastructure problem now end as Error ("Device Session ended before test
8
+ * completion") instead of Incomplete.
9
+ *
10
+ * status_code values observed live: Healed=5, Error=4, Skipped=3. `success` is FALSE for Healed (and for Error and
11
+ * Skipped), so `success` alone is not a reliable "passed" signal — classify by status.
12
+ */
13
+ export const TEST_STATUSES = ['Passed', 'Failed', 'Error', 'Incomplete', 'Skipped', 'Healed'];
14
+ /** Passed outright, or passed after self-healing a locator. */
15
+ export const PASSING_STATUSES = ['Passed', 'Healed'];
16
+ /** Failed an assertion (Failed) or ended abnormally — crash, infrastructure, session ended early (Error). */
17
+ export const FAILING_STATUSES = ['Failed', 'Error'];
18
+ export const PASS_RATE_BASIS = '(Passed + Healed) / (Passed + Healed + Failed + Error). Incomplete (still running, or ended without a verdict) and Skipped are excluded.';
19
+ export function statusOutcome(status) {
20
+ if (PASSING_STATUSES.includes(status ?? ''))
21
+ return 'pass';
22
+ if (FAILING_STATUSES.includes(status ?? ''))
23
+ return 'fail';
24
+ return 'other';
25
+ }
26
+ export function emptyStatusCounts() {
27
+ return { passed: 0, failed: 0, error: 0, incomplete: 0, skipped: 0, healed: 0, total: 0 };
28
+ }
29
+ /**
30
+ * Counts from a reporter pivot row — the shape returned by both POST /reporter/api/tests/grouped (pivotBy ["status"])
31
+ * and GET /reporter/api/testView/{id}/summary: { passedCount, failedCount, incompleteCount, skippedCount, errorCount,
32
+ * healedCount, _count_ }. Missing columns count as 0; `total` prefers the server's `_count_` so a status added later
33
+ * still shows up in the total even before this code learns its name.
34
+ */
35
+ export function countsFromPivotRow(row) {
36
+ const n = (k) => {
37
+ const v = Number(row?.[k] ?? 0);
38
+ return Number.isFinite(v) ? v : 0;
39
+ };
40
+ const c = {
41
+ passed: n('passedCount'),
42
+ failed: n('failedCount'),
43
+ error: n('errorCount'),
44
+ incomplete: n('incompleteCount'),
45
+ skipped: n('skippedCount'),
46
+ healed: n('healedCount'),
47
+ total: 0,
48
+ };
49
+ const known = c.passed + c.failed + c.error + c.incomplete + c.skipped + c.healed;
50
+ c.total = row?.['_count_'] != null ? Math.max(n('_count_'), known) : known;
51
+ return c;
52
+ }
53
+ /** Tally a list of records (each with a `status`) — for client-side buckets over list results. */
54
+ export function tallyStatuses(records) {
55
+ const c = emptyStatusCounts();
56
+ for (const r of records) {
57
+ c.total++;
58
+ switch (r.status) {
59
+ case 'Passed':
60
+ c.passed++;
61
+ break;
62
+ case 'Failed':
63
+ c.failed++;
64
+ break;
65
+ case 'Error':
66
+ c.error++;
67
+ break;
68
+ case 'Incomplete':
69
+ c.incomplete++;
70
+ break;
71
+ case 'Skipped':
72
+ c.skipped++;
73
+ break;
74
+ case 'Healed':
75
+ c.healed++;
76
+ break;
77
+ default: break; // unknown status: in total only
78
+ }
79
+ }
80
+ return c;
81
+ }
82
+ /** Pass rate in percent (1 decimal) over decided outcomes — see PASS_RATE_BASIS. null when nothing has a verdict. */
83
+ export function passRate(c) {
84
+ const pass = c.passed + c.healed;
85
+ const decided = pass + c.failed + c.error;
86
+ return decided > 0 ? Math.round((pass / decided) * 1000) / 10 : null;
87
+ }
88
+ /** Records not covered by the six known statuses (non-zero only if the platform adds a status). */
89
+ export function unknownStatusCount(c) {
90
+ return Math.max(0, c.total - (c.passed + c.failed + c.error + c.incomplete + c.skipped + c.healed));
91
+ }
92
+ //# sourceMappingURL=test-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-status.js","sourceRoot":"","sources":["../../src/utils/test-status.ts"],"names":[],"mappings":"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"}
@@ -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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"}
@@ -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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"}