pi-agent-browser-native 0.9.4 → 0.9.6

package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js

@@ -1,117 +0,0 @@
-import { isCloseCommand } from "../../command-taxonomy.js";
-import { getSessionPageStateKey } from "../../session-page-state.js";
-export { buildManagedSessionOutcome, formatManagedSessionOutcomeText, buildManagedSessionFreshFailureNextActions, } from "./session-state-outcomes.js";
-export { extractStringResultField, extractNavigationSummaryFromData, shouldCaptureNavigationSummary, mergeNavigationSummaryIntoData, buildAboutBlankRecoveryHint, buildAboutBlankWarning, extractBatchResultCommand, } from "./session-state-observations.js";
-export { getStaleRefArgs, getGuardedRefUsage, buildStaleRefPreflight, } from "./session-state-refs.js";
-export { withSessionCommandObservation, nativePolicyDefinitelyUnestablished, runSessionCommandData, } from "./session-state-commands.js";
-export { commandChoosesSessionTabTarget, shouldPinSessionTabForCommand, shouldCorrectSessionTabAfterCommand, collectOpenResultTabCorrection, collectSessionTabTarget, collectSessionTabSelection, ensureSessionTabTarget, applyOpenResultTabCorrection, } from "./session-state-tabs.js";
-export { isLiveElectronRendererTarget, getLiveElectronRendererTargets, electronTargetLabel, getActiveElectronRecords, findElectronLaunchRecordForSession, buildElectronMismatchNextActions, buildElectronSessionMismatch, formatElectronSessionMismatchText, shouldInspectElectronPostCommandHealth, buildElectronLifecycleNextActions, buildElectronPostCommandHealthDiagnostic, formatElectronPostCommandHealthText, buildElectronIdentifiers, buildElectronRefFreshnessNextActions, buildElectronRefFreshnessDiagnostic, formatElectronRefFreshnessText, } from "./session-state-electron.js";
-function managedLaunchUpdate(patch) {
-    return {
-        ...("managedSessionCompatibilityWorkaround" in patch
-            ? { managedSessionCompatibilityWorkaround: patch.managedSessionCompatibilityWorkaround }
-            : {}),
-        ...(patch.managedSessionHeadedAutosaveDisabled !== undefined
-            ? { managedSessionHeadedAutosaveDisabled: patch.managedSessionHeadedAutosaveDisabled }
-            : {}),
-        ...("managedSessionHeadedAutosaveInterval" in patch
-            ? { managedSessionHeadedAutosaveInterval: patch.managedSessionHeadedAutosaveInterval }
-            : {}),
-    };
-}
-function managedIdentityUpdate(patch) {
-    return {
-        ...(patch.managedSessionCwd !== undefined
-            ? { managedSessionCwd: patch.managedSessionCwd }
-            : {}),
-        ...(patch.managedSessionName !== undefined
-            ? { managedSessionName: patch.managedSessionName }
-            : {}),
-        ...("managedSessionNamespace" in patch
-            ? { managedSessionNamespace: patch.managedSessionNamespace }
-            : {}),
-        ...(patch.managedSessionActive !== undefined
-            ? { managedSessionActive: patch.managedSessionActive }
-            : {}),
-        ...(patch.freshSessionOrdinal !== undefined
-            ? { freshSessionOrdinal: patch.freshSessionOrdinal }
-            : {}),
-    };
-}
-export function applyBrowserRunStatePatch(state, patch) {
-    if (!patch) {
-        return;
-    }
-    if ("artifactManifest" in patch) {
-        state.artifactManifest = patch.artifactManifest;
-    }
-    if (patch.networkRoutesBySession) {
-        state.networkRoutesBySession = patch.networkRoutesBySession;
-    }
-    Object.assign(state, managedLaunchUpdate(patch), managedIdentityUpdate(patch));
-}
-export const getSessionContextKey = getSessionPageStateKey;
-export function buildSessionDetailFields(sessionName, usedImplicitSession, namespace, managedSessionRestoreDisabled = false) {
-    return {
-        ...(namespace !== undefined ? { namespace } : {}),
-        ...((sessionName?.length ?? 0) > 0
-            ? {
-                sessionName,
-                usedImplicitSession,
-                ...(managedSessionRestoreDisabled ? { managedSessionRestoreDisabled: true } : {}),
-            }
-            : {}),
-    };
-}
-function getTraceOwner(command) {
-    return command === "trace" || command === "profiler" ? command : undefined;
-}
-export function getTraceOwnerGuardMessage(options) {
-    const owner = getTraceOwner(options.command);
-    const sessionName = options.sessionName;
-    if (owner === undefined ||
-        sessionName === undefined ||
-        sessionName.length === 0 ||
-        (options.subcommand !== "start" && options.subcommand !== "stop")) {
-        return;
-    }
-    const activeOwner = options.traceOwners.get(sessionName);
-    if (activeOwner === undefined || activeOwner === owner) {
-        return;
-    }
-    return options.subcommand === "start"
-        ? `Wrapper believes ${activeOwner} tracing is active for session ${sessionName}; stop ${activeOwner} before starting ${owner}.`
-        : `Wrapper believes tracing for session ${sessionName} is owned by ${activeOwner}; run ${activeOwner} stop instead of ${owner} stop.`;
-}
-export function updateTraceOwnerState(options) {
-    const sessionName = options.sessionName;
-    if (sessionName === undefined || sessionName.length === 0 || !options.succeeded) {
-        return;
-    }
-    if (isCloseCommand(options.command)) {
-        options.traceOwners.delete(sessionName);
-        return;
-    }
-    const owner = getTraceOwner(options.command);
-    if (owner === undefined) {
-        return;
-    }
-    if (options.subcommand === "start") {
-        options.traceOwners.set(sessionName, owner);
-    }
-    if (options.subcommand === "stop" && options.traceOwners.get(sessionName) === owner) {
-        options.traceOwners.delete(sessionName);
-    }
-}
-export function getPersistentSessionArtifactStore(ctx) {
-    const sessionDir = typeof ctx.sessionManager.getSessionDir === "function"
-        ? ctx.sessionManager.getSessionDir()
-        : undefined;
-    const sessionId = ctx.sessionManager.getSessionId();
-    return sessionDir !== undefined &&
-        sessionDir.length > 0 &&
-        sessionId !== undefined &&
-        sessionId.length > 0
-        ? { sessionDir, sessionId }
-        : undefined;
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js

@@ -1,182 +0,0 @@
-import { isRecord } from "../../parsing.js";
-import { withOptionalSessionArgs } from "../../results/next-actions.js";
-import { redactSensitiveText } from "../../runtime-redaction.js";
-import { extractBatchResultCommand, extractStringResultField, runSessionCommandData, } from "./session-state.js";
-import { rawNumberField, rawStringField } from "./diagnostic-values.js";
-const SELECTOR_TEXT_VISIBILITY_CANDIDATE_LIMIT = 8;
-function buildVisibleTextProbeScript(selector) {
-    return `(() => {\n  const selector = ${JSON.stringify(selector)};\n  const isVisible = (element) => {\n    const style = window.getComputedStyle(element);\n    if (!style || style.display === 'none' || style.visibility === 'hidden' || style.visibility === 'collapse' || Number(style.opacity) === 0) return false;\n    return Array.from(element.getClientRects()).some((rect) => rect.width > 0 && rect.height > 0);\n  };\n  let matches = [];\n  try {\n    matches = Array.from(document.querySelectorAll(selector));\n  } catch (error) {\n    return JSON.stringify({ selector, error: error instanceof Error ? error.message : String(error) });\n  }\n  const visible = matches.filter(isVisible);\n  const trim = (value) => typeof value === 'string' ? value.trim().replace(/\\s+/g, ' ').slice(0, 200) : undefined;\n  const describeCandidate = (element) => {\n    const index = matches.indexOf(element);\n    const role = element.getAttribute('role');\n    const candidate = { index, tagName: element.tagName.toLowerCase(), textPreview: trim(element.textContent) };\n    if (role) candidate.role = role;\n    return candidate;\n  };\n  const visibleCandidates = visible.slice(0, ${SELECTOR_TEXT_VISIBILITY_CANDIDATE_LIMIT}).map(describeCandidate);\n  return JSON.stringify({ selector, matchCount: matches.length, visibleCount: visible.length, firstMatchVisible: matches[0] ? isVisible(matches[0]) : undefined, firstTextPreview: trim(matches[0]?.textContent), firstVisibleTextPreview: trim(visible[0]?.textContent), visibleCandidates });\n})()`;
-}
-function parseVisibleTextCandidate(entry) {
-    if (!isRecord(entry) || typeof entry.index !== "number" || typeof entry.tagName !== "string") {
-        return [];
-    }
-    const role = rawStringField(entry, "role");
-    const text = rawStringField(entry, "textPreview");
-    const textPreview = text !== undefined && text !== "" ? redactSensitiveText(text) : undefined;
-    return [
-        {
-            index: entry.index,
-            tagName: entry.tagName,
-            ...(role !== undefined && role !== "" ? { role } : {}),
-            ...(textPreview !== undefined && textPreview !== "" ? { textPreview } : {}),
-        },
-    ];
-}
-function parseSelectorTextVisibilityCandidates(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const candidates = value.flatMap(parseVisibleTextCandidate);
-    return candidates.length > 0 ? candidates : undefined;
-}
-function parseSelectorTextVisibilityProbe(data, selector) {
-    const result = extractStringResultField(data, "result");
-    if (result === undefined) {
-        return undefined;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(result);
-    }
-    catch {
-        return undefined;
-    }
-    if (!isRecord(parsed) || typeof parsed.error === "string") {
-        return undefined;
-    }
-    const matchCount = rawNumberField(parsed, "matchCount");
-    const visibleCount = rawNumberField(parsed, "visibleCount");
-    if (matchCount === undefined || visibleCount === undefined) {
-        return undefined;
-    }
-    const preview = rawStringField(parsed, "firstVisibleTextPreview");
-    return {
-        firstMatchVisible: typeof parsed.firstMatchVisible === "boolean" ? parsed.firstMatchVisible : undefined,
-        firstVisibleTextPreview: preview !== undefined && preview !== "" ? redactSensitiveText(preview) : undefined,
-        matchCount,
-        selector,
-        visibleCandidates: parseSelectorTextVisibilityCandidates(parsed.visibleCandidates),
-        visibleCount,
-    };
-}
-export function selectorMayExposeSensitiveLiteral(selector) {
-    return (redactSensitiveText(selector) !== selector ||
-        /\[[^\]]*[~|^$*]?=\s*(?:"[^"]*"|'[^']*'|[^\]\s]+)\s*(?:[is]\s*)?\]/.test(selector));
-}
-function canProbeVisibleText(selector) {
-    return (selector !== undefined &&
-        selector !== "" &&
-        !/^@e\d+$/.test(selector) &&
-        !/^#[A-Za-z_][\w-]*$/.test(selector) &&
-        !selectorMayExposeSensitiveLiteral(selector));
-}
-function selectorVisibilitySummary(parsed) {
-    const visibleMatchNoun = `visible match${parsed.visibleCount === 1 ? "" : "es"}`;
-    const visibleMatchVerb = parsed.visibleCount === 1 ? "exists" : "exist";
-    return parsed.firstMatchVisible === false
-        ? `Selector ${JSON.stringify(parsed.selector)} matched ${parsed.matchCount} elements; the first match is hidden while ${parsed.visibleCount} ${visibleMatchNoun} ${visibleMatchVerb}.`
-        : `Selector ${JSON.stringify(parsed.selector)} matched ${parsed.matchCount} elements; get text reads the first upstream match, which may not be the intended visible tab/panel.`;
-}
-async function collectSelectorTextVisibilityDiagnosticForSelector(options) {
-    const { selector } = options;
-    if (!canProbeVisibleText(selector)) {
-        return undefined;
-    }
-    const probe = await runSessionCommandData({
-        args: ["eval", "--stdin"],
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-        signal: options.signal,
-        stdin: buildVisibleTextProbeScript(selector),
-    });
-    const parsed = parseSelectorTextVisibilityProbe(probe, selector);
-    if (!parsed ||
-        (parsed.matchCount <= 1 && parsed.firstMatchVisible !== false) ||
-        parsed.visibleCount === 0) {
-        return undefined;
-    }
-    return { ...parsed, summary: selectorVisibilitySummary(parsed) };
-}
-function getBatchGetTextSelectors(data) {
-    if (!Array.isArray(data)) {
-        return [];
-    }
-    return data.flatMap((item) => {
-        if (!isRecord(item) || item.success === false) {
-            return [];
-        }
-        const tokens = extractBatchResultCommand(item);
-        const selector = tokens.at(2);
-        return tokens[0] === "get" && tokens[1] === "text" && selector !== undefined && selector !== ""
-            ? [selector]
-            : [];
-    });
-}
-export function getSuccessfulGetTextSelectors(options) {
-    if (options.commandInfo.command === "get" && options.commandInfo.subcommand === "text") {
-        return [options.commandTokens.at(2)].filter((selector) => typeof selector === "string" && selector.length > 0);
-    }
-    return options.commandInfo.command === "batch" ? getBatchGetTextSelectors(options.data) : [];
-}
-export async function collectSelectorTextVisibilityDiagnostics(options) {
-    const selectors = getSuccessfulGetTextSelectors(options);
-    const diagnostics = [];
-    for (const selector of selectors) {
-        // Native helper decisions and selector observations must remain in session order.
-        // oxlint-disable-next-line no-await-in-loop
-        const diagnostic = await collectSelectorTextVisibilityDiagnosticForSelector({
-            cwd: options.cwd,
-            namespace: options.namespace,
-            selector,
-            sessionName: options.sessionName,
-            signal: options.signal,
-        });
-        if (diagnostic) {
-            diagnostics.push(diagnostic);
-        }
-    }
-    return diagnostics.sort((left, right) => Number(right.firstMatchVisible === false) - Number(left.firstMatchVisible === false));
-}
-function formatVisibleCandidate(candidate) {
-    const role = candidate.role !== undefined && candidate.role !== "" ? ` role=${candidate.role}` : "";
-    const preview = candidate.textPreview !== undefined && candidate.textPreview !== ""
-        ? `: ${JSON.stringify(candidate.textPreview)}`
-        : "";
-    return `- [${candidate.index}] ${candidate.tagName}${role}${preview}`;
-}
-function formatSelectorVisibilityDiagnostic(diagnostic, index) {
-    const actionId = index === 0
-        ? "inspect-visible-text-candidates"
-        : `inspect-visible-text-candidates-${index + 1}`;
-    const lines = [`Selector text visibility warning: ${diagnostic.summary}`];
-    if (diagnostic.firstVisibleTextPreview !== undefined &&
-        diagnostic.firstVisibleTextPreview !== "") {
-        lines.push(`First visible text preview: ${JSON.stringify(diagnostic.firstVisibleTextPreview)}`);
-    }
-    if (diagnostic.visibleCandidates && diagnostic.visibleCandidates.length > 0) {
-        lines.push(`Visible candidates (${diagnostic.visibleCandidates.length} shown, querySelectorAll index):`, ...diagnostic.visibleCandidates.map(formatVisibleCandidate));
-    }
-    lines.push(`Next action: use details.nextActions ${actionId} before trusting this selector text.`);
-    return lines;
-}
-export function formatSelectorTextVisibilityText(diagnostics) {
-    return diagnostics.length === 0
-        ? undefined
-        : diagnostics.flatMap(formatSelectorVisibilityDiagnostic).join("\n");
-}
-export function buildSelectorTextVisibilityNextActions(options) {
-    return options.diagnostics.map((diagnostic, index) => ({
-        id: index === 0
-            ? "inspect-visible-text-candidates"
-            : `inspect-visible-text-candidates-${index + 1}`,
-        params: {
-            args: withOptionalSessionArgs(options.sessionName, ["eval", "--stdin"]),
-            stdin: buildVisibleTextProbeScript(diagnostic.selector),
-        },
-        reason: "Inspect selector match count and visible text before trusting get text on tabbed or hidden DOM content.",
-        safety: "Read-only DOM inspection; use a more specific visible selector or current @ref before acting on hidden-tab text.",
-        tool: "agent_browser",
-    }));
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js

@@ -1,256 +0,0 @@
-import { stat } from "node:fs/promises";
-import { isAbsolute, resolve } from "node:path";
-import { setTimeout as sleepMs } from "node:timers/promises";
-import { isOpenNavigationCommand } from "../../command-taxonomy.js";
-import { isBrowserIndependentRead } from "../../command-policy.js";
-import { redactInvocationArgs, redactSensitiveText } from "../../runtime-redaction.js";
-import { getUpstreamEffectiveBatchSteps } from "../batch-stdin.js";
-import { getExplicitArtifactDestination } from "./artifact-paths.js";
-import { extractStringResultField, runSessionCommandData } from "./session-state.js";
-import { redactSensitivePathSegmentsForDiagnostic, sanitizeCurrentPageUrlForTimeoutDiagnostic, } from "./timeout-progress.js";
-function getTimeoutProgressSteps(options) {
-    if (options.compiledJob) {
-        return options.compiledJob.steps.map((step, index) => ({
-            args: step.args,
-            generatedFrom: step.generatedFrom,
-            index: index + 1,
-            status: "unknown",
-            reason: "Upstream did not report this step's outcome before timeout.",
-        }));
-    }
-    return getUpstreamEffectiveBatchSteps(options.commandTokens, options.stdin).map((args, index) => ({
-        args,
-        index: index + 1,
-        status: "unknown",
-        reason: "Upstream did not report this step's outcome before timeout.",
-    }));
-}
-function getLastPositionalToken(args, startIndex = 1) {
-    for (let index = args.length - 1; index >= startIndex; index -= 1) {
-        const token = args[index];
-        if (token !== "" && !token.startsWith("-")) {
-            return token;
-        }
-    }
-    return undefined;
-}
-function getTimeoutStepArtifactPath(commandTokens) {
-    return ["screenshot", "pdf", "download", "wait"].includes(commandTokens[0])
-        ? getExplicitArtifactDestination(commandTokens)
-        : undefined;
-}
-async function statTimeoutArtifactPath(absolutePath) {
-    for (let attempt = 0; attempt < 3; attempt += 1) {
-        try {
-            // Retries observe a still-finishing native writer only after the prior stat settles.
-            // oxlint-disable-next-line no-await-in-loop
-            const stats = await stat(absolutePath);
-            return { exists: true, sizeBytes: stats.size };
-        }
-        catch {
-            if (attempt < 2) {
-                // Backoff must complete before the next artifact observation.
-                // oxlint-disable-next-line no-await-in-loop
-                await sleepMs(25);
-            }
-        }
-    }
-    return { exists: false };
-}
-async function collectTimeoutArtifactEvidence(cwd, steps) {
-    const evidence = [];
-    for (const step of steps) {
-        const path = getTimeoutStepArtifactPath(step.args);
-        if (path === undefined || path === "") {
-            continue;
-        }
-        const absolutePath = isAbsolute(path) ? path : resolve(cwd, path);
-        // Preserve each declared path's retry window before observing the next native step's output.
-        // oxlint-disable-next-line no-await-in-loop
-        const artifact = await statTimeoutArtifactPath(absolutePath);
-        evidence.push({
-            absolutePath,
-            exists: artifact.exists,
-            path,
-            ...(artifact.exists ? { sizeBytes: artifact.sizeBytes } : {}),
-            state: artifact.exists ? "verified" : "missing",
-            stepIndex: step.index,
-        });
-    }
-    return evidence;
-}
-function getPlannedCurrentPageUrl(steps) {
-    for (let index = steps.length - 1; index >= 0; index -= 1) {
-        const args = steps.at(index)?.args ?? [];
-        if (isOpenNavigationCommand(args[0]) || args[0] === "pushstate") {
-            return getLastPositionalToken(args);
-        }
-    }
-    return undefined;
-}
-const TIMEOUT_RETRYABLE_COMMANDS = new Set([
-    "console",
-    "diff",
-    "errors",
-    "get",
-    "goto",
-    "navigate",
-    "network",
-    "open",
-    "pdf",
-    "pushstate",
-    "screenshot",
-    "snapshot",
-    "tab",
-    "vitals",
-    "wait",
-]);
-function getTimeoutStepRetry(step) {
-    const command = step.args.at(0);
-    return command !== undefined && command !== "" && TIMEOUT_RETRYABLE_COMMANDS.has(command)
-        ? { args: ["batch"], stdin: JSON.stringify([step.args]) }
-        : undefined;
-}
-function timeoutRetryStep(steps) {
-    const singleStep = steps.length === 1 ? steps.at(0) : undefined;
-    const retry = singleStep ? getTimeoutStepRetry(singleStep) : undefined;
-    return singleStep && retry ? { ...singleStep, retry } : undefined;
-}
-function currentPageSource(recoveredUrl, plannedUrl, title) {
-    if ((recoveredUrl ?? "") !== "") {
-        return "live";
-    }
-    if ((plannedUrl ?? "") !== "") {
-        return "planned";
-    }
-    return (title ?? "") !== "" ? "live" : undefined;
-}
-async function probeTimeoutPage(options) {
-    const urlData = await runSessionCommandData({
-        args: ["get", "url"],
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-    });
-    const recoveredUrl = extractStringResultField(urlData, "result") ?? extractStringResultField(urlData, "url");
-    const titleData = (recoveredUrl ?? "") !== ""
-        ? await runSessionCommandData({
-            args: ["get", "title"],
-            cwd: options.cwd,
-            namespace: options.namespace,
-            sessionName: options.sessionName,
-        })
-        : undefined;
-    const title = extractStringResultField(titleData, "result") ?? extractStringResultField(titleData, "title");
-    return { recoveredUrl, title };
-}
-function timeoutPageSummary(recoveredUrl, title, plannedUrl) {
-    if ((recoveredUrl ?? "") !== "" || (title ?? "") !== "") {
-        return " and current page state";
-    }
-    return (plannedUrl ?? "") !== "" ? " and planned page URL" : "";
-}
-function buildTimeoutPage(observed, steps) {
-    const { recoveredUrl, title } = observed;
-    const plannedUrl = (recoveredUrl ?? "") !== "" ? undefined : getPlannedCurrentPageUrl(steps);
-    const url = recoveredUrl ?? plannedUrl;
-    const source = currentPageSource(recoveredUrl, plannedUrl, title);
-    return {
-        currentPage: (url ?? "") !== "" || (title ?? "") !== "" ? { source, title, url } : undefined,
-        liveUrlRecovered: recoveredUrl !== undefined,
-        summary: timeoutPageSummary(recoveredUrl, title, plannedUrl),
-    };
-}
-function formatTimeoutSummary(stepCount, artifacts, pageSummary) {
-    const foundArtifacts = artifacts.filter((artifact) => artifact.exists).length;
-    return `Timed out before upstream returned final results; ${stepCount} planned step outcome${stepCount === 1 ? " is" : "s are"} unknown. Found ${foundArtifacts}/${artifacts.length} declared artifact path${artifacts.length === 1 ? "" : "s"}${pageSummary}; these observations do not prove step execution.`;
-}
-export async function collectTimeoutPartialProgress(options) {
-    if ((options.commandTokens[0] === "session" && options.commandTokens[1] === "info") ||
-        isBrowserIndependentRead(options.commandTokens, options.stdin)) {
-        return undefined;
-    }
-    const rawSteps = getTimeoutProgressSteps(options);
-    const artifacts = await collectTimeoutArtifactEvidence(options.operationCwd ?? options.cwd, rawSteps);
-    const page = buildTimeoutPage(await probeTimeoutPage(options), rawSteps);
-    if (rawSteps.length === 0 && artifacts.length === 0 && !page.currentPage) {
-        return undefined;
-    }
-    // A matching URL or existing file is current state, not an execution receipt.
-    const steps = rawSteps;
-    return {
-        artifacts,
-        currentPage: page.currentPage,
-        liveUrlRecovered: page.liveUrlRecovered,
-        retryStep: timeoutRetryStep(steps),
-        steps: steps.length > 0 ? steps : undefined,
-        summary: formatTimeoutSummary(steps.length, artifacts, page.summary),
-    };
-}
-function formatTimeoutSteps(steps) {
-    if (!steps || steps.length === 0) {
-        return [];
-    }
-    const shownSteps = steps.slice(0, 6);
-    const lines = [
-        "Planned steps:",
-        ...shownSteps.map((step) => {
-            const commandText = redactSensitivePathSegmentsForDiagnostic(redactInvocationArgs(step.args).join(" "));
-            const generatedFrom = step.generatedFrom !== undefined && step.generatedFrom !== ""
-                ? `, generated from ${step.generatedFrom}`
-                : "";
-            const reason = step.reason !== undefined && step.reason !== ""
-                ? ` — ${redactSensitivePathSegmentsForDiagnostic(redactSensitiveText(step.reason))}`
-                : "";
-            return `- Step ${step.index} [${step.status}${generatedFrom}]: ${commandText}${reason}`;
-        }),
-    ];
-    if (steps.length > shownSteps.length) {
-        lines.push(`- ... ${steps.length - shownSteps.length} more step${steps.length - shownSteps.length === 1 ? "" : "s"} omitted`);
-    }
-    return lines;
-}
-function formatTimeoutRetry(step, pageTargetUnknown) {
-    if (!step?.retry) {
-        return undefined;
-    }
-    const payload = JSON.stringify({
-        ...step.retry,
-        stdin: JSON.stringify([redactInvocationArgs(step.args)]),
-    });
-    return pageTargetUnknown
-        ? `Retry candidate for step ${step.index}: ${payload}. Verify the current URL before running it.`
-        : `Retry candidate for step ${step.index} (outcome unknown): ${payload}`;
-}
-function formatTimeoutArtifact(artifact) {
-    const size = typeof artifact.sizeBytes === "number" ? `, ${artifact.sizeBytes} bytes` : "";
-    const state = artifact.exists ? `exists${size}` : "missing";
-    return `Artifact from step ${artifact.stepIndex}: ${redactSensitivePathSegmentsForDiagnostic(artifact.path)} (${state})`;
-}
-function formatTimeoutCurrentPage(page) {
-    if (!page) {
-        return undefined;
-    }
-    const title = page.title ?? "";
-    const url = page.url ?? "";
-    if (title === "" && url === "") {
-        return undefined;
-    }
-    const currentPageTitle = title !== "" ? redactSensitivePathSegmentsForDiagnostic(redactSensitiveText(title)) : undefined;
-    const currentPageUrl = url !== "" ? sanitizeCurrentPageUrlForTimeoutDiagnostic(url) : undefined;
-    return `Current page: ${[currentPageTitle, currentPageUrl].filter(Boolean).join(" — ")}`;
-}
-export function formatTimeoutPartialProgressText(progress, pageTargetUnknown = false) {
-    const lines = [`Timeout partial progress: ${progress.summary}`];
-    const currentPage = formatTimeoutCurrentPage(progress.currentPage);
-    if (currentPage !== undefined) {
-        lines.push(currentPage);
-    }
-    lines.push(...formatTimeoutSteps(progress.steps));
-    const retry = formatTimeoutRetry(progress.retryStep, pageTargetUnknown);
-    if (retry !== undefined) {
-        lines.push(retry);
-    }
-    lines.push(...progress.artifacts.map(formatTimeoutArtifact));
-    return lines.join("\n");
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js

@@ -1,108 +0,0 @@
-import { isRecord } from "../../parsing.js";
-import { redactSensitiveText } from "../../runtime-redaction.js";
-function isStringList(value) {
-    return Array.isArray(value) && value.every((item) => typeof item === "string");
-}
-function optionalStringFields(value, fields) {
-    return fields.every((field) => value[field] === undefined || typeof value[field] === "string");
-}
-function isTimeoutArtifact(value) {
-    return (isRecord(value) &&
-        typeof value.absolutePath === "string" &&
-        typeof value.exists === "boolean" &&
-        typeof value.path === "string" &&
-        (value.sizeBytes === undefined || typeof value.sizeBytes === "number") &&
-        (value.state === "missing" || value.state === "verified") &&
-        typeof value.stepIndex === "number");
-}
-function isTimeoutRetry(value) {
-    return (value === undefined ||
-        (isRecord(value) && isStringList(value.args) && typeof value.stdin === "string"));
-}
-function isTimeoutStep(value) {
-    return (isRecord(value) &&
-        isStringList(value.args) &&
-        typeof value.index === "number" &&
-        value.status === "unknown" &&
-        optionalStringFields(value, ["generatedFrom", "reason"]) &&
-        isTimeoutRetry(value.retry));
-}
-function isTimeoutCurrentPage(value) {
-    return (value === undefined ||
-        (isRecord(value) &&
-            (value.source === undefined || value.source === "live" || value.source === "planned") &&
-            optionalStringFields(value, ["title", "url"])));
-}
-function isTimeoutSteps(value) {
-    return value === undefined || (Array.isArray(value) && value.every(isTimeoutStep));
-}
-export function isTimeoutPartialProgress(value) {
-    if (!isRecord(value) ||
-        !Array.isArray(value.artifacts) ||
-        !value.artifacts.every(isTimeoutArtifact)) {
-        return false;
-    }
-    return (typeof value.summary === "string" &&
-        isTimeoutCurrentPage(value.currentPage) &&
-        (value.liveUrlRecovered === undefined || typeof value.liveUrlRecovered === "boolean") &&
-        (value.retryStep === undefined || isTimeoutStep(value.retryStep)) &&
-        isTimeoutSteps(value.steps));
-}
-export function redactSensitivePathSegmentsForDiagnostic(path) {
-    return path
-        .split(/([/\\]+)/)
-        .map((segment) => {
-        if (segment === "/" || segment === "\\" || /^[/\\]+$/.test(segment)) {
-            return segment;
-        }
-        return redactSensitiveText(segment) !== segment ||
-            /(?:secret|token|password|passwd|credential|auth|api[-_]?key|bearer)/i.test(segment)
-            ? "[REDACTED]"
-            : segment;
-    })
-        .join("");
-}
-export function sanitizeCurrentPageUrlForTimeoutDiagnostic(url) {
-    try {
-        const parsedUrl = new URL(url);
-        parsedUrl.pathname = parsedUrl.pathname
-            .split("/")
-            .map(redactSensitivePathSegmentsForDiagnostic)
-            .join("/");
-        for (const [key, value] of parsedUrl.searchParams.entries()) {
-            if (redactSensitiveText(key) !== key ||
-                redactSensitiveText(value) !== value ||
-                /(?:secret|token|password|passwd|credential|auth|api[-_]?key|bearer)/i.test(`${key} ${value}`)) {
-                parsedUrl.searchParams.set(key, "[REDACTED]");
-            }
-        }
-        if (parsedUrl.hash !== "") {
-            parsedUrl.hash = redactSensitivePathSegmentsForDiagnostic(redactSensitiveText(parsedUrl.hash));
-        }
-        return redactSensitiveText(parsedUrl.toString());
-    }
-    catch {
-        return redactSensitivePathSegmentsForDiagnostic(redactSensitiveText(url));
-    }
-}
-function redactProgressValue(value) {
-    if (typeof value === "string") {
-        return /^https?:\/\//i.test(value)
-            ? sanitizeCurrentPageUrlForTimeoutDiagnostic(value)
-            : redactSensitivePathSegmentsForDiagnostic(redactSensitiveText(value));
-    }
-    if (Array.isArray(value)) {
-        return value.map(redactProgressValue);
-    }
-    if (isRecord(value)) {
-        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redactProgressValue(item)]));
-    }
-    return value;
-}
-export function redactTimeoutPartialProgress(progress) {
-    const redacted = redactProgressValue(progress);
-    if (!isTimeoutPartialProgress(redacted)) {
-        throw new Error("Invalid timeout partial-progress evidence.");
-    }
-    return redacted;
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/types.js

@@ -1 +0,0 @@
-export {};