digital-ai-testing-mcp 1.2.7 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +161 -56
- package/dist/api/access-level.d.ts +46 -0
- package/dist/api/access-level.d.ts.map +1 -0
- package/dist/api/access-level.js +183 -0
- package/dist/api/access-level.js.map +1 -0
- package/dist/api/agents.js +1 -1
- package/dist/api/agents.js.map +1 -1
- package/dist/api/browser-inspection.d.ts.map +1 -1
- package/dist/api/browser-inspection.js +18 -17
- package/dist/api/browser-inspection.js.map +1 -1
- package/dist/api/client.d.ts +14 -2
- package/dist/api/client.d.ts.map +1 -1
- package/dist/api/client.js +60 -43
- package/dist/api/client.js.map +1 -1
- package/dist/api/device-groups.js +1 -1
- package/dist/api/device-groups.js.map +1 -1
- package/dist/api/license.js +1 -1
- package/dist/api/license.js.map +1 -1
- package/dist/api/nv-servers.js +1 -1
- package/dist/api/nv-servers.js.map +1 -1
- package/dist/api/projects.d.ts +16 -3
- package/dist/api/projects.d.ts.map +1 -1
- package/dist/api/projects.js +60 -18
- package/dist/api/projects.js.map +1 -1
- package/dist/api/regions.js +1 -1
- package/dist/api/regions.js.map +1 -1
- package/dist/api/reporter-projects.d.ts.map +1 -1
- package/dist/api/reporter-projects.js +2 -1
- package/dist/api/reporter-projects.js.map +1 -1
- package/dist/api/reporting.d.ts +91 -0
- package/dist/api/reporting.d.ts.map +1 -1
- package/dist/api/reporting.js +220 -22
- package/dist/api/reporting.js.map +1 -1
- package/dist/api/sessions.js +1 -1
- package/dist/api/sessions.js.map +1 -1
- package/dist/api/test-orchestrator.d.ts +59 -0
- package/dist/api/test-orchestrator.d.ts.map +1 -0
- package/dist/api/test-orchestrator.js +126 -0
- package/dist/api/test-orchestrator.js.map +1 -0
- package/dist/api/test-runs.d.ts +80 -0
- package/dist/api/test-runs.d.ts.map +1 -0
- package/dist/api/test-runs.js +209 -0
- package/dist/api/test-runs.js.map +1 -0
- package/dist/api/test-views.d.ts.map +1 -1
- package/dist/api/test-views.js +5 -1
- package/dist/api/test-views.js.map +1 -1
- package/dist/api/transactions.d.ts +6 -0
- package/dist/api/transactions.d.ts.map +1 -1
- package/dist/api/transactions.js +19 -3
- package/dist/api/transactions.js.map +1 -1
- package/dist/api/usage-reports.d.ts.map +1 -1
- package/dist/api/usage-reports.js +3 -3
- package/dist/api/usage-reports.js.map +1 -1
- package/dist/api/webdriver.d.ts +39 -1
- package/dist/api/webdriver.d.ts.map +1 -1
- package/dist/api/webdriver.js +177 -71
- package/dist/api/webdriver.js.map +1 -1
- package/dist/index.js +82 -33
- package/dist/index.js.map +1 -1
- package/dist/tools/agent-tools.js +2 -2
- package/dist/tools/agent-tools.js.map +1 -1
- package/dist/tools/application-tools.d.ts.map +1 -1
- package/dist/tools/application-tools.js +17 -10
- package/dist/tools/application-tools.js.map +1 -1
- package/dist/tools/boilerplate-tools.d.ts +3 -0
- package/dist/tools/boilerplate-tools.d.ts.map +1 -1
- package/dist/tools/boilerplate-tools.js +302 -21
- package/dist/tools/boilerplate-tools.js.map +1 -1
- package/dist/tools/browser-tools.d.ts.map +1 -1
- package/dist/tools/browser-tools.js +8 -5
- package/dist/tools/browser-tools.js.map +1 -1
- package/dist/tools/debug-tools.d.ts.map +1 -1
- package/dist/tools/debug-tools.js +6 -3
- package/dist/tools/debug-tools.js.map +1 -1
- package/dist/tools/device-group-tools.js +5 -5
- package/dist/tools/device-group-tools.js.map +1 -1
- package/dist/tools/device-tools.d.ts.map +1 -1
- package/dist/tools/device-tools.js +5 -4
- package/dist/tools/device-tools.js.map +1 -1
- package/dist/tools/health-tools.d.ts.map +1 -1
- package/dist/tools/health-tools.js +6 -5
- package/dist/tools/health-tools.js.map +1 -1
- package/dist/tools/inspection-tools.d.ts.map +1 -1
- package/dist/tools/inspection-tools.js +122 -22
- package/dist/tools/inspection-tools.js.map +1 -1
- package/dist/tools/meta-tools.d.ts +4 -1
- package/dist/tools/meta-tools.d.ts.map +1 -1
- package/dist/tools/meta-tools.js +87 -58
- package/dist/tools/meta-tools.js.map +1 -1
- package/dist/tools/performance-tools.d.ts.map +1 -1
- package/dist/tools/performance-tools.js +2 -8
- package/dist/tools/performance-tools.js.map +1 -1
- package/dist/tools/project-tools.d.ts.map +1 -1
- package/dist/tools/project-tools.js +38 -19
- package/dist/tools/project-tools.js.map +1 -1
- package/dist/tools/provisioning-profile-tools.d.ts.map +1 -1
- package/dist/tools/provisioning-profile-tools.js +5 -4
- package/dist/tools/provisioning-profile-tools.js.map +1 -1
- package/dist/tools/remediation-tools.d.ts +7 -0
- package/dist/tools/remediation-tools.d.ts.map +1 -0
- package/dist/tools/remediation-tools.js +50 -0
- package/dist/tools/remediation-tools.js.map +1 -0
- package/dist/tools/reporting-tools.d.ts.map +1 -1
- package/dist/tools/reporting-tools.js +393 -147
- package/dist/tools/reporting-tools.js.map +1 -1
- package/dist/tools/repository-tools.d.ts.map +1 -1
- package/dist/tools/repository-tools.js +5 -4
- package/dist/tools/repository-tools.js.map +1 -1
- package/dist/tools/reservation-tools.js +2 -2
- package/dist/tools/reservation-tools.js.map +1 -1
- package/dist/tools/resources.js +2 -2
- package/dist/tools/resources.js.map +1 -1
- package/dist/tools/test-run-tools.d.ts +3 -0
- package/dist/tools/test-run-tools.d.ts.map +1 -0
- package/dist/tools/test-run-tools.js +284 -0
- package/dist/tools/test-run-tools.js.map +1 -0
- package/dist/tools/test-view-tools.d.ts.map +1 -1
- package/dist/tools/test-view-tools.js +11 -11
- package/dist/tools/test-view-tools.js.map +1 -1
- package/dist/tools/toolset-tools.d.ts +8 -0
- package/dist/tools/toolset-tools.d.ts.map +1 -0
- package/dist/tools/toolset-tools.js +40 -0
- package/dist/tools/toolset-tools.js.map +1 -0
- package/dist/tools/transaction-tools.d.ts.map +1 -1
- package/dist/tools/transaction-tools.js +17 -7
- package/dist/tools/transaction-tools.js.map +1 -1
- package/dist/tools/usage-report-tools.d.ts.map +1 -1
- package/dist/tools/usage-report-tools.js +43 -15
- package/dist/tools/usage-report-tools.js.map +1 -1
- package/dist/tools/user-tools.js +2 -2
- package/dist/tools/user-tools.js.map +1 -1
- package/dist/tools/web-inspection-tools.d.ts.map +1 -1
- package/dist/tools/web-inspection-tools.js +45 -33
- package/dist/tools/web-inspection-tools.js.map +1 -1
- package/dist/tools/workflow-tools.js +1 -1
- package/dist/types/digital-ai.d.ts +19 -1
- package/dist/types/digital-ai.d.ts.map +1 -1
- package/dist/utils/access-level.d.ts +39 -0
- package/dist/utils/access-level.d.ts.map +1 -0
- package/dist/utils/access-level.js +111 -0
- package/dist/utils/access-level.js.map +1 -0
- package/dist/utils/browser-name.d.ts +2 -0
- package/dist/utils/browser-name.d.ts.map +1 -0
- package/dist/utils/browser-name.js +19 -0
- package/dist/utils/browser-name.js.map +1 -0
- package/dist/utils/command-payload.d.ts +19 -0
- package/dist/utils/command-payload.d.ts.map +1 -0
- package/dist/utils/command-payload.js +13 -0
- package/dist/utils/command-payload.js.map +1 -0
- package/dist/utils/csv.d.ts +6 -0
- package/dist/utils/csv.d.ts.map +1 -1
- package/dist/utils/csv.js +28 -2
- package/dist/utils/csv.js.map +1 -1
- package/dist/utils/download-command.d.ts.map +1 -1
- package/dist/utils/download-command.js +5 -4
- package/dist/utils/download-command.js.map +1 -1
- package/dist/utils/locality.d.ts +7 -0
- package/dist/utils/locality.d.ts.map +1 -1
- package/dist/utils/locality.js +19 -0
- package/dist/utils/locality.js.map +1 -1
- package/dist/utils/maestro-flow.d.ts +38 -0
- package/dist/utils/maestro-flow.d.ts.map +1 -0
- package/dist/utils/maestro-flow.js +114 -0
- package/dist/utils/maestro-flow.js.map +1 -0
- package/dist/utils/metric-semantics.d.ts +22 -0
- package/dist/utils/metric-semantics.d.ts.map +1 -0
- package/dist/utils/metric-semantics.js +24 -0
- package/dist/utils/metric-semantics.js.map +1 -0
- package/dist/utils/pagination.d.ts +11 -0
- package/dist/utils/pagination.d.ts.map +1 -1
- package/dist/utils/pagination.js +16 -0
- package/dist/utils/pagination.js.map +1 -1
- package/dist/utils/path-guard.js +1 -1
- package/dist/utils/path-guard.js.map +1 -1
- package/dist/utils/profile-loader.d.ts +4 -2
- package/dist/utils/profile-loader.d.ts.map +1 -1
- package/dist/utils/profile-loader.js +5 -4
- package/dist/utils/profile-loader.js.map +1 -1
- package/dist/utils/remediation.d.ts +113 -0
- package/dist/utils/remediation.d.ts.map +1 -0
- package/dist/utils/remediation.js +392 -0
- package/dist/utils/remediation.js.map +1 -0
- package/dist/utils/report-ref.d.ts +23 -0
- package/dist/utils/report-ref.d.ts.map +1 -0
- package/dist/utils/report-ref.js +31 -0
- package/dist/utils/report-ref.js.map +1 -0
- package/dist/utils/response-formatter.d.ts +2 -1
- package/dist/utils/response-formatter.d.ts.map +1 -1
- package/dist/utils/response-formatter.js +32 -21
- package/dist/utils/response-formatter.js.map +1 -1
- package/dist/utils/test-orchestrator.d.ts +102 -0
- package/dist/utils/test-orchestrator.d.ts.map +1 -0
- package/dist/utils/test-orchestrator.js +236 -0
- package/dist/utils/test-orchestrator.js.map +1 -0
- package/dist/utils/test-status.d.ts +48 -0
- package/dist/utils/test-status.d.ts.map +1 -0
- package/dist/utils/test-status.js +92 -0
- package/dist/utils/test-status.js.map +1 -0
- package/dist/utils/tool-catalog.d.ts +6 -0
- package/dist/utils/tool-catalog.d.ts.map +1 -0
- package/dist/utils/tool-catalog.js +15 -0
- package/dist/utils/tool-catalog.js.map +1 -0
- package/dist/utils/toolsets.d.ts +79 -0
- package/dist/utils/toolsets.d.ts.map +1 -0
- package/dist/utils/toolsets.js +156 -0
- package/dist/utils/toolsets.js.map +1 -0
- package/dist/utils/upload-command.d.ts.map +1 -1
- package/dist/utils/upload-command.js +5 -4
- package/dist/utils/upload-command.js.map +1 -1
- package/dist/utils/usage-report-guard.d.ts +7 -0
- package/dist/utils/usage-report-guard.d.ts.map +1 -1
- package/dist/utils/usage-report-guard.js +18 -1
- package/dist/utils/usage-report-guard.js.map +1 -1
- package/dist/utils/usage-report-summary.d.ts +12 -0
- package/dist/utils/usage-report-summary.d.ts.map +1 -1
- package/dist/utils/usage-report-summary.js +25 -6
- package/dist/utils/usage-report-summary.js.map +1 -1
- package/package.json +40 -4
- package/resources/boilerplate/Android-Native/Java JUnit5/gradle +6 -1
- package/resources/boilerplate/Android-Native/Java JUnit5/gradle-oss +6 -1
- package/resources/boilerplate/Android-Native/java TestNG/AndroidNative-oss.java +2 -2
- package/resources/boilerplate/Android-Native/java TestNG/AndroidNative.java +2 -2
- package/resources/boilerplate/Android-Native/java TestNG/gradle +1 -1
- package/resources/boilerplate/Android-Native/java TestNG/gradle-oss +1 -1
- package/resources/boilerplate/iOS-Native/java-JUnit5/gradle +6 -1
- package/resources/boilerplate/iOS-Native/java-JUnit5/gradle-oss +6 -1
- package/resources/boilerplate/iOS-Native/java-TestNG/gradle +1 -1
- package/resources/boilerplate/iOS-Native/java-TestNG/gradle-oss +1 -1
- package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative-oss.java +2 -2
- package/resources/boilerplate/iOS-Native/java-TestNG/iOSNative.java +2 -2
- package/resources/test-orchestrator/agent.json +19 -0
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Maestro flow builder — pure, no network, no fs. Turns structured steps into a flow YAML the Test Run API runs
|
|
3
|
+
* (executionType MAESTRO, a .zip with flows/<name>.yaml). The syntax mirrors a flow that passed live on 2026-10-09
|
|
4
|
+
* (ExperiBank login, Galaxy S10): appId header, `---`, then a list of commands.
|
|
5
|
+
*
|
|
6
|
+
* Strings are emitted as JSON-quoted scalars, which are valid YAML double-quoted strings — no hand-rolled escaping.
|
|
7
|
+
*/
|
|
8
|
+
export declare const MAESTRO_ACTIONS: readonly ["launchApp", "tapOn", "longPressOn", "inputText", "eraseText", "assertVisible", "assertNotVisible", "scrollUntilVisible", "scroll", "swipe", "hideKeyboard", "back", "pressKey", "waitForAnimationToEnd", "takeScreenshot", "stopApp"];
|
|
9
|
+
export type MaestroAction = (typeof MAESTRO_ACTIONS)[number];
|
|
10
|
+
export interface MaestroStep {
|
|
11
|
+
action: MaestroAction;
|
|
12
|
+
/** Element by resource-id (full "pkg:id/name" as get_element_tree shows it — Maestro matches the id as a regex). */
|
|
13
|
+
id?: string;
|
|
14
|
+
/** Element by visible text, or the text to type for inputText. */
|
|
15
|
+
text?: string;
|
|
16
|
+
/** launchApp: clear app data first. */
|
|
17
|
+
clearState?: boolean;
|
|
18
|
+
/** scrollUntilVisible / swipe direction. */
|
|
19
|
+
direction?: 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
|
|
20
|
+
/** pressKey: Enter, Home, Back, … ; takeScreenshot: file name; eraseText: number of characters. */
|
|
21
|
+
value?: string;
|
|
22
|
+
/** Mark a step optional (Maestro continues if it fails). */
|
|
23
|
+
optional?: boolean;
|
|
24
|
+
}
|
|
25
|
+
export interface MaestroFlowSpec {
|
|
26
|
+
appId: string;
|
|
27
|
+
name?: string;
|
|
28
|
+
tags?: string[];
|
|
29
|
+
steps: MaestroStep[];
|
|
30
|
+
}
|
|
31
|
+
/** Every problem with the spec, so the caller can fix them in one pass. Empty array = valid. */
|
|
32
|
+
export declare function validateMaestroFlow(spec: MaestroFlowSpec): string[];
|
|
33
|
+
/** Bare resource names ("loginButton") instead of the full "pkg:id/loginButton" — soft warning, not an error. */
|
|
34
|
+
export declare function bareIdWarnings(spec: MaestroFlowSpec): string[];
|
|
35
|
+
export declare function buildMaestroFlowYaml(spec: MaestroFlowSpec): string;
|
|
36
|
+
/** File-system-safe flow file name: "ExperiBank login" → "experibank_login.yaml". */
|
|
37
|
+
export declare function flowFileName(name: string | undefined): string;
|
|
38
|
+
//# sourceMappingURL=maestro-flow.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maestro-flow.d.ts","sourceRoot":"","sources":["../../src/utils/maestro-flow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,kPAiBlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,oHAAoH;IACpH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAOD,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAgBnE;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAI9D;AAyCD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAQlE;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG7D"}
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Maestro flow builder — pure, no network, no fs. Turns structured steps into a flow YAML the Test Run API runs
|
|
3
|
+
* (executionType MAESTRO, a .zip with flows/<name>.yaml). The syntax mirrors a flow that passed live on 2026-10-09
|
|
4
|
+
* (ExperiBank login, Galaxy S10): appId header, `---`, then a list of commands.
|
|
5
|
+
*
|
|
6
|
+
* Strings are emitted as JSON-quoted scalars, which are valid YAML double-quoted strings — no hand-rolled escaping.
|
|
7
|
+
*/
|
|
8
|
+
export const MAESTRO_ACTIONS = [
|
|
9
|
+
'launchApp',
|
|
10
|
+
'tapOn',
|
|
11
|
+
'longPressOn',
|
|
12
|
+
'inputText',
|
|
13
|
+
'eraseText',
|
|
14
|
+
'assertVisible',
|
|
15
|
+
'assertNotVisible',
|
|
16
|
+
'scrollUntilVisible',
|
|
17
|
+
'scroll',
|
|
18
|
+
'swipe',
|
|
19
|
+
'hideKeyboard',
|
|
20
|
+
'back',
|
|
21
|
+
'pressKey',
|
|
22
|
+
'waitForAnimationToEnd',
|
|
23
|
+
'takeScreenshot',
|
|
24
|
+
'stopApp',
|
|
25
|
+
];
|
|
26
|
+
const q = (s) => JSON.stringify(s);
|
|
27
|
+
const needsSelector = new Set(['tapOn', 'longPressOn', 'assertVisible', 'assertNotVisible', 'scrollUntilVisible']);
|
|
28
|
+
/** Commands emitted in mapping form, where Maestro's `optional: true` can be attached. */
|
|
29
|
+
const supportsOptional = new Set(['launchApp', 'tapOn', 'longPressOn', 'assertVisible', 'assertNotVisible', 'scrollUntilVisible', 'inputText', 'swipe']);
|
|
30
|
+
/** Every problem with the spec, so the caller can fix them in one pass. Empty array = valid. */
|
|
31
|
+
export function validateMaestroFlow(spec) {
|
|
32
|
+
const errors = [];
|
|
33
|
+
if (!/^[A-Za-z][\w]*(\.[A-Za-z_][\w]*)+$/.test(spec.appId))
|
|
34
|
+
errors.push(`appId "${spec.appId}" is not an Android package name (e.g. com.example.app).`);
|
|
35
|
+
if (spec.steps.length === 0)
|
|
36
|
+
errors.push('steps is empty.');
|
|
37
|
+
spec.steps.forEach((s, i) => {
|
|
38
|
+
const at = `step ${i + 1} (${s.action})`;
|
|
39
|
+
if (needsSelector.has(s.action) && !s.id && !s.text)
|
|
40
|
+
errors.push(`${at}: needs id or text.`);
|
|
41
|
+
if (s.id && s.text && s.action !== 'inputText')
|
|
42
|
+
errors.push(`${at}: use id OR text, not both.`);
|
|
43
|
+
if (s.action === 'inputText' && !s.text)
|
|
44
|
+
errors.push(`${at}: needs text (the value to type).`);
|
|
45
|
+
if (s.action === 'pressKey' && !s.value)
|
|
46
|
+
errors.push(`${at}: needs value (the key, e.g. "Enter").`);
|
|
47
|
+
if (s.action === 'swipe' && !s.direction)
|
|
48
|
+
errors.push(`${at}: needs direction.`);
|
|
49
|
+
if (s.action === 'eraseText' && s.value != null && !/^\d+$/.test(s.value))
|
|
50
|
+
errors.push(`${at}: value must be a character count.`);
|
|
51
|
+
// The emitter only writes `optional: true` for commands in mapping form; refuse it elsewhere rather than drop it silently.
|
|
52
|
+
if (s.optional && !supportsOptional.has(s.action))
|
|
53
|
+
errors.push(`${at}: optional is not supported for ${s.action} (only ${[...supportsOptional].join(', ')}).`);
|
|
54
|
+
});
|
|
55
|
+
return errors;
|
|
56
|
+
}
|
|
57
|
+
/** Bare resource names ("loginButton") instead of the full "pkg:id/loginButton" — soft warning, not an error. */
|
|
58
|
+
export function bareIdWarnings(spec) {
|
|
59
|
+
return spec.steps
|
|
60
|
+
.map((s, i) => (s.id && !s.id.includes(':id/') && !/[.*+?^$()[\]|\\]/.test(s.id) ? `step ${i + 1}: id "${s.id}" has no package prefix — use the full resource-id from get_element_tree (e.g. "${spec.appId}:id/${s.id}"), since Maestro matches the id against the whole resource-id.` : null))
|
|
61
|
+
.filter((w) => w !== null);
|
|
62
|
+
}
|
|
63
|
+
function selector(s, indent) {
|
|
64
|
+
return s.id ? [`${indent}id: ${q(s.id)}`] : [`${indent}text: ${q(s.text ?? '')}`];
|
|
65
|
+
}
|
|
66
|
+
function stepYaml(s) {
|
|
67
|
+
const opt = s.optional ? [' optional: true'] : [];
|
|
68
|
+
switch (s.action) {
|
|
69
|
+
case 'launchApp':
|
|
70
|
+
return s.clearState || s.optional ? ['- launchApp:', ...(s.clearState ? [' clearState: true'] : []), ...opt] : ['- launchApp'];
|
|
71
|
+
case 'tapOn':
|
|
72
|
+
case 'longPressOn':
|
|
73
|
+
case 'assertVisible':
|
|
74
|
+
case 'assertNotVisible':
|
|
75
|
+
return [`- ${s.action}:`, ...selector(s, ' '), ...opt];
|
|
76
|
+
case 'inputText': {
|
|
77
|
+
// With a target, tap it first so the text lands in the right field.
|
|
78
|
+
const tap = s.id ? ['- tapOn:', ` id: ${q(s.id)}`, ...opt] : [];
|
|
79
|
+
// Mapping form (`inputText: { text }`) is what carries `optional`; the scalar form stays for the common case.
|
|
80
|
+
return [...tap, ...(s.optional ? ['- inputText:', ` text: ${q(s.text ?? '')}`, ...opt] : [`- inputText: ${q(s.text ?? '')}`])];
|
|
81
|
+
}
|
|
82
|
+
case 'eraseText':
|
|
83
|
+
return [s.value ? `- eraseText: ${s.value}` : '- eraseText'];
|
|
84
|
+
case 'scrollUntilVisible':
|
|
85
|
+
return ['- scrollUntilVisible:', ' element:', ...selector(s, ' '), ` direction: ${s.direction ?? 'DOWN'}`, ...opt];
|
|
86
|
+
case 'swipe':
|
|
87
|
+
return ['- swipe:', ` direction: ${s.direction}`, ...opt];
|
|
88
|
+
case 'pressKey':
|
|
89
|
+
return [`- pressKey: ${q(s.value ?? '')}`];
|
|
90
|
+
case 'takeScreenshot':
|
|
91
|
+
return [`- takeScreenshot: ${q(s.value ?? 'screenshot')}`];
|
|
92
|
+
case 'scroll':
|
|
93
|
+
case 'hideKeyboard':
|
|
94
|
+
case 'back':
|
|
95
|
+
case 'waitForAnimationToEnd':
|
|
96
|
+
case 'stopApp':
|
|
97
|
+
return [`- ${s.action}`];
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
export function buildMaestroFlowYaml(spec) {
|
|
101
|
+
const header = [
|
|
102
|
+
`appId: ${spec.appId}`,
|
|
103
|
+
...(spec.name ? [`name: ${q(spec.name)}`] : []),
|
|
104
|
+
...(spec.tags?.length ? ['tags:', ...spec.tags.map((t) => ` - ${q(t)}`)] : []),
|
|
105
|
+
'---',
|
|
106
|
+
];
|
|
107
|
+
return [...header, ...spec.steps.flatMap(stepYaml)].join('\n') + '\n';
|
|
108
|
+
}
|
|
109
|
+
/** File-system-safe flow file name: "ExperiBank login" → "experibank_login.yaml". */
|
|
110
|
+
export function flowFileName(name) {
|
|
111
|
+
const base = (name ?? 'flow').toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '') || 'flow';
|
|
112
|
+
return `${base}.yaml`;
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=maestro-flow.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maestro-flow.js","sourceRoot":"","sources":["../../src/utils/maestro-flow.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export declare const SPEED_INDEX_SEMANTICS: string;
|
|
2
|
+
export declare const SPEED_INDEX_SEMANTICS_SHORT = "area above the visual-progress curve; lower = content visible earlier";
|
|
3
|
+
/**
|
|
4
|
+
* Attached to the JSON of every tool that returns Speed Index values. The meaning used to live only in the
|
|
5
|
+
* compare tool's payload and in tool DESCRIPTIONS — so an agent reading list/summary/trend data (or seeing only a
|
|
6
|
+
* placeholder description under MCP_TOOLSETS) had nothing in the data saying "not milliseconds". The fidelity eval
|
|
7
|
+
* caught exactly that on 2026-10-09: in core mode an agent reported "Avg SI 4,450 ms … Over 2s".
|
|
8
|
+
*/
|
|
9
|
+
export declare const METRIC_SEMANTICS: {
|
|
10
|
+
readonly speedIndex: {
|
|
11
|
+
readonly isCompositeMetric: true;
|
|
12
|
+
readonly unit: "SI";
|
|
13
|
+
readonly notADuration: true;
|
|
14
|
+
readonly meaning: string;
|
|
15
|
+
readonly reportAs: "Report Speed Index values as \"SI\" (e.g. \"1,240 SI\"), never ms or seconds; a Speed Index target is a score, not a time.";
|
|
16
|
+
};
|
|
17
|
+
readonly duration: {
|
|
18
|
+
readonly unit: "ms";
|
|
19
|
+
readonly meaning: "Wall-clock length of the transaction window.";
|
|
20
|
+
};
|
|
21
|
+
};
|
|
22
|
+
//# sourceMappingURL=metric-semantics.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metric-semantics.d.ts","sourceRoot":"","sources":["../../src/utils/metric-semantics.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,QAEqE,CAAC;AACxG,eAAO,MAAM,2BAA2B,0EAA0E,CAAC;AAEnH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CASnB,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// Speed Index is a composite visual-progress score (area above the render curve,
|
|
2
|
+
// WebPageTest methodology), NOT elapsed time. A delta of N SI does NOT mean the
|
|
3
|
+
// screen rendered N ms sooner — it means cumulative rendering quality across the
|
|
4
|
+
// whole render window improved. Surface this everywhere the metric appears (v42).
|
|
5
|
+
export const SPEED_INDEX_SEMANTICS = 'area above the visual-progress curve (WebPageTest methodology); a lower value means content was visible ' +
|
|
6
|
+
'more completely earlier across the render window. A delta is NOT a shift in render-completion time.';
|
|
7
|
+
export const SPEED_INDEX_SEMANTICS_SHORT = 'area above the visual-progress curve; lower = content visible earlier';
|
|
8
|
+
/**
|
|
9
|
+
* Attached to the JSON of every tool that returns Speed Index values. The meaning used to live only in the
|
|
10
|
+
* compare tool's payload and in tool DESCRIPTIONS — so an agent reading list/summary/trend data (or seeing only a
|
|
11
|
+
* placeholder description under MCP_TOOLSETS) had nothing in the data saying "not milliseconds". The fidelity eval
|
|
12
|
+
* caught exactly that on 2026-10-09: in core mode an agent reported "Avg SI 4,450 ms … Over 2s".
|
|
13
|
+
*/
|
|
14
|
+
export const METRIC_SEMANTICS = {
|
|
15
|
+
speedIndex: {
|
|
16
|
+
isCompositeMetric: true,
|
|
17
|
+
unit: 'SI',
|
|
18
|
+
notADuration: true,
|
|
19
|
+
meaning: SPEED_INDEX_SEMANTICS,
|
|
20
|
+
reportAs: 'Report Speed Index values as "SI" (e.g. "1,240 SI"), never ms or seconds; a Speed Index target is a score, not a time.',
|
|
21
|
+
},
|
|
22
|
+
duration: { unit: 'ms', meaning: 'Wall-clock length of the transaction window.' },
|
|
23
|
+
};
|
|
24
|
+
//# sourceMappingURL=metric-semantics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"metric-semantics.js","sourceRoot":"","sources":["../../src/utils/metric-semantics.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAChC,0GAA0G;IAC1G,qGAAqG,CAAC;AACxG,MAAM,CAAC,MAAM,2BAA2B,GAAG,uEAAuE,CAAC;AAEnH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE;QACV,iBAAiB,EAAE,IAAI;QACvB,IAAI,EAAE,IAAI;QACV,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,qBAAqB;QAC9B,QAAQ,EAAE,wHAAwH;KACnI;IACD,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,8CAA8C,EAAE;CACzE,CAAC"}
|
|
@@ -9,4 +9,15 @@ export interface PaginatedResult<T> {
|
|
|
9
9
|
}
|
|
10
10
|
export declare function applyMaxResults<T>(items: T[], maxResults?: number): PaginatedResult<T>;
|
|
11
11
|
export declare function appendTruncationNotice(text: string, result: PaginatedResult<unknown>): string;
|
|
12
|
+
/**
|
|
13
|
+
* Add pagination facts to a structured (JSON) payload so a list cut at maxResults never looks complete. UAT 2026-10-09
|
|
14
|
+
* found list_available_browsers returning exactly 50 rows with no total and no truncation flag; most paged list tools
|
|
15
|
+
* had the same gap (only their human text carried the notice). Existing keys are never overwritten — some payloads
|
|
16
|
+
* already use `total` for something else.
|
|
17
|
+
*/
|
|
18
|
+
export declare function withPaging<S extends Record<string, unknown>>(structured: S, paged: Pick<PaginatedResult<unknown>, 'total' | 'returned' | 'truncated'>): S & {
|
|
19
|
+
total?: number;
|
|
20
|
+
returned?: number;
|
|
21
|
+
truncated?: boolean;
|
|
22
|
+
};
|
|
12
23
|
//# sourceMappingURL=pagination.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,GAAE,MAA4B,GACvC,eAAe,CAAC,CAAC,CAAC,CAepB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,CAK7F"}
|
|
1
|
+
{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,GAAE,MAA4B,GACvC,eAAe,CAAC,CAAC,CAAC,CAepB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,MAAM,CAK7F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAMtN"}
|
package/dist/utils/pagination.js
CHANGED
|
@@ -21,4 +21,20 @@ export function appendTruncationNotice(text, result) {
|
|
|
21
21
|
}
|
|
22
22
|
return text;
|
|
23
23
|
}
|
|
24
|
+
/**
|
|
25
|
+
* Add pagination facts to a structured (JSON) payload so a list cut at maxResults never looks complete. UAT 2026-10-09
|
|
26
|
+
* found list_available_browsers returning exactly 50 rows with no total and no truncation flag; most paged list tools
|
|
27
|
+
* had the same gap (only their human text carried the notice). Existing keys are never overwritten — some payloads
|
|
28
|
+
* already use `total` for something else.
|
|
29
|
+
*/
|
|
30
|
+
export function withPaging(structured, paged) {
|
|
31
|
+
const out = { ...structured };
|
|
32
|
+
if (!('total' in out))
|
|
33
|
+
out.total = paged.total;
|
|
34
|
+
if (!('returned' in out))
|
|
35
|
+
out.returned = paged.returned;
|
|
36
|
+
if (!('truncated' in out))
|
|
37
|
+
out.truncated = paged.truncated;
|
|
38
|
+
return out;
|
|
39
|
+
}
|
|
24
40
|
//# sourceMappingURL=pagination.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAUxC,MAAM,UAAU,eAAe,CAC7B,KAAU,EACV,aAAqB,mBAAmB;IAExC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;QAClD,KAAK;QACL,QAAQ;QACR,SAAS;QACT,gBAAgB,EAAE,SAAS;YACzB,CAAC,CAAC,eAAe,QAAQ,OAAO,KAAK,wEAAwE,oBAAoB,gBAAgB;YACjJ,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAgC;IACnF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
|
|
1
|
+
{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAUxC,MAAM,UAAU,eAAe,CAC7B,KAAU,EACV,aAAqB,mBAAmB;IAExC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,oBAAoB,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;QAClD,KAAK;QACL,QAAQ;QACR,SAAS;QACT,gBAAgB,EAAE,SAAS;YACzB,CAAC,CAAC,eAAe,QAAQ,OAAO,KAAK,wEAAwE,oBAAoB,gBAAgB;YACjJ,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAgC;IACnF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAoC,UAAa,EAAE,KAAyE;IACpJ,MAAM,GAAG,GAA4B,EAAE,GAAG,UAAU,EAAE,CAAC;IACvD,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC;QAAE,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACxD,IAAI,CAAC,CAAC,WAAW,IAAI,GAAG,CAAC;QAAE,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC3D,OAAO,GAAqE,CAAC;AAC/E,CAAC"}
|
package/dist/utils/path-guard.js
CHANGED
|
@@ -20,7 +20,7 @@ export function validateOutputPath(localPath) {
|
|
|
20
20
|
}
|
|
21
21
|
// Filenames that are credentials by convention. Uploading these to the cloud
|
|
22
22
|
// repository would publish them to every project member — the server's own
|
|
23
|
-
// .env holds the Cloud Admin
|
|
23
|
+
// .env holds the Cloud Admin credential.
|
|
24
24
|
const SENSITIVE_FILENAME_RE = /^(\.env(\..*)?|id_(rsa|dsa|ecdsa|ed25519)(\..*)?)$/i;
|
|
25
25
|
/**
|
|
26
26
|
* Validates that a user-supplied local path is safe to READ and upload to the
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"path-guard.js","sourceRoot":"","sources":["../../src/utils/path-guard.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,kBAAkB,SAAS,6BAA6B,CAAC;IAClE,CAAC;IACD,gFAAgF;IAChF,+CAA+C;IAC/C,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,kBAAkB,SAAS,sCAAsC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,
|
|
1
|
+
{"version":3,"file":"path-guard.js","sourceRoot":"","sources":["../../src/utils/path-guard.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,kBAAkB,SAAS,6BAA6B,CAAC;IAClE,CAAC;IACD,gFAAgF;IAChF,+CAA+C;IAC/C,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,kBAAkB,SAAS,sCAAsC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,2EAA2E;AAC3E,yCAAyC;AACzC,MAAM,qBAAqB,GAAG,qDAAqD,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,qBAAqB,SAAS,OAAO,QAAQ,oHAAoH,CAAC;IAC3K,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
|
|
@@ -5,7 +5,10 @@
|
|
|
5
5
|
* Named profiles follow the pattern:
|
|
6
6
|
*
|
|
7
7
|
* DAI_PROFILE_{NAME}_URL=https://tenant.experitest.com/
|
|
8
|
-
* DAI_PROFILE_{NAME}_KEY
|
|
8
|
+
* DAI_PROFILE_{NAME}_KEY=<access key>
|
|
9
|
+
*
|
|
10
|
+
* Key format is NOT a privilege indicator (a Cloud Admin may hold either an eyJ... JWT or a short
|
|
11
|
+
* aut_1_... key). A profile's access level is resolved from the API — see src/api/access-level.ts.
|
|
9
12
|
*
|
|
10
13
|
* Profile names are case-insensitive and normalised to lowercase internally.
|
|
11
14
|
* Examples:
|
|
@@ -21,7 +24,6 @@
|
|
|
21
24
|
export interface EnvironmentProfile {
|
|
22
25
|
name: string;
|
|
23
26
|
url: string;
|
|
24
|
-
keyType: 'jwt' | 'api-key';
|
|
25
27
|
}
|
|
26
28
|
/** All configured profiles without their keys — safe to surface in tool responses. */
|
|
27
29
|
export declare function listProfiles(): EnvironmentProfile[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"profile-loader.d.ts","sourceRoot":"","sources":["../../src/utils/profile-loader.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"profile-loader.d.ts","sourceRoot":"","sources":["../../src/utils/profile-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAiDD,sFAAsF;AACtF,wBAAgB,YAAY,IAAI,kBAAkB,EAAE,CAEnD;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAG5F;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,yDAAyD;AACzD,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
|
|
@@ -5,7 +5,10 @@
|
|
|
5
5
|
* Named profiles follow the pattern:
|
|
6
6
|
*
|
|
7
7
|
* DAI_PROFILE_{NAME}_URL=https://tenant.experitest.com/
|
|
8
|
-
* DAI_PROFILE_{NAME}_KEY
|
|
8
|
+
* DAI_PROFILE_{NAME}_KEY=<access key>
|
|
9
|
+
*
|
|
10
|
+
* Key format is NOT a privilege indicator (a Cloud Admin may hold either an eyJ... JWT or a short
|
|
11
|
+
* aut_1_... key). A profile's access level is resolved from the API — see src/api/access-level.ts.
|
|
9
12
|
*
|
|
10
13
|
* Profile names are case-insensitive and normalised to lowercase internally.
|
|
11
14
|
* Examples:
|
|
@@ -28,7 +31,6 @@ function loadProfiles() {
|
|
|
28
31
|
name: 'default',
|
|
29
32
|
url: defaultUrl.replace(/\/$/, ''),
|
|
30
33
|
key: defaultKey,
|
|
31
|
-
keyType: defaultKey.startsWith('eyJ') ? 'jwt' : 'api-key',
|
|
32
34
|
};
|
|
33
35
|
}
|
|
34
36
|
// Scan for DAI_PROFILE_*_URL pattern.
|
|
@@ -47,7 +49,6 @@ function loadProfiles() {
|
|
|
47
49
|
name: profileName,
|
|
48
50
|
url: value.replace(/\/$/, ''),
|
|
49
51
|
key: apiKey,
|
|
50
|
-
keyType: apiKey.startsWith('eyJ') ? 'jwt' : 'api-key',
|
|
51
52
|
};
|
|
52
53
|
}
|
|
53
54
|
return profiles;
|
|
@@ -62,7 +63,7 @@ function getProfiles() {
|
|
|
62
63
|
}
|
|
63
64
|
/** All configured profiles without their keys — safe to surface in tool responses. */
|
|
64
65
|
export function listProfiles() {
|
|
65
|
-
return Object.values(getProfiles()).map(({ name, url
|
|
66
|
+
return Object.values(getProfiles()).map(({ name, url }) => ({ name, url }));
|
|
66
67
|
}
|
|
67
68
|
/** Retrieve a profile's full credentials by name (case-insensitive). */
|
|
68
69
|
export function getProfileCredentials(name) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"profile-loader.js","sourceRoot":"","sources":["../../src/utils/profile-loader.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"profile-loader.js","sourceRoot":"","sources":["../../src/utils/profile-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAWH,SAAS,YAAY;IACnB,MAAM,QAAQ,GAAgC,EAAE,CAAC;IAEjD,gEAAgE;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACrD,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,GAAG;YACpB,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAClC,GAAG,EAAE,UAAU;SAChB,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,QAAQ,CAAC,WAAW,CAAC,GAAG;YACtB,IAAI,EAAE,WAAW;YACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7B,GAAG,EAAE,MAAM;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uFAAuF;AACvF,IAAI,SAAS,GAAuC,IAAI,CAAC;AAEzD,SAAS,WAAW;IAClB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,YAAY,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;AAC3C,CAAC"}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/** Read live (like getDeploymentMode) so tests can flip it; "true"/"1"/"yes", case-insensitive. */
|
|
2
|
+
export declare function isDebugMode(): boolean;
|
|
3
|
+
export declare const REMEDIATION_CATEGORIES: readonly ["error", "unclear-guidance", "user-correction", "gave-up", "better-path", "improvement"];
|
|
4
|
+
export type RemediationCategory = (typeof REMEDIATION_CATEGORIES)[number];
|
|
5
|
+
export declare const CATEGORY_TITLES: Record<RemediationCategory, string>;
|
|
6
|
+
/** yyyymmddhhmmss in local time (the user reads these names in their own directory). */
|
|
7
|
+
export declare function remediationStamp(d: Date): string;
|
|
8
|
+
interface SessionInfo {
|
|
9
|
+
id: string;
|
|
10
|
+
startedAt: Date;
|
|
11
|
+
mcpVersion: string;
|
|
12
|
+
toolsets: string;
|
|
13
|
+
client: () => {
|
|
14
|
+
name?: string;
|
|
15
|
+
version?: string;
|
|
16
|
+
} | undefined;
|
|
17
|
+
/** The client's workspace folders (MCP roots), as file:// URIs. */
|
|
18
|
+
roots?: () => Promise<string[]>;
|
|
19
|
+
location?: RemediationLocation;
|
|
20
|
+
}
|
|
21
|
+
export type LocationSource = 'env' | 'client-roots' | 'start-folder' | 'home';
|
|
22
|
+
export interface RemediationLocation {
|
|
23
|
+
dir: string;
|
|
24
|
+
source: LocationSource;
|
|
25
|
+
}
|
|
26
|
+
/** Called once at startup when debug mode is on. The short random suffix keeps parallel sessions apart. */
|
|
27
|
+
export declare function startRemediationSession(opts: {
|
|
28
|
+
mcpVersion: string;
|
|
29
|
+
toolsets: string;
|
|
30
|
+
client: SessionInfo['client'];
|
|
31
|
+
roots?: SessionInfo['roots'];
|
|
32
|
+
now?: Date;
|
|
33
|
+
}): SessionInfo;
|
|
34
|
+
export declare function getRemediationSession(): SessionInfo | null;
|
|
35
|
+
/** A folder counts as a project if it has a typical marker — never the home folder or a filesystem root. */
|
|
36
|
+
export declare function looksLikeProject(dir: string): boolean;
|
|
37
|
+
/**
|
|
38
|
+
* Where this session's files go, resolved once (the client's roots are only available after it has connected):
|
|
39
|
+
* MCP_REMEDIATION_DIR → first client workspace root → the server's start folder if it is a project → ~/remediation.
|
|
40
|
+
*/
|
|
41
|
+
export declare function resolveRemediationLocation(): Promise<RemediationLocation>;
|
|
42
|
+
/** The resolved folder, or the best synchronous guess before resolution. */
|
|
43
|
+
export declare function remediationDir(): string;
|
|
44
|
+
/** Create the folder with a ".gitignore" of "*" so it can never be committed to the project it lives in. */
|
|
45
|
+
export declare function ensureRemediationDir(dir?: string): void;
|
|
46
|
+
/** Only when the server's filesystem is the user's machine (npm/local install). */
|
|
47
|
+
export declare function canWriteLocally(): boolean;
|
|
48
|
+
/** Strip credentials and personal data before anything is written or returned. */
|
|
49
|
+
export declare function redact(text: string): string;
|
|
50
|
+
export type Outcome = 'ok' | 'error' | 'guard';
|
|
51
|
+
export interface ToolEvent {
|
|
52
|
+
type: 'tool';
|
|
53
|
+
at: string;
|
|
54
|
+
tool: string;
|
|
55
|
+
ms: number;
|
|
56
|
+
outcome: Outcome;
|
|
57
|
+
responseChars: number;
|
|
58
|
+
args: Record<string, string>;
|
|
59
|
+
/** The previous call to this tool ended in error/guard — a retry, often caused by unclear guidance. */
|
|
60
|
+
retryAfter?: Exclude<Outcome, 'ok'>;
|
|
61
|
+
/** Identical arguments to the previous call — a repeat that cannot have helped. */
|
|
62
|
+
repeatedArgs?: boolean;
|
|
63
|
+
/** A toolset placeholder fired (the toolset was not loaded) — one extra round trip. */
|
|
64
|
+
placeholder?: boolean;
|
|
65
|
+
/** First line of an error/guard response, for context. */
|
|
66
|
+
detail?: string;
|
|
67
|
+
}
|
|
68
|
+
/** Guard responses are deliberate stops (selector gate, size guard, confirmDeletion previews) — not failures. */
|
|
69
|
+
export declare function classifyOutcome(result: unknown): {
|
|
70
|
+
outcome: Outcome;
|
|
71
|
+
text: string;
|
|
72
|
+
};
|
|
73
|
+
export declare function recordToolEvent(e: {
|
|
74
|
+
tool: string;
|
|
75
|
+
args: unknown;
|
|
76
|
+
ms: number;
|
|
77
|
+
result: unknown;
|
|
78
|
+
placeholder?: boolean;
|
|
79
|
+
}): ToolEvent;
|
|
80
|
+
export declare function getRecordedEvents(): readonly ToolEvent[];
|
|
81
|
+
/** Compact, objective summary for a note: what the server saw, so the agent's account can be checked against it. */
|
|
82
|
+
export declare function summarizeEvents(list?: readonly ToolEvent[]): string;
|
|
83
|
+
/** One line, once per tool+outcome per session — enough to prompt a note without nagging. */
|
|
84
|
+
export declare function nudgeFor(tool: string, outcome: Outcome): string | null;
|
|
85
|
+
type Handler = (...a: unknown[]) => unknown;
|
|
86
|
+
/** Wrap a tool callback: time it, log the event, append a nudge on error/guard. Never changes the tool's own result. */
|
|
87
|
+
export declare function instrumentHandler(tool: string, callback: Handler, opts?: {
|
|
88
|
+
placeholder?: boolean;
|
|
89
|
+
}): Handler;
|
|
90
|
+
export interface RemediationNote {
|
|
91
|
+
category: RemediationCategory;
|
|
92
|
+
title: string;
|
|
93
|
+
intent: string;
|
|
94
|
+
whatHappened: string;
|
|
95
|
+
resolution?: string;
|
|
96
|
+
resolved?: boolean;
|
|
97
|
+
tools?: string[];
|
|
98
|
+
wastedCalls?: number;
|
|
99
|
+
userFeedback?: string;
|
|
100
|
+
suggestion?: string;
|
|
101
|
+
}
|
|
102
|
+
export declare function noteFileHeader(): string;
|
|
103
|
+
export declare function formatNote(note: RemediationNote, now?: Date): string;
|
|
104
|
+
/** Local: append to ~/remediation/<session>.md. Otherwise: return the text for the agent to save. */
|
|
105
|
+
export declare function saveNote(note: RemediationNote): {
|
|
106
|
+
written: string | null;
|
|
107
|
+
markdown: string;
|
|
108
|
+
fileName: string;
|
|
109
|
+
};
|
|
110
|
+
/** Instructions block appended to the server instructions when debug mode is on (kept short — it costs tokens). */
|
|
111
|
+
export declare function debugInstructions(): string;
|
|
112
|
+
export {};
|
|
113
|
+
//# sourceMappingURL=remediation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/utils/remediation.ts"],"names":[],"mappings":"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"}
|