pi-agent-browser-native 0.9.2 → 0.9.4

package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js

@@ -0,0 +1,216 @@
+import { isRecord } from "../../parsing.js";
+import { formatRawSnapshotText, formatSnapshotSummary } from "../snapshot-content.js";
+import { getScreenshotSummary } from "./artifacts.js";
+import { formatProfilesText, getStreamSummary, getTabSummary } from "./diagnostics.js";
+import { formatSkillsText } from "./skills.js";
+import { getNavigationSummary } from "./navigation.js";
+import { redactModelFacingText } from "./common.js";
+const SIMPLE_ACTION_RESULTS = {
+    check: { field: "checked", label: "Checked" },
+    click: { field: "clicked", label: "Clicked" },
+    fill: { field: "filled", label: "Filled" },
+    focus: { field: "focused", label: "Focused" },
+    hover: { field: "hovered", label: "Hovered" },
+    press: { field: "pressed", label: "Pressed" },
+    select: { field: "selected", label: "Selected" },
+    type: { field: "typed", label: "Typed" },
+    uncheck: { field: "unchecked", label: "Unchecked" },
+};
+function formatSimpleActionResult(command, data) {
+    if (!isRecord(data) || (command === "click" && getNavigationSummary(data) !== undefined)) {
+        return undefined;
+    }
+    const definition = SIMPLE_ACTION_RESULTS[command];
+    if (!definition) {
+        return undefined;
+    }
+    const value = data[definition.field];
+    return typeof value === "string" || typeof value === "number" || typeof value === "boolean"
+        ? `${definition.label}: ${redactModelFacingText(String(value))}`
+        : undefined;
+}
+function formatWaitResult(data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    if (data.waited === "timeout") {
+        return "Fixed wait elapsed; no page condition was verified.";
+    }
+    for (const field of ["selector", "text", "url", "state", "waited"]) {
+        const value = data[field];
+        if (typeof value === "string" && value.length > 0) {
+            return `Wait completed: ${redactModelFacingText(value)}`;
+        }
+    }
+    return undefined;
+}
+function formatCloseResult(data) {
+    return isRecord(data) && data.closed === true ? "Browser session closed." : undefined;
+}
+function coerceVitalsMetricValue(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (isRecord(value)) {
+        for (const key of ["value", "duration", "startTime", "score"]) {
+            const nested = value[key];
+            if (typeof nested === "number" && Number.isFinite(nested)) {
+                return nested;
+            }
+        }
+    }
+    return undefined;
+}
+function getVitalsMetric(data, key) {
+    const metrics = isRecord(data.metrics) ? data.metrics : undefined;
+    return coerceVitalsMetricValue(data[key] ?? data[key.toUpperCase()] ?? metrics?.[key] ?? metrics?.[key.toUpperCase()]);
+}
+function getVitalsMetrics(data) {
+    return ["lcp", "fcp", "ttfb", "inp", "cls"].flatMap((key) => {
+        const value = getVitalsMetric(data, key);
+        if (value === undefined) {
+            return [];
+        }
+        return [
+            key === "cls"
+                ? `${key.toUpperCase()}: ${value}`
+                : `${key.toUpperCase()}: ${Math.round(value)}ms`,
+        ];
+    });
+}
+function getVitalsUnavailableReason(data) {
+    for (const key of ["reason", "message", "error", "status"]) {
+        const value = data[key];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return redactModelFacingText(value.trim());
+        }
+    }
+    return "No Core Web Vitals metric fields were present in the upstream result.";
+}
+function formatVitalsText(data) {
+    const url = typeof data.url === "string" && data.url.trim().length > 0
+        ? redactModelFacingText(data.url.trim())
+        : undefined;
+    const metrics = getVitalsMetrics(data);
+    return [
+        url !== undefined && url.length > 0 ? `Vitals for ${url}` : "Vitals result",
+        ...(metrics.length > 0
+            ? metrics.map((metric) => `- ${metric}`)
+            : [`Metrics unavailable: ${getVitalsUnavailableReason(data)}`]),
+    ].join("\n");
+}
+function formatVitalsSummary(data) {
+    const metrics = getVitalsMetrics(data);
+    return metrics.length > 0 ? `Vitals: ${metrics.join(", ")}` : "Vitals: metrics unavailable";
+}
+function formatReadSummary(data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    const url = data.finalUrl ?? data.url;
+    return typeof url === "string" ? `Read: ${url}` : undefined;
+}
+function formatScreenshotSummary(data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    if (data.changed === false) {
+        return getScreenshotSummary(data);
+    }
+    return typeof data.path === "string" ? `Screenshot saved: ${data.path}` : undefined;
+}
+function formatTabSummary(data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    if (Array.isArray(data.tabs)) {
+        return `Tabs: ${data.tabs.length}`;
+    }
+    return data.closed === true ? "Tab closed" : undefined;
+}
+function formatTabText(data) {
+    if (!isRecord(data)) {
+        return undefined;
+    }
+    if (data.closed === true) {
+        return `Tab closed${typeof data.tabId === "string" ? `: ${redactModelFacingText(data.tabId)}` : "."}`;
+    }
+    return getTabSummary(data);
+}
+export const COMMAND_PRESENTERS = {
+    ...Object.fromEntries(Object.keys(SIMPLE_ACTION_RESULTS).map((command) => [
+        command,
+        {
+            summary: (_commandInfo, data) => formatSimpleActionResult(command, data),
+            text: (_commandInfo, data) => formatSimpleActionResult(command, data),
+        },
+    ])),
+    close: {
+        summary: (_commandInfo, data) => formatCloseResult(data),
+        text: (_commandInfo, data) => formatCloseResult(data),
+    },
+    exit: {
+        summary: (_commandInfo, data) => formatCloseResult(data),
+        text: (_commandInfo, data) => formatCloseResult(data),
+    },
+    quit: {
+        summary: (_commandInfo, data) => formatCloseResult(data),
+        text: (_commandInfo, data) => formatCloseResult(data),
+    },
+    wait: {
+        summary: (_commandInfo, data) => formatWaitResult(data),
+        text: (_commandInfo, data) => formatWaitResult(data),
+    },
+    profiles: {
+        summary: (_commandInfo, data) => Array.isArray(data) ? `Chrome profiles: ${data.length}` : undefined,
+        text: (_commandInfo, data) => Array.isArray(data) ? formatProfilesText(data, "Chrome profiles") : undefined,
+    },
+    read: {
+        summary: (_commandInfo, data) => formatReadSummary(data),
+        text: (_commandInfo, data) => isRecord(data) && typeof data.content === "string"
+            ? redactModelFacingText(data.content)
+            : undefined,
+    },
+    screenshot: {
+        summary: (_commandInfo, data) => formatScreenshotSummary(data),
+        text: (_commandInfo, data) => (isRecord(data) ? getScreenshotSummary(data) : undefined),
+    },
+    skills: {
+        summary: (commandInfo, data) => {
+            if (Array.isArray(data) && commandInfo.subcommand === "list") {
+                return `agent-browser skills: ${data.length}`;
+            }
+            if (commandInfo.subcommand === "get") {
+                return "agent-browser skill loaded";
+            }
+            return commandInfo.subcommand === "path" ? "agent-browser skill path" : undefined;
+        },
+        text: formatSkillsText,
+    },
+    snapshot: {
+        summary: (_commandInfo, data) => (isRecord(data) ? formatSnapshotSummary(data) : undefined),
+        text: (_commandInfo, data) => (isRecord(data) ? formatRawSnapshotText(data) : undefined),
+    },
+    stream: {
+        summary: (commandInfo, data) => {
+            if (!isRecord(data) || commandInfo.subcommand !== "status") {
+                return;
+            }
+            const port = typeof data.port === "number" ? ` on port ${data.port}` : "";
+            return `Stream ${data.enabled === true ? "enabled" : "disabled"}${port}`;
+        },
+        text: (commandInfo, data) => isRecord(data) && commandInfo.subcommand === "status" ? getStreamSummary(data) : undefined,
+    },
+    tab: {
+        summary: (_commandInfo, data) => formatTabSummary(data),
+        text: (_commandInfo, data) => formatTabText(data),
+    },
+    vitals: {
+        summary: (_commandInfo, data) => (isRecord(data) ? formatVitalsSummary(data) : undefined),
+        text: (_commandInfo, data) => (isRecord(data) ? formatVitalsText(data) : undefined),
+    },
+    "web-vitals": {
+        summary: (_commandInfo, data) => (isRecord(data) ? formatVitalsSummary(data) : undefined),
+        text: (_commandInfo, data) => (isRecord(data) ? formatVitalsText(data) : undefined),
+    },
+};

package/dist/extensions/agent-browser/lib/results/presentation/common.js

@@ -1,5 +1,5 @@
 import { isRecord } from "../../parsing.js";
-import { redactSensitiveText, redactSensitiveValue } from "../../runtime.js";
+import { redactSensitiveText, redactSensitiveValue } from "../../runtime-redaction.js";
 import { stringifyUnknown, truncateText } from "../text.js";
 const UNTITLED_PAGE_SUMMARY = "(untitled page)";
 export const LIGHTPANDA_IMAGE_REASON = "Lightpanda screenshot is a text-rendered page representation, not a graphical capture; CSS/mouse coordinate mapping is unknown.";
@@ -18,41 +18,58 @@ export function getStringField(data, key) {
 }
 // `lifecycle` is upstream launch/reuse bookkeeping, never page content, so it must not be the
 // answer an agent reads when a command has no dedicated presenter.
+function getNestedLifecycleRow(row) {
+    return isRecord(row) ? (row.result ?? row.data ?? row) : row;
+}
 export function extractAgentBrowserLifecycle(result) {
     if (Array.isArray(result)) {
         let latest;
         for (const row of result) {
-            const nested = isRecord(row) ? row.result ?? row.data ?? row : row;
+            const nested = getNestedLifecycleRow(row);
             latest = extractAgentBrowserLifecycle(nested) ?? latest;
         }
         return latest;
     }
-    if (!isRecord(result))
+    if (!isRecord(result)) {
         return undefined;
+    }
     if (isRecord(result.lifecycle) && isRecord(result.lifecycle.effectiveLaunch)) {
         const browserLaunched = result.lifecycle.effectiveLaunch.browserLaunched;
-        if (typeof browserLaunched === "boolean")
+        if (typeof browserLaunched === "boolean") {
             return { effectiveLaunch: { browserLaunched } };
+        }
     }
     return extractAgentBrowserLifecycle(result.result ?? result.data);
 }
 export function omitUpstreamLifecycle(data) {
-    if (Array.isArray(data))
+    if (Array.isArray(data)) {
         return data;
+    }
     const { lifecycle: _lifecycle, ...rest } = data;
     return rest;
 }
 export function formatWebMcpCatalogUpdate(catalog) {
     return `WebMCP catalog update (page-provided, untrusted; use webmcp list for schemas):\n${JSON.stringify(redactSensitiveValue(catalog))}`;
 }
-export function getPageSummary(data) {
+function getPageIdentitySummary(data) {
     const title = typeof data.title === "string" ? data.title : undefined;
     const url = typeof data.url === "string" ? data.url : undefined;
-    if (title === undefined && url === undefined)
+    if (title === undefined && url === undefined) {
         return undefined;
-    const summary = title && url ? `${title}\n${url}` : url || title || UNTITLED_PAGE_SUMMARY;
+    }
+    const parts = [title, url].filter((part) => part !== undefined && part.length > 0);
+    return parts.length > 0 ? parts.join("\n") : UNTITLED_PAGE_SUMMARY;
+}
+export function getPageSummary(data) {
+    const summary = getPageIdentitySummary(data);
+    if (summary === undefined) {
+        return undefined;
+    }
     const webmcp = isRecord(data.webmcp) ? data.webmcp : undefined;
-    return webmcp?.available === true && typeof webmcp.toolCount === "number" && Number.isInteger(webmcp.toolCount) && webmcp.toolCount > 0
+    return webmcp?.available === true &&
+        typeof webmcp.toolCount === "number" &&
+        Number.isInteger(webmcp.toolCount) &&
+        webmcp.toolCount > 0
         ? `${summary}\n\nWebMCP tools are available on this page (experimental). Run webmcp list to view them.`
         : summary;
 }

package/dist/extensions/agent-browser/lib/results/presentation/content.js

@@ -1,8 +1,56 @@
 import { isRecord } from "../../parsing.js";
-import { redactSensitiveValue } from "../../runtime.js";
+import { redactSensitiveValue } from "../../runtime-redaction.js";
 import { omitUpstreamLifecycle } from "./common.js";
-import { redactTimeoutPartialProgress } from "../../orchestration/browser-run/diagnostics.js";
+import { isTimeoutPartialProgress, redactTimeoutPartialProgress, } from "../../orchestration/browser-run/timeout-progress.js";
 export const OBSERVATION_INLINE_MAX_CHARS = 16_000;
+const OBSERVATION_DETAIL_FIELDS = [
+    "data",
+    "error",
+    "summary",
+    "failureCategory",
+    "successCategory",
+    "nextActions",
+    "warnings",
+    "sessionName",
+    "namespace",
+    "codeRun",
+    "failures",
+    "artifacts",
+    "artifactVerification",
+    "imageObservations",
+    "fullOutputPath",
+    "fullOutputPaths",
+    "fullOutputUnavailable",
+    "recordingRecovery",
+    "readConfirmation",
+    "sessionRecoveryHint",
+    "pageChangeSummary",
+    "timeoutPartialProgress",
+    "qaPreset",
+    "sourceLookup",
+    "networkSourceLookup",
+    "networkRouteDiagnostics",
+    "webMcpCatalog",
+    "clickDispatch",
+    "overlayBlockers",
+    "fillVerification",
+    "visibleRefFallback",
+    "richInputRecovery",
+    "snapshotDiff",
+    "snapshotFilter",
+    "snapshotViewport",
+    "scrollPage",
+    "scrollContainer",
+    "comboboxFocus",
+    "scrollNoop",
+    "selectorTextVisibility",
+    "selectorTextVisibilityAll",
+    "evalStdinHint",
+    "evalResultWarning",
+    "electronGetTextScopeWarning",
+    "electronGetTextScopeWarnings",
+    "recordingDependencyWarning",
+];
 export function isStringArray(value) {
     return Array.isArray(value) && value.every((item) => typeof item === "string");
 }
@@ -17,46 +65,55 @@ export function getPresentationImages(presentation) {
     return presentation.content.filter((part) => part.type === "image");
 }
 export function getPresentationPaths(options) {
-    return options.secondaryPaths ?? (options.primaryPath ? [options.primaryPath] : []);
+    return (options.secondaryPaths ??
+        (options.primaryPath !== undefined && options.primaryPath.length > 0
+            ? [options.primaryPath]
+            : []));
 }
 export function formatBatchStepCommand(command, index) {
     return command && command.length > 0 ? command.join(" ") : `step-${index + 1}`;
 }
-// Shared by direct results and code observations; ownership/replay state stays in details.
-export function projectAgentBrowserObservation(details, succeeded) {
-    const observation = { success: succeeded, resultCategory: succeeded ? "success" : "failure" };
-    for (const key of [
-        "data", "error", "summary", "failureCategory", "successCategory", "nextActions", "warnings",
-        "sessionName", "namespace", "codeRun", "failures",
-        "artifacts", "artifactVerification", "imageObservations", "fullOutputPath", "fullOutputPaths", "fullOutputUnavailable",
-        "recordingRecovery", "readConfirmation", "sessionRecoveryHint", "pageChangeSummary", "timeoutPartialProgress",
-        "qaPreset", "sourceLookup", "networkSourceLookup", "networkRouteDiagnostics", "webMcpCatalog",
-        "clickDispatch", "overlayBlockers", "fillVerification", "visibleRefFallback", "richInputRecovery",
-        "snapshotDiff", "snapshotFilter", "snapshotViewport", "scrollPage", "scrollContainer",
-        "comboboxFocus", "scrollNoop", "selectorTextVisibility", "selectorTextVisibilityAll", "evalStdinHint", "evalResultWarning",
-        "electronGetTextScopeWarning", "electronGetTextScopeWarnings", "recordingDependencyWarning",
-    ]) {
-        if (details[key] !== undefined)
+function selectObservationFields(details) {
+    const observation = {};
+    for (const key of OBSERVATION_DETAIL_FIELDS) {
+        if (details[key] !== undefined) {
             observation[key] = details[key];
+        }
     }
-    if (details.inspection === true && details.data === undefined && typeof details.stdout === "string")
+    if (details.inspection === true &&
+        details.data === undefined &&
+        typeof details.stdout === "string") {
         observation.data = details.stdout;
+    }
     // Identical error/summary strings double-count large failure text against the observation bound; keep error.
-    if (typeof observation.error === "string" && observation.error === observation.summary)
+    if (typeof observation.error === "string" && observation.error === observation.summary) {
         observation.summary = undefined;
-    if (isRecord(observation.data))
+    }
+    if (isRecord(observation.data)) {
         observation.data = omitUpstreamLifecycle(observation.data);
-    if (Array.isArray(details.batchSteps)) {
-        observation.batchSteps = details.batchSteps.filter(isRecord).map(step => {
-            const { data: _data, ...metadata } = projectAgentBrowserObservation(step, step.success !== false);
-            return { index: step.index, ...metadata };
-        });
     }
-    if (observation.timeoutPartialProgress)
+    if (isTimeoutPartialProgress(observation.timeoutPartialProgress)) {
         observation.timeoutPartialProgress = redactTimeoutPartialProgress(observation.timeoutPartialProgress);
+    }
+    return observation;
+}
+function projectBatchMetadata(step) {
+    const { data: _data, ...metadata } = projectAgentBrowserObservation(step, step.success !== false);
+    return Object.assign({ index: step.index }, metadata);
+}
+// Shared by direct results and code observations; ownership/replay state stays in details.
+export function projectAgentBrowserObservation(details, succeeded) {
+    const observation = selectObservationFields(details);
+    if (Array.isArray(details.batchSteps)) {
+        observation.batchSteps = details.batchSteps.filter(isRecord).map(projectBatchMetadata);
+    }
     const redacted = redactSensitiveValue(observation);
+    if (!isRecord(redacted)) {
+        throw new Error("Browser observation redaction must preserve its record shape.");
+    }
     // Native stream endpoints are usable browser resource identifiers, not credentials.
-    if (isRecord(redacted.data) && isRecord(details.data) && typeof details.data.wsUrl === "string")
+    if (isRecord(redacted.data) && isRecord(details.data) && typeof details.data.wsUrl === "string") {
         redacted.data.wsUrl = details.data.wsUrl;
-    return redacted;
+    }
+    return { success: succeeded, resultCategory: succeeded ? "success" : "failure", ...redacted };
 }

package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js

@@ -0,0 +1,67 @@
+import { isRecord } from "../../parsing.js";
+import { firstLine, getArrayField, getStringField, redactModelFacingText, stringifyModelFacing, } from "./common.js";
+function violationLine(item, index) {
+    if (!isRecord(item)) {
+        return `${index + 1}. ${stringifyModelFacing(item)}`;
+    }
+    const id = redactModelFacingText(getStringField(item, "id") ?? "rule");
+    const impact = redactModelFacingText(getStringField(item, "impact") ?? "unknown");
+    const help = firstLine(redactModelFacingText(getStringField(item, "help") ?? "")
+        .replace(/\s+/g, " ")
+        .trim(), 160);
+    const nodeCount = typeof item.nodeCount === "number" ? item.nodeCount : getArrayField(item, "nodes")?.length;
+    const nodePart = typeof nodeCount === "number" ? `, ${nodeCount} node${nodeCount === 1 ? "" : "s"}` : "";
+    return `${index + 1}. [${impact}] ${id}${nodePart}${help.length > 0 ? ` — ${help}` : ""}`;
+}
+function countSummary(counts, violationCount, incompleteCount) {
+    const parts = [
+        `${violationCount} violation${violationCount === 1 ? "" : "s"}`,
+        `${incompleteCount} incomplete`,
+    ];
+    if (typeof counts?.passes === "number") {
+        parts.push(`${counts.passes} passes`);
+    }
+    if (typeof counts?.inapplicable === "number") {
+        parts.push(`${counts.inapplicable} inapplicable`);
+    }
+    return `A11y audit: ${parts.join(", ")}.`;
+}
+function auditHeader(data) {
+    const lines = [];
+    const axeVersion = getStringField(data, "axeVersion");
+    if (axeVersion !== undefined) {
+        lines.push(`axe-core ${redactModelFacingText(axeVersion)}`);
+    }
+    const url = getStringField(data, "url");
+    if (url !== undefined) {
+        lines.push(`URL: ${redactModelFacingText(url)}`);
+    }
+    return lines;
+}
+function auditCounts(counts, violations, incomplete) {
+    return {
+        violations: typeof counts?.violations === "number" ? counts.violations : violations.length,
+        incomplete: typeof counts?.incomplete === "number" ? counts.incomplete : incomplete.length,
+    };
+}
+export function formatA11yText(data) {
+    const counts = isRecord(data.counts) ? data.counts : undefined;
+    const violations = getArrayField(data, "violations") ?? [];
+    const incomplete = getArrayField(data, "incomplete") ?? [];
+    if (!counts && violations.length === 0 && incomplete.length === 0) {
+        return undefined;
+    }
+    const lines = auditHeader(data);
+    const observedCounts = auditCounts(counts, violations, incomplete);
+    const incompleteCount = observedCounts.incomplete;
+    lines.push(countSummary(counts, observedCounts.violations, incompleteCount));
+    const preview = violations.slice(0, 10).map(violationLine);
+    lines.push(...preview);
+    if (violations.length > preview.length) {
+        lines.push(`... (${violations.length - preview.length} additional violations omitted from preview)`);
+    }
+    if (incompleteCount > 0) {
+        lines.push(`${incompleteCount} incomplete check${incompleteCount === 1 ? "" : "s"} need manual review (see details.data.incomplete).`);
+    }
+    return lines.join("\n");
+}

package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js

@@ -0,0 +1,79 @@
+import { isRecord } from "../../parsing.js";
+import { firstLine, getArrayField, getStringField, redactModelFacingText, stringifyModelFacing, } from "./common.js";
+export function formatDashboardText(data) {
+    const lines = [];
+    if (typeof data.port === "number") {
+        lines.push(`Port: ${data.port}`);
+    }
+    if (typeof data.pid === "number") {
+        lines.push(`PID: ${data.pid}`);
+    }
+    if (typeof data.stopped === "boolean") {
+        lines.push(`Stopped: ${data.stopped}`);
+    }
+    const reason = getStringField(data, "reason");
+    if (reason !== undefined) {
+        lines.push(`Reason: ${redactModelFacingText(reason)}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : undefined;
+}
+function doctorCheckLines(item, index) {
+    if (!isRecord(item)) {
+        return [`${index + 1}. ${stringifyModelFacing(item)}`];
+    }
+    const status = getStringField(item, "status") ?? "info";
+    const label = [getStringField(item, "category"), getStringField(item, "id")]
+        .filter(Boolean)
+        .join("/");
+    const message = getStringField(item, "message") ??
+        getStringField(item, "name") ??
+        getStringField(item, "title") ??
+        getStringField(item, "check") ??
+        stringifyModelFacing(item);
+    const lines = [
+        `${index + 1}. [${redactModelFacingText(status)}]${label.length > 0 ? ` ${redactModelFacingText(label)}:` : ""} ${firstLine(redactModelFacingText(message), 220)}`,
+    ];
+    const fix = getStringField(item, "fix");
+    if (fix !== undefined) {
+        lines.push(`   fix: ${redactModelFacingText(fix)}`);
+    }
+    return lines;
+}
+function doctorSummary(data) {
+    const lines = [];
+    const status = getStringField(data, "status") ?? getStringField(data, "result");
+    if (status !== undefined) {
+        lines.push(`Status: ${redactModelFacingText(status)}`);
+    }
+    if (isRecord(data.summary)) {
+        const summary = data.summary;
+        const parts = ["pass", "warn", "fail"].flatMap((key) => typeof summary[key] === "number" ? [`${key}:${summary[key]}`] : []);
+        if (parts.length > 0) {
+            lines.push(`Summary: ${parts.join(", ")}`);
+        }
+    }
+    return lines;
+}
+export function formatDoctorText(data) {
+    const lines = doctorSummary(data);
+    const checks = getArrayField(data, "checks");
+    if (checks) {
+        lines.push(`Checks: ${checks.length}`, ...checks.slice(0, 30).flatMap(doctorCheckLines));
+        if (checks.length > 30) {
+            lines.push(`... (${checks.length - 30} additional checks omitted from preview)`);
+        }
+    }
+    for (const key of ["issues", "problems"]) {
+        const items = getArrayField(data, key);
+        if (items) {
+            lines.push(`${key}: ${items.length}`);
+        }
+    }
+    if (lines.length > 0) {
+        return lines.join("\n");
+    }
+    const keys = Object.keys(data).filter((key) => key !== "success");
+    return keys.length > 0
+        ? `Doctor diagnostics returned unrecognized fields: ${keys.map(redactModelFacingText).join(", ")}. See details.data for structured diagnostics.`
+        : undefined;
+}