@loadmill/droid-cua 2.28.0 → 2.30.0

package/build/src/cli/headless-target.js

@@ -1,3 +1,4 @@
+import { CLOUD_BROWSER_FAMILIES, CLOUD_BROWSER_VERSION_ALIASES, LOCAL_BROWSER_FAMILIES, } from "../browser/cloud-browser-catalog.js";
 function normalizeTarget(value) {
     if (value == null || value === "") {
         return "mobile";
@@ -24,18 +25,31 @@ function normalizeSessionMode(value) {
     }
     throw new Error("--session-mode must be one of: persistent, fresh.");
 }
-function normalizeBrowser(value) {
+function normalizeBrowser(value, allowedFamilies) {
     if (value == null || value === "") {
         return "chrome";
     }
     if (typeof value !== "string") {
-        throw new Error("--browser must be one of: chrome, edge.");
+        throw new Error(`--browser must be one of: ${allowedFamilies.join(", ")}.`);
     }
     const normalized = value.trim().toLowerCase();
-    if (normalized === "chrome" || normalized === "edge") {
+    if (allowedFamilies.includes(normalized)) {
         return normalized;
     }
-    throw new Error("--browser must be one of: chrome, edge.");
+    throw new Error(`--browser must be one of: ${allowedFamilies.join(", ")}.`);
+}
+function normalizeCloudBrowserVersion(value) {
+    if (value == null || value === "") {
+        return "latest";
+    }
+    if (typeof value !== "string") {
+        throw new Error(`--browser-version must be one of: ${CLOUD_BROWSER_VERSION_ALIASES.join(", ")}.`);
+    }
+    const normalized = value.trim().toLowerCase();
+    if (CLOUD_BROWSER_VERSION_ALIASES.includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`--browser-version must be one of: ${CLOUD_BROWSER_VERSION_ALIASES.join(", ")}.`);
 }
 const CLOUD_SOURCE_DISPLAY_NAMES = {
     lambdatest: "LambdaTest",
@@ -80,25 +94,48 @@ function readNonEmptyCliValue(value) {
     }
     return null;
 }
-const ARTIFACT_KINDS = ["video", "deviceLog", "appiumLog"];
-function normalizeArtifactKinds(value) {
+export const MOBILE_ARTIFACT_KINDS = ["video", "deviceLog", "appiumLog"];
+export const WEB_ARTIFACT_KINDS = ["video", "seleniumLog"];
+const UNRESOLVED_POOL_ARTIFACT_KINDS = [...MOBILE_ARTIFACT_KINDS, "seleniumLog"];
+const ARTIFACT_KINDS_BY_POOL = {
+    mobile: MOBILE_ARTIFACT_KINDS,
+    web: WEB_ARTIFACT_KINDS,
+};
+export function artifactKindsForPool(pool) {
+    const kinds = ARTIFACT_KINDS_BY_POOL[pool];
+    if (!kinds) {
+        throw new Error(`Unknown Loadmill Cloud pool: ${pool}. Expected "mobile" or "web".`);
+    }
+    return [...kinds];
+}
+export function scopeArtifactKindsToPool(kinds, pool) {
+    const allowed = artifactKindsForPool(pool);
+    return kinds.filter((kind) => allowed.includes(kind));
+}
+function allowedArtifactKindsForTarget(target, poolKnown) {
+    if (!poolKnown) {
+        return UNRESOLVED_POOL_ARTIFACT_KINDS;
+    }
+    return target === "web" ? WEB_ARTIFACT_KINDS : MOBILE_ARTIFACT_KINDS;
+}
+function normalizeArtifactKinds(value, allowedKinds) {
     if (value == null || value === "") {
         return null;
     }
     if (typeof value !== "string") {
-        throw new Error(`--artifacts must be a comma-separated list of: ${ARTIFACT_KINDS.join(", ")}, or all.`);
+        throw new Error(`--artifacts must be a comma-separated list of: ${allowedKinds.join(", ")}, or all.`);
     }
     const raw = value.trim();
     if (!raw) {
         return null;
     }
     if (raw.toLowerCase() === "all") {
-        return [...ARTIFACT_KINDS];
+        return [...allowedKinds];
     }
     const kinds = [...new Set(raw.split(",").map((kind) => kind.trim()).filter(Boolean))];
-    const invalid = kinds.filter((kind) => !ARTIFACT_KINDS.includes(kind));
+    const invalid = kinds.filter((kind) => !allowedKinds.includes(kind));
     if (invalid.length > 0) {
-        throw new Error(`--artifacts has invalid kind(s): ${invalid.join(", ")}. Must be one of: ${ARTIFACT_KINDS.join(", ")}, or all.`);
+        throw new Error(`--artifacts has invalid kind(s): ${invalid.join(", ")}. Must be one of: ${allowedKinds.join(", ")}, or all.`);
     }
     return kinds;
 }
@@ -144,9 +181,10 @@ function normalizeCloudAppPath(value, platform, deviceSource) {
 export function shouldWaitForLoadmillCloudCompletion(targetConfig) {
     return Array.isArray(targetConfig?.artifacts) && targetConfig.artifacts.length > 0;
 }
+const MOBILE_ONLY_CLOUD_SOURCES = new Set(["lambdatest", "aws-device-farm"]);
 export function resolveHeadlessTarget(args = {}) {
     const target = normalizeTarget(args.target);
-    const sessionMode = normalizeSessionMode(args["session-mode"]);
+    const targetGiven = hasNonEmptyString(args.target);
     const avdName = hasNonEmptyString(args.avd) ? args.avd.trim() : null;
     const platform = normalizeMobilePlatform(args.platform, "--platform");
     // The mtc_ prefix on --cloud-session-id is loadmill-cloud's; when no
@@ -164,14 +202,44 @@ export function resolveHeadlessTarget(args = {}) {
         if (avdName || platform) {
             throw new Error("--avd and --platform cannot be used with --target web.");
         }
-        if (deviceSource !== "local") {
-            throw new Error("--device-source can only be used with --target mobile.");
+        if (MOBILE_ONLY_CLOUD_SOURCES.has(deviceSource)) {
+            throw new Error(`--device-source ${deviceSource} can only be used with --target mobile.`);
+        }
+        if (hasNonEmptyString(args["device-name"])) {
+            throw new Error("--device-name cannot be used with --target web.");
+        }
+        if (readNonEmptyCliValue(args["os-version"]) != null) {
+            throw new Error("--os-version cannot be used with --target web.");
+        }
+        if (hasNonEmptyString(args.app)) {
+            throw new Error("--app cannot be used with --target web.");
+        }
+        if (deviceSource === "loadmill-cloud") {
+            if (args["session-mode"] != null) {
+                throw new Error("--session-mode can only be used with --device-source local.");
+            }
+            return {
+                target,
+                sessionMode: null,
+                browserFamily: normalizeBrowser(args.browser, CLOUD_BROWSER_FAMILIES),
+                browserVersion: normalizeCloudBrowserVersion(args["browser-version"]),
+                deviceSource: "loadmill-cloud",
+                avdName: null,
+                platform: null,
+                deviceName: null,
+                osVersion: null,
+                appPath: null,
+                cloudSessionId: readNonEmptyCliValue(args["cloud-session-id"]),
+                artifacts: normalizeArtifactKinds(args.artifacts, WEB_ARTIFACT_KINDS),
+                listDevices: false,
+            };
         }
         assertNoCloudFlags(args);
         return {
             target,
-            sessionMode,
-            browserFamily: normalizeBrowser(args.browser),
+            sessionMode: normalizeSessionMode(args["session-mode"]),
+            browserFamily: normalizeBrowser(args.browser, LOCAL_BROWSER_FAMILIES),
+            browserVersion: null,
             deviceSource: "local",
             avdName: null,
             platform: null,
@@ -195,6 +263,7 @@ export function resolveHeadlessTarget(args = {}) {
             target,
             sessionMode: null,
             browserFamily: null,
+            browserVersion: null,
             deviceSource,
             avdName: null,
             platform: null,
@@ -215,7 +284,7 @@ export function resolveHeadlessTarget(args = {}) {
         const cloudSessionId = readNonEmptyCliValue(args["cloud-session-id"]);
         const isReconnect = deviceSource === "loadmill-cloud" && Boolean(cloudSessionId);
         const appPath = normalizeCloudAppPath(args.app, platform, deviceSource);
-        const artifacts = normalizeArtifactKinds(args.artifacts);
+        const artifacts = normalizeArtifactKinds(args.artifacts, allowedArtifactKindsForTarget(target, targetGiven || !isReconnect));
         if (artifacts && deviceSource !== "loadmill-cloud") {
             throw new Error("--artifacts can only be used with --device-source loadmill-cloud.");
         }
@@ -241,6 +310,7 @@ export function resolveHeadlessTarget(args = {}) {
             target,
             sessionMode: null,
             browserFamily: null,
+            browserVersion: null,
             deviceSource,
             avdName: null,
             platform,
@@ -256,6 +326,7 @@ export function resolveHeadlessTarget(args = {}) {
         target,
         sessionMode: null,
         browserFamily: null,
+        browserVersion: null,
         deviceSource,
         avdName,
         platform,

package/build/src/cli/headless-test-source-label.js

@@ -0,0 +1,4 @@
+const INLINE_SOURCE_PATTERN = /^\/dev\/(fd\/\d+|stdin)$/;
+export function formatHeadlessTestSourceLabel(sourcePath) {
+    return INLINE_SOURCE_PATTERN.test(sourcePath) ? "(inline instructions)" : sourcePath;
+}

package/build/src/cli/loadmill-cloud-device-connect-summary.js

@@ -0,0 +1,6 @@
+export function buildLoadmillCloudDeviceConnectSummaryLines({ deviceInfo }) {
+    return [
+        `Using real resolution: ${deviceInfo.device_width}x${deviceInfo.device_height}`,
+        `Model sees resolution: ${deviceInfo.scaled_width}x${deviceInfo.scaled_height}`,
+    ];
+}

package/build/src/cli/loadmill-cloud-session.js

@@ -0,0 +1,26 @@
+export async function withLoadmillCloudSession({ credentials, connect, teardown, run = null }) {
+    const targetId = await connect(credentials);
+    if (typeof run !== "function") {
+        return targetId;
+    }
+    try {
+        return await run(targetId);
+    }
+    finally {
+        await teardown();
+    }
+}
+export function createBrowserSessionTeardown({ disconnect, releaseSession }) {
+    return async () => {
+        try {
+            await disconnect();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[loadmill-cloud] browser disconnect failed: ${message}`);
+        }
+        finally {
+            await releaseSession();
+        }
+    };
+}

package/build/src/core/context-optimization.js

@@ -1,5 +1,5 @@
 export const DEFAULT_CONTEXT_OPTIMIZATION_ENABLED = true;
-export const DEFAULT_CONTEXT_OPTIMIZATION_THRESHOLD = 30000;
+export const DEFAULT_CONTEXT_OPTIMIZATION_THRESHOLD = 60000;
 export const MIN_CONTEXT_OPTIMIZATION_THRESHOLD = 10000;
 export const MAX_CONTEXT_OPTIMIZATION_THRESHOLD = 900000;
 export const CONTEXT_OPTIMIZATION_ENABLED_ENV = "DROID_CUA_CONTEXT_OPTIMIZATION_ENABLED";

package/build/src/core/execution-engine.js

@@ -503,6 +503,15 @@ export class ExecutionEngine {
     }
     emitResponseOutputItems(items, addOutput, eventMeta, options = {}) {
         for (const item of items) {
+            if (item.type === "compaction") {
+                addOutput({
+                    type: "info",
+                    text: "Optimized context",
+                    eventType: "system_message",
+                    ...eventMeta({ payload: { event: "context.optimized" } }),
+                });
+                continue;
+            }
             if (item.type === "reasoning") {
                 for (const entry of item.summary) {
                     if (entry.type !== "summary_text")

package/build/src/core/report/render-html-report.js

@@ -3,6 +3,8 @@
 // no external references — screenshots must already be inlined as data URLs in
 // `event.payload.screenshotDataUrl`. Use generate-html-report.js to inline them.
 import { assertionData, formatDuration, hasNearbyAssertionCard, isAssistantAssertionSummary, isDuplicateAssertionLine, isHiddenExecutionLogEvent, runSummaryData, stepCompletionData, stepCompletionReasonTooltip, } from "./run-log-model.js";
+import { buildRunReportSections, capitalizeReportLine, cloudProviderId, cloudProviderLabel, cloudStatus, } from "./run-report-sections.js";
+import { LOADMILL_MARK_PATHS } from "../../brand/loadmill-mark.js";
 // ---------- text / value formatting (mirrors the Desktop App) ----------
 function escapeHtml(value) {
     return String(value ?? "")
@@ -12,6 +14,22 @@ function escapeHtml(value) {
         .replace(/"/g, """)
         .replace(/'/g, "'");
 }
+function renderLinkedText(value) {
+    const text = String(value ?? "");
+    const pattern = /https?:\/\/[^\s]+/g;
+    let cursor = 0;
+    let html = "";
+    for (const match of text.matchAll(pattern)) {
+        const start = match.index ?? 0;
+        const raw = match[0];
+        const trailing = raw.match(/[).,;:!?]+$/)?.[0] ?? "";
+        const url = trailing ? raw.slice(0, -trailing.length) : raw;
+        html += escapeHtml(text.slice(cursor, start));
+        html += `<a href="${escapeHtml(url)}" target="_blank" rel="noreferrer">${escapeHtml(url)}</a>${escapeHtml(trailing)}`;
+        cursor = start + raw.length;
+    }
+    return html + escapeHtml(text.slice(cursor));
+}
 function formatRunTimestamp(iso) {
     if (!iso)
         return "—";
@@ -95,10 +113,16 @@ function screenshotImg(event, shots) {
 function icon(name, shapes) {
     return `<svg class="dc-icon" data-icon="${name}" aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${shapes}</svg>`;
 }
+function loadmillIcon() {
+    const paths = LOADMILL_MARK_PATHS.map(({ d, fill }) => `<path d="${d}" fill="${fill}"/>`).join("");
+    return `<svg class="dc-icon" data-icon="loadmill-mark" aria-hidden="true" viewBox="0 0 1035 1035">${paths}</svg>`;
+}
 const ICONS = {
     arrowUpDown: icon("arrow-up-down", `<path d="m21 16-4 4-4-4"/><path d="M17 20V4"/><path d="m3 8 4-4 4 4"/><path d="M7 4v16"/>`),
+    bookOpen: icon("book-open", `<path d="M12 7v14"/><path d="M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"/>`),
     botMessageSquare: icon("bot-message-square", `<path d="M12 6V2H8"/><path d="m8 18-4 4V8a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2Z"/><path d="M2 12h2"/><path d="M9 11v2"/><path d="M15 11v2"/><path d="M20 12h2"/>`),
     camera: icon("camera", `<path d="M14.5 4h-5L7 7H4a2 2 0 0 0-2 2v9a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V9a2 2 0 0 0-2-2h-3l-2.5-3z"/><circle cx="12" cy="13" r="3"/>`),
+    cloud: icon("cloud", `<path d="M17.5 19H9a7 7 0 1 1 6.71-9h1.79a4.5 4.5 0 1 1 0 9Z"/>`),
     compass: icon("compass", `<path d="m16.24 7.76-1.804 5.411a2 2 0 0 1-1.265 1.265L7.76 16.24l1.804-5.411a2 2 0 0 1 1.265-1.265z"/><circle cx="12" cy="12" r="10"/>`),
     flag: icon("flag", `<path d="M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"/><line x1="4" x2="4" y1="22" y2="15"/>`),
     keyboard: icon("keyboard", `<path d="M10 8h.01"/><path d="M12 12h.01"/><path d="M14 8h.01"/><path d="M16 12h.01"/><path d="M18 8h.01"/><path d="M6 8h.01"/><path d="M7 16h10"/><path d="M8 12h.01"/><rect width="20" height="16" x="2" y="4" rx="2"/>`),
@@ -109,6 +133,7 @@ const ICONS = {
     rotateCcw: icon("rotate-ccw", `<path d="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8"/><path d="M3 3v5h5"/>`),
     squareX: icon("square-x", `<rect width="18" height="18" x="3" y="3" rx="2"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/>`),
     timer: icon("timer", `<line x1="10" x2="14" y1="2" y2="2"/><line x1="12" x2="15" y1="14" y2="11"/><circle cx="12" cy="14" r="8"/>`),
+    loadmill: loadmillIcon(),
 };
 function actionIcon(event) {
     const lowerText = event.text.toLowerCase();
@@ -137,6 +162,9 @@ function actionIcon(event) {
 function renderAgentText(text) {
     return `<div class="dc-line dc-agent-line">${ICONS.botMessageSquare}<span>${escapeHtml(text)}</span></div>`;
 }
+function textIcon(value) {
+    return `<span class="dc-icon" aria-hidden="true">${value}</span>`;
+}
 // ---------- per-event timeline rendering (mirrors ExecutionLogItem.tsx) ----------
 function renderEvent(event, shots) {
     if (isHiddenExecutionLogEvent(event))
@@ -153,13 +181,13 @@ function renderEvent(event, shots) {
                     : "Test Failed";
         const badge = summary.status === "passed" ? "PASS" : summary.status === "stopped" ? "STOPPED" : summary.status === "errored" ? "ERROR" : "FAIL";
         return `<div class="dc-card dc-${cls}">
-  <div class="dc-card-head"><span class="dc-card-title">${escapeHtml(label)}</span><span class="dc-pill dc-pill-${cls}">${escapeHtml(badge)}</span></div>
+  <div class="dc-card-head"><span class="dc-card-title">${textIcon(summary.status === "passed" ? "✓" : "!")}${escapeHtml(label)}</span><span class="dc-pill dc-pill-${cls}">${escapeHtml(badge)}</span></div>
   <div class="dc-card-body">
     <div>Duration: ${escapeHtml(formatDuration(summary.durationMs))}</div>
     <div>Steps: ${summary.instructionsCompleted ?? 0}/${summary.instructionsTotal ?? 0}</div>
     <div>Assertions: ${summary.assertionsPassed ?? 0}/${(summary.assertionsPassed ?? 0) + (summary.assertionsFailed ?? 0)}</div>
     <div>Retries: ${summary.retries ?? 0}</div>
-  </div>${summary.error ? `\n  <div class="dc-card-error">${escapeHtml(summary.error)}</div>` : ""}
+  </div>${summary.error ? `\n  <div class="dc-card-error">${renderLinkedText(summary.error)}</div>` : ""}
 </div>`;
     }
     const isInstruction = event.eventType === "instruction_started" || event.kind === "user";
@@ -186,7 +214,7 @@ function renderEvent(event, shots) {
         const cls = assertion.passed ? "pass" : "fail";
         const img = screenshotImg(event, shots);
         return `<div class="dc-card dc-${cls}">
-  <div class="dc-card-head"><span class="dc-card-title">${assertion.passed ? "Assertion Passed" : "Assertion Failed"}${img}</span><span class="dc-pill dc-pill-${cls}">${assertion.passed ? "PASS" : "FAIL"}</span></div>
+  <div class="dc-card-head"><span class="dc-card-title">${textIcon(assertion.passed ? "✓" : "!")}${assertion.passed ? "Assertion Passed" : "Assertion Failed"}${img}</span><span class="dc-pill dc-pill-${cls}">${assertion.passed ? "PASS" : "FAIL"}</span></div>
   <div class="dc-assertion">${escapeHtml(assertion.assertion)}</div>${assertion.details ? `\n  <div class="dc-assertion-details">${escapeHtml(assertion.details)}</div>` : ""}
 </div>`;
     }
@@ -194,18 +222,64 @@ function renderEvent(event, shots) {
         return `<div class="dc-line dc-retry">${ICONS.rotateCcw}<span>${escapeHtml(event.text)}</span></div>`;
     }
     if (event.kind === "action") {
-        return `<div class="dc-line">${actionIcon(event)}<span>${escapeHtml(event.text)}</span>${screenshotImg(event, shots)}</div>`;
+        return `<div class="dc-line dc-action">${actionIcon(event)}<span>${escapeHtml(event.text)}</span>${screenshotImg(event, shots)}</div>`;
     }
     if (event.eventType === "screenshot_captured") {
         return `<div class="dc-line">${ICONS.camera}<span>${escapeHtml(event.text)}</span>${screenshotImg(event, shots)}</div>`;
     }
-    return `<div class="dc-line dc-${escapeHtml(event.kind)}">${escapeHtml(event.text)}</div>`;
+    if (event.eventType === "design_generated_script" || (event.eventType === "tool_call" && event.payload?.toolName === "test_design_complete")) {
+        return `<div class="dc-line">${textIcon("✦")}<span>${escapeHtml(event.text)}</span></div>`;
+    }
+    return `<div class="dc-line dc-${escapeHtml(event.kind)}">${renderLinkedText(event.text)}</div>`;
 }
-function renderTimeline(events, shots) {
-    return buildVisibleEvents(events)
-        .map((event) => renderEvent(event, shots))
+function renderAppContextCard(event) {
+    const text = typeof event.payload?.text === "string" ? event.payload.text.trim() : "";
+    if (!text)
+        return "";
+    return `<details class="dc-special dc-context">
+  <summary><span class="dc-special-title">${ICONS.bookOpen}App Context</span></summary>
+  <pre>${escapeHtml(text)}</pre>
+</details>`;
+}
+function renderCloudCard(events) {
+    const label = cloudProviderLabel(events.map(cloudProviderId).find(Boolean));
+    const status = cloudStatus(events);
+    const lines = events
+        .filter((event) => event.payload?.event !== "cloud.app.check" && event.payload?.event !== "cloud.app.reupload_needed")
+        .map((event) => capitalizeReportLine(event.text))
+        .filter((text, index, all) => text !== all[index - 1]);
+    return `<details class="dc-special dc-cloud"${status === "issue" || status === "starting" ? " open" : ""}>
+  <summary><span class="dc-special-title">${ICONS.cloud}${escapeHtml(label)}</span><span class="dc-pill dc-pill-${status}">${status}</span></summary>
+  <div class="dc-special-body">${lines.map((line) => `<div>${renderLinkedText(line)}</div>`).join("")}</div>
+</details>`;
+}
+function renderLoadmillCard(events) {
+    const lines = events.map((event) => event.text.replace(/^\[Loadmill\]\s*/, "").trim());
+    const failed = events.some((event) => /\[Loadmill\]\s*FAILED|^Error:/i.test(event.text));
+    const passed = !failed && events.some((event) => /\bpassed\b/i.test(event.text));
+    const status = failed ? "failed" : passed ? "passed" : "running";
+    return `<details class="dc-special dc-loadmill"${passed ? "" : " open"}>
+  <summary><span class="dc-special-title">${ICONS.loadmill}Loadmill Flow</span><span class="dc-pill dc-pill-${status}">${status}</span></summary>
+  <div class="dc-special-body">${lines.map((line) => `<div>${renderLinkedText(line)}</div>`).join("")}</div>
+</details>`;
+}
+function renderTimeline(events, shots, warnings = []) {
+    const html = buildRunReportSections(buildVisibleEvents(events))
+        .map((item) => {
+        if (item.kind === "app-context")
+            return renderAppContextCard(item.line);
+        if (item.kind === "cloud")
+            return renderCloudCard(item.lines);
+        if (item.kind === "loadmill")
+            return renderLoadmillCard(item.lines);
+        return renderEvent(item.line, shots);
+    })
         .filter(Boolean)
         .join("\n");
+    if (html)
+        return html;
+    const message = warnings.find((warning) => warning.toLowerCase().includes("event log not available")) ?? "No event timeline available for this report.";
+    return `<div class="dc-empty">${escapeHtml(message)}</div>`;
 }
 // Full-size overlays, one per screenshot. Shown via the CSS `:target` rule, so
 // click-to-enlarge and prev/next/close work with JavaScript disabled.
@@ -290,7 +364,7 @@ body { margin: 0; background: #f1f5f9; color: #0f172a; font-family: -apple-syste
 .dc-test-row { display: grid; grid-template-columns: 1fr 90px 90px; align-items: center; gap: 8px; padding: 6px 8px; border: 1px solid #e2e8f0; border-radius: 8px; margin-bottom: 6px; }
 .dc-test-name { font-weight: 500; color: #334155; }
 .dc-test-dur { font-family: ui-monospace, SFMono-Regular, Menlo, monospace; color: #64748b; font-size: 12px; }
-.dc-timeline { background: #fff; border: 1px solid #cbd5e1; border-radius: 12px; padding: 16px; display: flex; flex-direction: column; gap: 8px; }
+.dc-timeline { background: #fff; border: 1px solid #cbd5e1; border-radius: 12px; padding: 20px 24px; display: flex; flex-direction: column; gap: 8px; }
 .dc-child-block { margin-top: 12px; }
 .dc-child-head { font-size: 13px; font-weight: 600; color: #334155; margin: 8px 0; }
 .dc-row { display: flex; }
@@ -300,6 +374,9 @@ body { margin: 0; background: #f1f5f9; color: #0f172a; font-family: -apple-syste
 .dc-agent-line { align-items: flex-start; }
 .dc-agent-line .dc-icon { margin-top: 4px; }
 .dc-icon { width: 14px; height: 14px; flex: 0 0 auto; color: #94a3b8; }
+.dc-line a, .dc-card-error a, .dc-special-body a { color: inherit; font-weight: 500; text-underline-offset: 2px; }
+.dc-action { position: relative; min-height: 24px; }
+.dc-action + .dc-action::before { content: ""; position: absolute; left: 7px; top: -9px; height: 10px; border-left: 1px solid #cbd5e1; }
 .dc-retry { color: #b45309; }
 .dc-error { color: #b91c1c; }
 .dc-warning { color: #b45309; }
@@ -318,7 +395,7 @@ body { margin: 0; background: #f1f5f9; color: #0f172a; font-family: -apple-syste
 .dc-lightbox-next { right: 10px; }
 .dc-card { border: 1px solid; border-radius: 12px; padding: 12px 14px; }
 .dc-card-head { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 6px; }
-.dc-card-title { font-size: 13px; font-weight: 600; display: inline-flex; align-items: center; }
+.dc-card-title { font-size: 13px; font-weight: 600; display: inline-flex; align-items: center; gap: 6px; }
 .dc-card-body > div { margin: 1px 0; }
 .dc-card-error, .dc-assertion-details { margin-top: 6px; font-size: 13px; }
 .dc-assertion { font-size: 14px; }
@@ -331,6 +408,23 @@ body { margin: 0; background: #f1f5f9; color: #0f172a; font-family: -apple-syste
 .dc-pill-error, .dc-pill-errored, .dc-pill-amber { border-color: #fcd34d; background: #fef3c7; color: #b45309; }
 .dc-pill-stopped { border-color: #fdba74; background: #ffedd5; color: #c2410c; }
 .dc-pill-skipped { border-color: #cbd5e1; background: #f1f5f9; color: #334155; }
+.dc-pill-ready, .dc-pill-passed { border-color: #6ee7b7; background: #d1fae5; color: #047857; }
+.dc-pill-issue, .dc-pill-failed { border-color: #fda4af; background: #ffe4e6; color: #be123c; }
+.dc-pill-ended { border-color: #cbd5e1; background: #f1f5f9; color: #334155; }
+.dc-pill-starting { border-color: #a5b4fc; background: #e0e7ff; color: #4338ca; }
+.dc-pill-running { border-color: #7dd3fc; background: #e0f2fe; color: #0369a1; }
+.dc-special { width: 100%; border: 1px solid; border-radius: 12px; padding: 11px 14px; }
+.dc-special summary { display: flex; align-items: center; justify-content: space-between; gap: 12px; cursor: pointer; list-style: none; }
+.dc-special summary::-webkit-details-marker { display: none; }
+.dc-special summary::before { content: "›"; margin-right: 4px; color: currentColor; font-size: 18px; line-height: 1; transform-origin: center; }
+.dc-special[open] summary::before { transform: rotate(90deg); }
+.dc-special-title { display: inline-flex; flex: 1; align-items: center; gap: 5px; font-size: 13px; font-weight: 600; }
+.dc-special-body { margin-top: 9px; display: flex; flex-direction: column; gap: 5px; color: #334155; }
+.dc-context { border-color: #ddd6fe; background: #f5f3ff; color: #4c1d95; }
+.dc-context pre { margin: 10px 0 0; border: 1px solid #ede9fe; border-radius: 8px; background: rgba(255,255,255,.75); padding: 8px 10px; color: #334155; font: 12px/1.6 ui-monospace, SFMono-Regular, Menlo, monospace; white-space: pre-wrap; }
+.dc-cloud { border-color: #c7d2fe; background: #eef2ff; color: #312e81; }
+.dc-loadmill { border-color: #bae6fd; background: #f0f9ff; color: #075985; }
+.dc-empty { color: #64748b; }
 @keyframes dc-spin { to { transform: rotate(360deg); } }
 `.trim();
 // ---------- entry point ----------
@@ -343,7 +437,7 @@ export function renderHtmlReport(model, { title, includeScripts = true } = {}) {
     let body;
     if (model.childTests && model.childTests.length > 0) {
         const children = model.childTests
-            .map((child) => `<div class="dc-child-block"><div class="dc-child-head">${escapeHtml(child.testName.replace(/\.dcua$/i, ""))}</div>${renderTimeline(child.events, shots)}</div>`)
+            .map((child) => `<div class="dc-child-block"><div class="dc-child-head">${escapeHtml(child.testName.replace(/\.dcua$/i, ""))}</div>${renderTimeline(child.events, shots, child.warnings)}</div>`)
             .join("\n");
         body = `${renderSummaryCard(model)}
 ${renderTestsList(model.childTests)}
@@ -354,7 +448,7 @@ ${children}
     else {
         body = `${renderSummaryCard(model)}
 <div class="dc-timeline">
-${renderTimeline(model.events, shots)}
+${renderTimeline(model.events, shots, model.warnings)}
 </div>`;
     }
     const lightboxes = renderLightboxes(shots);

package/build/src/core/report/run-report-sections.js

@@ -0,0 +1,136 @@
+const CLOUD_PROVIDERS = [
+    ["browserstack", "BrowserStack", "BrowserStack"],
+    ["lambdatest", "LambdaTest", "LambdaTest"],
+    ["aws-device-farm", "(?:AWS )?Device Farm", "AWS"],
+    ["loadmill-cloud", "Loadmill Cloud", "Loadmill Cloud"],
+];
+export function cloudProviderId(line) {
+    const payloadProviderId = line.payload?.providerId;
+    const fromPayload = CLOUD_PROVIDERS.find(([id]) => id === payloadProviderId);
+    if (fromPayload)
+        return fromPayload[0];
+    for (const [id, name] of CLOUD_PROVIDERS) {
+        if (new RegExp(`^(?:Preparing|Provisioning|Creating|Connecting to|Connected to|Ending|Checking cached|Reused cached|Cached|Reusing uploaded app .* for|Uploading .* to|Local app changed since the last) ${name}\\b`, "i").test(line.text) ||
+            new RegExp(`^${name} session (?:started|ended)`, "i").test(line.text)) {
+            return id;
+        }
+    }
+    return null;
+}
+export function cloudProviderLabel(providerId) {
+    return CLOUD_PROVIDERS.find(([id]) => id === providerId)?.[2] ?? "Cloud session";
+}
+export function capitalizeReportLine(text) {
+    return text.replace(/^(\s*)([a-z])/, (_, whitespace, letter) => whitespace + letter.toUpperCase());
+}
+export function isCloudSessionLine(line) {
+    if (cloudProviderId(line))
+        return true;
+    return /^Upload complete for /i.test(line.text);
+}
+export function isCloudSessionContinuationLine(line) {
+    return !cloudProviderId(line) && /^Platform:\s/i.test(line.text);
+}
+export function cloudStatus(lines) {
+    if (lines.some((line) => line.kind === "error" || line.kind === "warning"))
+        return "issue";
+    if (lines.some((line) => line.payload?.event === "cloud.session.ended" || line.payload?.event === "cloud.session.ending"))
+        return "ended";
+    if (lines.some((line) => line.payload?.event === "cloud.session.connected"))
+        return "ready";
+    return "starting";
+}
+function isAppContextLine(line) {
+    return line.payload?.event === "app_context.loaded";
+}
+function isLoadmillLine(line) {
+    return line.text.startsWith("[Loadmill]");
+}
+function isLoadmillContinuationLine(line) {
+    return line.text.startsWith("  ") ||
+        line.text.startsWith("Command:") ||
+        line.text.startsWith("Error:") ||
+        line.text.startsWith("Skipping failed Loadmill");
+}
+function loadmillSuiteRunId(line) {
+    const payloadRunId = line.payload?.loadmillSuiteRunId;
+    if (typeof payloadRunId === "string" && payloadRunId.trim())
+        return payloadRunId.trim();
+    return line.text.match(/Test started \(ID:\s*([^)]+)\)/i)?.[1]?.trim() ||
+        line.text.match(/Run ID:\s*(.+)$/i)?.[1]?.trim() || null;
+}
+function loadmillCommand(line) {
+    const payloadCommand = line.payload?.loadmillCommand;
+    if (typeof payloadCommand === "string" && payloadCommand.trim())
+        return payloadCommand.trim();
+    return line.text.match(/^\[Loadmill\]\s*Executing:\s*(.+)$/i)?.[1]?.trim() || null;
+}
+function shouldAppendToPreviousLoadmillBlock(line, previousLines) {
+    if (previousLines.some((previous) => /\[Loadmill\]\s*FAILED|^Error:|\bpassed\b/i.test(previous.text)))
+        return false;
+    const runId = loadmillSuiteRunId(line);
+    if (runId)
+        return previousLines.some((previous) => loadmillSuiteRunId(previous) === runId);
+    const command = loadmillCommand(line);
+    return Boolean(command && previousLines.some((previous) => loadmillCommand(previous) === command));
+}
+function findPreviousSection(sections, kind) {
+    for (let index = sections.length - 1; index >= 0; index -= 1) {
+        if (sections[index].kind === kind)
+            return sections[index];
+    }
+    return null;
+}
+function findStartingCloudSection(sections, providerId) {
+    if (!providerId)
+        return null;
+    const previous = findPreviousSection(sections, "cloud");
+    if (!previous || cloudStatus(previous.lines) !== "starting")
+        return null;
+    return previous.lines.some((line) => cloudProviderId(line) === providerId) ? previous : null;
+}
+export function buildRunReportSections(logs) {
+    const sections = [];
+    let index = 0;
+    while (index < logs.length) {
+        const current = logs[index];
+        if (isAppContextLine(current)) {
+            sections.push({ kind: "app-context", line: current });
+            index += 1;
+            continue;
+        }
+        if (isCloudSessionLine(current)) {
+            const lines = [current];
+            index += 1;
+            while (index < logs.length && (isCloudSessionLine(logs[index]) || isCloudSessionContinuationLine(logs[index]))) {
+                lines.push(logs[index++]);
+            }
+            const startingSection = findStartingCloudSection(sections, lines.map(cloudProviderId).find(Boolean) ?? null);
+            if (startingSection && cloudStatus(lines) === "ended") {
+                startingSection.lines.push(...lines);
+            }
+            else {
+                sections.push({ kind: "cloud", lines });
+            }
+            continue;
+        }
+        if (!isLoadmillLine(current)) {
+            sections.push({ kind: "log", line: current, visibleIndex: index });
+            index += 1;
+            continue;
+        }
+        const previousLoadmill = findPreviousSection(sections, "loadmill");
+        if (previousLoadmill && shouldAppendToPreviousLoadmillBlock(current, previousLoadmill.lines)) {
+            previousLoadmill.lines.push(current);
+            index += 1;
+            continue;
+        }
+        const lines = [current];
+        index += 1;
+        while (index < logs.length && (isLoadmillLine(logs[index]) || isLoadmillContinuationLine(logs[index]))) {
+            lines.push(logs[index++]);
+        }
+        sections.push({ kind: "loadmill", lines });
+    }
+    return sections;
+}

package/build/src/core/runtime-config.js

@@ -123,7 +123,7 @@ export function resolveRuntimeCredentials({ openAiApiKey = null, loadmillApiToke
         loadmillBaseUrl: normalizeLoadmillSiteBaseUrl(loadmillBaseUrl),
     };
 }
-export function resolveRuntimeConfig({ llmProviderMode = null, cuaModel = null, explainMode = false, stepDelayMs = undefined, contextOptimizationEnabled = undefined, contextOptimizationThreshold = undefined, promptCustomizations = null, appContext = null, } = {}) {
+export function resolveRuntimeConfig({ llmProviderMode = null, cuaModel = null, explainMode = true, stepDelayMs = undefined, contextOptimizationEnabled = undefined, contextOptimizationThreshold = undefined, promptCustomizations = null, appContext = null, } = {}) {
     const normalizedCuaModel = typeof cuaModel === "string" && LOADMILL_MODEL_ALIAS_SET.has(cuaModel)
         ? cuaModel
         : resolveCuaModel(cuaModel);
@@ -133,7 +133,7 @@ export function resolveRuntimeConfig({ llmProviderMode = null, cuaModel = null,
             ? "loadmill"
             : normalizedProviderMode,
         cuaModel: normalizedCuaModel,
-        explainMode: explainMode === true,
+        explainMode: explainMode !== false,
         stepDelayMs: normalizeStepDelayMs(Number(stepDelayMs)),
         contextOptimizationEnabled: normalizeContextOptimizationEnabled(contextOptimizationEnabled),
         contextOptimizationThreshold: normalizeContextOptimizationThreshold(contextOptimizationThreshold),