@mablhq/playwright-tools 2.135.18 → 2.135.22

package/_bundled/@mablhq-internal/runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mablhq-internal/runtime",
-  "version": "2.135.18",
+  "version": "2.135.22",
   "main": "./index.js",
   "types": "./index.d.ts"
 }

package/_bundled/@mablhq-internal/runtime/trainer/generation/AgenticGenerationRunner.js

@@ -1265,7 +1265,25 @@ class AgenticGenerationRunner {
         }
         return result;
     }
+    userAuthoredObjective() {
+        if (this.config.objectiveIsUserAuthored) {
+            const locked = this.config.testIntent?.trim();
+            if (locked) {
+                return { summary: locked, source: mablApi_1.TestObjectiveSource.User };
+            }
+        }
+        const existing = this.config.existingTest?.objective;
+        if (existing?.source === mablApi_1.TestObjectiveSource.User &&
+            existing.summary?.trim()) {
+            return existing;
+        }
+        return undefined;
+    }
     async resolveTestObjective(summaryStepList, testDescription) {
+        const userAuthored = this.userAuthoredObjective();
+        if (userAuthored) {
+            return userAuthored;
+        }
         try {
             const { summary } = await this.config.apiClient.generateTestSummary(this.config.workspaceId, { fullStepList: summaryStepList, description: testDescription });
             const trimmed = summary?.trim();

package/_bundled/@mablhq-internal/test-model/mabl-authoring/authoringGuideResources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authoringGuideResources.d.ts","sourceRoot":"","sources":["../../src/mabl-authoring/authoringGuideResources.ts"],"names":[],"mappings":"AAcA,OAAO,EAAC,sBAAsB,EAAC,MAAM,SAAS,CAAC;AAwuC/C,qBAAa,uBAAuB;IAClC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAIxD,IAAI,IAAI,aAAa,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC;CAG1D"}
+{"version":3,"file":"authoringGuideResources.d.ts","sourceRoot":"","sources":["../../src/mabl-authoring/authoringGuideResources.ts"],"names":[],"mappings":"AAcA,OAAO,EAAC,sBAAsB,EAAC,MAAM,SAAS,CAAC;AA4uC/C,qBAAa,uBAAuB;IAClC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAIxD,IAAI,IAAI,aAAa,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC;CAG1D"}

package/_bundled/@mablhq-internal/test-model/mabl-authoring/authoringGuideResources.js

@@ -560,8 +560,12 @@ find calls.
 ## \`description\`
 
 A natural-language statement of what the element *is*, what it *does*,
-and (optionally) how it looks or where it sits on the page. Drives the
-description-driven visual resolver when the locator fails.
+and (optionally) how it looks or where it sits on the page. With a
+\`locator\`, it grounds the visual fallback when the locator fails. Without
+one, it is a visual-primary find, which is the right tool for elements with
+no persistent attributes: canvas content, chart points, map pins, SVG nodes,
+unlabeled icon buttons. When the element has an accessible name, a test id,
+or a stable id or role, pair the description with a \`locator\`.
 
 Combine purpose with whatever stable cues — color, position, layout,
 nearby text — actually help find the element. Visual descriptors are

package/_bundled/@mablhq-internal/test-model/validator/schemas/find-descriptors.d.ts

@@ -32,6 +32,9 @@ export declare const propertyComparatorEnum: z.ZodEnum<{
     contains: "contains";
     equals: "equals";
 }>;
+export declare const PRIMARY_FIND_METHOD_NATIVE_ATTRIBUTES = "1";
+export declare const PRIMARY_FIND_METHOD_ELEMENT_DESCRIPTION = "2";
+export declare const PRIMARY_FIND_METHOD_XPATH_ONLY = "3";
 export declare const primaryFindMethodEnum: z.ZodEnum<{
     1: "1";
     2: "2";

package/_bundled/@mablhq-internal/test-model/validator/schemas/find-descriptors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-descriptors.d.ts","sourceRoot":"","sources":["../../../src/validator/schemas/find-descriptors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"find-descriptors.d.ts","sourceRoot":"","sources":["../../../src/validator/schemas/find-descriptors.ts"],"names":[],"mappings":"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"}

package/_bundled/@mablhq-internal/test-model/validator/schemas/find-descriptors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mobileFindDescriptorSchema = exports.webViewFindElementDescriptorSchema = exports.mobileFindCustomDescriptorSchema = exports.mobileFindElementDescriptorSchema = exports.findDescriptorSchema = exports.findTabDescriptorSchema = exports.findEmailDescriptorSchema = exports.findCookieDescriptorSchema = exports.browserFindAuthoringSchema = exports.findCustomDescriptorSchema = exports.findElementDescriptorSchema = exports.browserFindDescriptorSchema = exports.browserFindTargetSchema = exports.cookieSelectorSchema = exports.mobileFindSpecificationSchema = exports.mobileElementSelectorSchema = exports.normalizedFindDescriptorSchema = exports.mobileFindOptionsSchema = exports.findOptionsSchema = exports.customCssSelectorSchema = exports.customXpathSelectorSchema = exports.simpleElementSelectorSchema = exports.primaryFindMethodEnum = exports.propertyComparatorEnum = exports.elementExpectationEnum = exports.confidenceLevelEnum = exports.NON_ELEMENT_FIND_TYPES = exports.ELEMENT_FIND_TYPES = exports.customFindTypeEnum = exports.findTypeEnum = void 0;
+exports.mobileFindDescriptorSchema = exports.webViewFindElementDescriptorSchema = exports.mobileFindCustomDescriptorSchema = exports.mobileFindElementDescriptorSchema = exports.findDescriptorSchema = exports.findTabDescriptorSchema = exports.findEmailDescriptorSchema = exports.findCookieDescriptorSchema = exports.browserFindAuthoringSchema = exports.findCustomDescriptorSchema = exports.findElementDescriptorSchema = exports.browserFindDescriptorSchema = exports.browserFindTargetSchema = exports.cookieSelectorSchema = exports.mobileFindSpecificationSchema = exports.mobileElementSelectorSchema = exports.normalizedFindDescriptorSchema = exports.mobileFindOptionsSchema = exports.findOptionsSchema = exports.customCssSelectorSchema = exports.customXpathSelectorSchema = exports.simpleElementSelectorSchema = exports.primaryFindMethodEnum = exports.PRIMARY_FIND_METHOD_XPATH_ONLY = exports.PRIMARY_FIND_METHOD_ELEMENT_DESCRIPTION = exports.PRIMARY_FIND_METHOD_NATIVE_ATTRIBUTES = exports.propertyComparatorEnum = exports.elementExpectationEnum = exports.confidenceLevelEnum = exports.NON_ELEMENT_FIND_TYPES = exports.ELEMENT_FIND_TYPES = exports.customFindTypeEnum = exports.findTypeEnum = void 0;
 const zod_1 = require("zod");
 const mablscriptFind_1 = require("../../mablscriptFind");
 const described_union_1 = require("./described-union");
@@ -35,8 +35,15 @@ exports.NON_ELEMENT_FIND_TYPES = new Set([
 exports.confidenceLevelEnum = zod_1.z.enum(['low', 'medium', 'high', 'unknown']);
 exports.elementExpectationEnum = zod_1.z.enum(['missing', 'present']);
 exports.propertyComparatorEnum = zod_1.z.enum(['equals', 'contains']);
+exports.PRIMARY_FIND_METHOD_NATIVE_ATTRIBUTES = '1';
+exports.PRIMARY_FIND_METHOD_ELEMENT_DESCRIPTION = '2';
+exports.PRIMARY_FIND_METHOD_XPATH_ONLY = '3';
 exports.primaryFindMethodEnum = zod_1.z
-    .enum(['1', '2', '3'])
+    .enum([
+    exports.PRIMARY_FIND_METHOD_NATIVE_ATTRIBUTES,
+    exports.PRIMARY_FIND_METHOD_ELEMENT_DESCRIPTION,
+    exports.PRIMARY_FIND_METHOD_XPATH_ONLY,
+])
     .describe('Primary element finding strategy: 1 = native attributes, 2 = element description (AI), 3 = XPath only');
 const selectorElementAttributeSchema = zod_1.z
     .object({

package/_bundled/@mablhq-internal/test-model/validator/validation/semantic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/validator/validation/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAKjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAozB1C,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAqDlB;AAMD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAqClB"}
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../src/validator/validation/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAKjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,WAAW,CAAC;AAm5B1C,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CA8DlB;AAMD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAqClB"}

package/_bundled/@mablhq-internal/test-model/validator/validation/semantic.js

@@ -96,6 +96,51 @@ function walkForUnwrappedFindTargets(descriptor, path, options) {
     }
     return results.length > 0 ? (0, errors_1.mergeResults)(...results) : (0, errors_1.emptyResult)();
 }
+const LOCATOR_EXPECTED_STEP_TYPES = new Set(['Click', 'EnterText']);
+function getPrimaryFindMethod(find, findTarget) {
+    const fromFind = isRecord(find.findOptions)
+        ? find.findOptions.primaryFindMethod
+        : undefined;
+    const fromTarget = isRecord(findTarget.findOptions)
+        ? findTarget.findOptions.primaryFindMethod
+        : undefined;
+    const value = fromFind ?? fromTarget;
+    return typeof value === 'string' ? value : undefined;
+}
+function checkDescriptionOnlyFind(descriptor, stepTypeName, path) {
+    if (!LOCATOR_EXPECTED_STEP_TYPES.has(stepTypeName)) {
+        return (0, errors_1.emptyResult)();
+    }
+    const find = descriptor.find;
+    if (!isRecord(find) || !isRecord(find.findTarget)) {
+        return (0, errors_1.emptyResult)();
+    }
+    if (typeof find.findType === 'string' &&
+        find_descriptors_1.NON_ELEMENT_FIND_TYPES.has(find.findType)) {
+        return (0, errors_1.emptyResult)();
+    }
+    const selector = find.findTarget.selector;
+    if (!isRecord(selector)) {
+        return (0, errors_1.emptyResult)();
+    }
+    const hasText = (value) => typeof value === 'string' && value.trim().length > 0;
+    const describesElement = hasText(selector.description) || hasText(selector.find_prompt);
+    if (!describesElement ||
+        hasText(selector.locator) ||
+        hasText(selector.xpath) ||
+        hasText(selector.css_query)) {
+        return (0, errors_1.emptyResult)();
+    }
+    const isDeliberateVisualFind = hasText(selector.find_prompt_prompt_id) ||
+        getPrimaryFindMethod(find, find.findTarget) ===
+            find_descriptors_1.PRIMARY_FIND_METHOD_ELEMENT_DESCRIPTION;
+    if (isDeliberateVisualFind) {
+        return (0, errors_1.emptyResult)();
+    }
+    return (0, errors_1.warningResult)([...path, 'find', 'findTarget', 'selector', 'locator'], 'This find has a `description` and no `locator`, so it resolves as a pure visual find — the visual model matches it from a screenshot on every run. That is the right call for an element with no persistent attributes, but if this one has an accessible name, a test id, or a stable id or role, pair the description with a `locator`.', 'semantic.find_description_only', {
+        suggestion: 'Add a `locator` built from the element\'s accessible name or a stable attribute, e.g. `role=button[name="Remove integration"]` or `[data-testid="remove-integration"]`. The locator resolves in milliseconds and the description still grounds the visual fallback.',
+    });
+}
 const SOURCE_EXTRACT_RULES = {
     url: {
         label: 'URL',
@@ -371,6 +416,10 @@ function validateStepSemantics(step, stepIndex, options) {
     if (!findTargetResult.valid || findTargetResult.warnings.length > 0) {
         resultsToMerge.push(findTargetResult);
     }
+    const descriptionOnlyResult = checkDescriptionOnlyFind(desc, stepTypeName, path);
+    if (descriptionOnlyResult.warnings.length > 0) {
+        resultsToMerge.push(descriptionOnlyResult);
+    }
     let typeSpecific = (0, errors_1.emptyResult)();
     if (ASSERT_STEP_TYPES.has(stepTypeName)) {
         typeSpecific = validateAssertSemantics(desc, path, options);

package/commands/link-agents/link-agents_cmds/start.js

@@ -385,7 +385,13 @@ async function superviseTunnel(spec, shared) {
     const tunnelName = spec.configTunnel?.name ?? parsed[CommandArgTunnel];
     const { apiClient, auth } = await resolveApiClientAndAuth(config, spec.configTunnel, (0, linkAgentUserAgent_1.linkAgentUserAgent)(CLI_VERSION, tunnelName));
     const { owner, label: requestedLabel } = await resolveOwnerAndLabel(parsed, auth, apiClient, spec.configTunnel, tunnelName);
-    const announced = await apiClient.announceMablnetLinkAgent(buildAnnounce(parsed, config, owner, requestedLabel, shared.osSettings, shared.carrierHttpProxy, shared.tunnelsOnHost()));
+    const announced = await apiClient
+        .announceMablnetLinkAgent(buildAnnounce(parsed, config, owner, requestedLabel, shared.osSettings, shared.carrierHttpProxy, shared.tunnelsOnHost()))
+        .catch((error) => {
+        throw ((owner.type === 'user'
+            ? (0, execution_1.describePersonalTunnelDenial)(error, apiClient)
+            : undefined) ?? error);
+    });
     try {
         const label = announced.label ?? requestedLabel;
         if (!label) {