pi-agent-browser-native 0.9.4 → 0.9.6

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js

@@ -1,225 +0,0 @@
-import { isRecord } from "../../../parsing.js";
-import { buildAgentBrowserResultCategoryDetails } from "../../../results/categories.js";
-import { applyNamespaceToNextActions } from "../../../results/next-actions.js";
-import { buildScrollNoopNextActions } from "../interaction-diagnostics.js";
-import { buildSessionDetailFields, runSessionCommandData } from "../session-state.js";
-const SCROLL_CONTAINER_DIRECTIONS = new Set(["down", "left", "right", "up"]);
-function getContainerScrollRequest(commandTokens) {
-    if (commandTokens[0] !== "scroll" || commandTokens.length < 3) {
-        return undefined;
-    }
-    const selector = commandTokens[1];
-    const direction = commandTokens[2]?.toLowerCase();
-    if (selector === "" ||
-        selector.startsWith("-") ||
-        selector.startsWith("@") ||
-        SCROLL_CONTAINER_DIRECTIONS.has(selector.toLowerCase())) {
-        return undefined;
-    }
-    if (!SCROLL_CONTAINER_DIRECTIONS.has(direction)) {
-        return undefined;
-    }
-    return { amount: commandTokens[3], direction, selector };
-}
-function buildContainerScrollScript(request) {
-    return `(() => {
-  const selector = ${JSON.stringify(request.selector)};
-  const direction = ${JSON.stringify(request.direction)};
-  const amountToken = ${JSON.stringify(request.amount ?? "")};
-  let element;
-  try { element = document.querySelector(selector); } catch (error) { return { status: "invalid-selector", selector, error: String(error && error.message || error) }; }
-  if (!(element instanceof HTMLElement)) return { status: "not-found", selector };
-  const axis = direction === "left" || direction === "right" ? "x" : "y";
-  const before = { scrollLeft: element.scrollLeft, scrollTop: element.scrollTop, scrollHeight: element.scrollHeight, scrollWidth: element.scrollWidth, clientHeight: element.clientHeight, clientWidth: element.clientWidth };
-  const parseAmount = () => {
-    const token = String(amountToken || "").trim().toLowerCase();
-    const extent = axis === "x" ? element.clientWidth : element.clientHeight;
-    if (!token) return Math.max(1, Math.floor(extent * 0.8));
-    if (token.endsWith("%")) {
-      const value = Number(token.slice(0, -1));
-      return Number.isFinite(value) ? Math.max(1, Math.floor(extent * value / 100)) : Math.max(1, Math.floor(extent * 0.8));
-    }
-    const pixels = Number(token.replace(/px$/, ""));
-    return Number.isFinite(pixels) && pixels > 0 ? Math.floor(pixels) : Math.max(1, Math.floor(extent * 0.8));
-  };
-  const delta = parseAmount() * (direction === "up" || direction === "left" ? -1 : 1);
-  element.scrollBy({ [axis === "x" ? "left" : "top"]: delta, behavior: "instant" });
-  const after = { scrollLeft: element.scrollLeft, scrollTop: element.scrollTop, scrollHeight: element.scrollHeight, scrollWidth: element.scrollWidth, clientHeight: element.clientHeight, clientWidth: element.clientWidth };
-  const moved = before.scrollLeft !== after.scrollLeft || before.scrollTop !== after.scrollTop;
-  return { status: moved ? "scrolled" : "no-movement", selector, direction, amount: amountToken || undefined, before, after };
-})()`;
-}
-function buildScrollResult(options) {
-    return {
-        content: [{ type: "text", text: options.message }],
-        details: {
-            args: options.redactedArgs,
-            command: options.command,
-            compatibilityWorkaround: options.compatibilityWorkaround,
-            data: options.result,
-            effectiveArgs: options.effectiveArgs,
-            exitCode: options.succeeded ? 0 : 1,
-            nextActions: options.succeeded
-                ? undefined
-                : applyNamespaceToNextActions(buildScrollNoopNextActions(options.sessionName), options.namespace),
-            [options.scrollField]: options.scrollValue,
-            sessionMode: options.sessionMode,
-            ...buildAgentBrowserResultCategoryDetails({
-                args: options.effectiveArgs,
-                command: options.command,
-                errorText: options.succeeded ? undefined : options.message,
-                succeeded: options.succeeded,
-                validationError: options.succeeded ? undefined : options.message,
-            }),
-            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace, options.managedSessionRestoreDisabled()),
-            summary: options.message,
-            validationError: options.succeeded ? undefined : options.message,
-        },
-        isError: !options.succeeded,
-    };
-}
-function getScrollResult(data) {
-    const result = isRecord(data) && isRecord(data.result) ? data.result : data;
-    return isRecord(result) && typeof result.status === "string"
-        ? { ...result, status: result.status }
-        : undefined;
-}
-function describeScrollAmount(amount) {
-    return amount !== undefined && amount !== "" ? ` by ${amount}` : "";
-}
-export async function tryContainerScroll(options) {
-    const request = getContainerScrollRequest(options.commandTokens);
-    if (!request || (options.sessionName ?? "") === "") {
-        return undefined;
-    }
-    const data = await runSessionCommandData({
-        args: ["eval", "--stdin"],
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-        signal: options.signal,
-        stdin: buildContainerScrollScript(request),
-    });
-    const result = getScrollResult(data);
-    if (!result) {
-        return undefined;
-    }
-    const succeeded = result.status === "scrolled";
-    const message = succeeded
-        ? `Scrolled container ${request.selector} ${request.direction}${describeScrollAmount(request.amount)}.`
-        : `Scroll container ${request.selector} did not move (${result.status}).`;
-    return buildScrollResult({
-        ...options,
-        command: "scroll",
-        message,
-        result,
-        scrollField: "scrollContainer",
-        scrollValue: { request, result },
-        succeeded,
-    });
-}
-function isPageScrollDirection(direction) {
-    return (direction === "down" || direction === "left" || direction === "right" || direction === "up");
-}
-function isValidScrollAmount(amount) {
-    if (amount === undefined || amount === "") {
-        return true;
-    }
-    return /^\d+(?:\.\d+)?(?:px|%)?$/.test(amount) && Number(amount.replace(/(?:px|%)$/, "")) > 0;
-}
-function describePageScroll(request) {
-    if ("target" in request) {
-        return `to ${request.target}`;
-    }
-    return `${request.direction}${describeScrollAmount(request.amount)}`;
-}
-function getPageScrollToRequest(commandTokens) {
-    if (commandTokens[0] !== "scroll") {
-        return undefined;
-    }
-    if (commandTokens[1]?.toLowerCase() === "to") {
-        return getPageScrollTarget(commandTokens.at(2));
-    }
-    const direction = commandTokens[1]?.toLowerCase();
-    if (!isPageScrollDirection(direction) || commandTokens.length > 3) {
-        return undefined;
-    }
-    const amount = commandTokens.at(2);
-    if (!isValidScrollAmount(amount)) {
-        return undefined;
-    }
-    return { amount, direction };
-}
-function getPageScrollTarget(token) {
-    const target = token?.toLowerCase();
-    return target === "end" || target === "top" ? { target } : undefined;
-}
-function buildPageScrollToScript(request) {
-    return `(() => {
-  const target = ${JSON.stringify("target" in request ? request.target : undefined)};
-  const direction = ${JSON.stringify("direction" in request ? request.direction : undefined)};
-  const amountToken = ${JSON.stringify("amount" in request ? (request.amount ?? "") : "")};
-  const request = target ? { target } : { direction, amount: amountToken || undefined };
-  const scroller = document.scrollingElement || document.documentElement || document.body;
-  if (!scroller) return { status: "no-scroller", ...request };
-  const before = { scrollLeft: scroller.scrollLeft, scrollTop: scroller.scrollTop, scrollHeight: scroller.scrollHeight, scrollWidth: scroller.scrollWidth, clientHeight: scroller.clientHeight, clientWidth: scroller.clientWidth };
-  const axis = direction === "left" || direction === "right" ? "x" : "y";
-  const extent = axis === "x" ? scroller.clientWidth : scroller.clientHeight;
-  const parseAmount = () => {
-    if (!amountToken) return Math.max(1, Math.floor(extent * 0.8));
-    if (amountToken.endsWith("%")) {
-      const value = Number(amountToken.slice(0, -1));
-      return Number.isFinite(value) ? Math.max(1, Math.floor(extent * value / 100)) : Math.max(1, Math.floor(extent * 0.8));
-    }
-    const pixels = Number(amountToken.replace(/px$/, ""));
-    return Number.isFinite(pixels) && pixels > 0 ? Math.floor(pixels) : Math.max(1, Math.floor(extent * 0.8));
-  };
-  const delta = parseAmount() * (direction === "up" || direction === "left" ? -1 : 1);
-  const nextTop = target === "top" ? 0 : target === "end" ? Math.max(0, scroller.scrollHeight - scroller.clientHeight) : axis === "y" ? scroller.scrollTop + delta : scroller.scrollTop;
-  const nextLeft = axis === "x" ? scroller.scrollLeft + delta : scroller.scrollLeft;
-  const priorBehavior = scroller.style.scrollBehavior;
-  scroller.style.scrollBehavior = "auto";
-  window.scrollTo(nextLeft, nextTop);
-  scroller.scrollLeft = nextLeft;
-  scroller.scrollTop = nextTop;
-  const after = { scrollLeft: scroller.scrollLeft, scrollTop: scroller.scrollTop, scrollHeight: scroller.scrollHeight, scrollWidth: scroller.scrollWidth, clientHeight: scroller.clientHeight, clientWidth: scroller.clientWidth };
-  scroller.style.scrollBehavior = priorBehavior;
-  const moved = before.scrollLeft !== after.scrollLeft || before.scrollTop !== after.scrollTop;
-  return { status: moved ? "scrolled" : "no-movement", ...request, before, after };
-})()`;
-}
-export async function tryPageScrollTo(options) {
-    const request = getPageScrollToRequest(options.commandTokens);
-    if (!request || (options.sessionName ?? "") === "") {
-        return undefined;
-    }
-    const data = await runSessionCommandData({
-        args: ["eval", "--stdin"],
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-        signal: options.signal,
-        stdin: buildPageScrollToScript(request),
-    });
-    const result = getScrollResult(data);
-    if (!result) {
-        return undefined;
-    }
-    const succeeded = result.status === "scrolled";
-    if (!succeeded && "direction" in request) {
-        return undefined;
-    }
-    const description = describePageScroll(request);
-    const message = succeeded
-        ? `Scrolled page ${description}.`
-        : `Scroll ${description} completed with no observed movement (${result.status}).`;
-    return buildScrollResult({
-        ...options,
-        command: "scroll",
-        message,
-        result,
-        scrollField: "scrollPage",
-        scrollValue: { request, result },
-        succeeded,
-    });
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js

@@ -1,150 +0,0 @@
-import { isRecord } from "../../../parsing.js";
-export function hasSnapshotText(value) {
-    return value !== undefined && value !== "";
-}
-function filterOperand(tokens, index) {
-    const token = tokens[index];
-    if (token !== "--search" && token !== "--filter") {
-        return undefined;
-    }
-    const value = tokens.at(index + 1);
-    if (value === undefined || value.startsWith("-")) {
-        return undefined;
-    }
-    if (token === "--search") {
-        return { search: value };
-    }
-    const role = /^role=(.+)$/i.exec(value.trim())?.at(1);
-    return hasSnapshotText(role) ? { role: role.trim().toLowerCase() } : {};
-}
-export function snapshotHasTextFilters(request) {
-    return hasSnapshotText(request.role) || hasSnapshotText(request.search);
-}
-export function parseSnapshotFilterRequest(commandTokens) {
-    if (commandTokens[0] !== "snapshot") {
-        return undefined;
-    }
-    const cleanArgs = [];
-    let role;
-    let search;
-    for (let index = 0; index < commandTokens.length; index += 1) {
-        const token = commandTokens[index];
-        // Wrapper filters require the complete native tree, never a revision-relative patch.
-        if (["--delta", "--full", "--viewport", "--diff"].includes(token)) {
-            continue;
-        }
-        const operand = filterOperand(commandTokens, index);
-        if (operand) {
-            if (operand.search !== undefined) {
-                search = operand.search;
-            }
-            if (operand.role !== undefined) {
-                role = operand.role;
-            }
-            index += 1;
-        }
-        else {
-            cleanArgs.push(token);
-        }
-    }
-    const viewport = commandTokens.includes("--viewport");
-    const diff = commandTokens.includes("--diff");
-    return snapshotHasTextFilters({ role, search }) || viewport || diff
-        ? { cleanArgs, diff, role, search, viewport }
-        : undefined;
-}
-export function buildSnapshotDiff(previous, current) {
-    if (!current) {
-        return undefined;
-    }
-    const currentRefs = new Map(Object.entries(current.refs ?? {}));
-    const previousRefs = new Map(Object.entries(previous?.refs ?? {}));
-    if (!previous) {
-        return {
-            addedRefs: [...currentRefs.keys()],
-            changedRefs: [],
-            removedRefs: [],
-            summary: `Snapshot diff: no previous snapshot; ${currentRefs.size} current refs recorded.`,
-            unchangedRefs: 0,
-        };
-    }
-    const addedRefs = [];
-    const changedRefs = [];
-    let unchangedRefs = 0;
-    for (const [refId, currentRef] of currentRefs) {
-        const previousRef = previousRefs.get(refId);
-        if (!previousRef) {
-            addedRefs.push(refId);
-        }
-        else if (previousRef.role !== currentRef.role || previousRef.name !== currentRef.name) {
-            changedRefs.push(refId);
-        }
-        else {
-            unchangedRefs += 1;
-        }
-    }
-    const removedRefs = [...previousRefs.keys()].filter((refId) => !currentRefs.has(refId));
-    return {
-        addedRefs,
-        changedRefs,
-        removedRefs,
-        summary: `Snapshot diff: +${addedRefs.length} / -${removedRefs.length} / Δ${changedRefs.length} refs versus previous snapshot.`,
-        unchangedRefs,
-    };
-}
-function refMatches(value, request) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    const role = typeof value.role === "string" ? value.role.toLowerCase() : "";
-    const name = typeof value.name === "string" ? value.name : "";
-    const search = request.search?.trim().toLowerCase();
-    return ((!hasSnapshotText(request.role) || role === request.role) &&
-        (!hasSnapshotText(search) || `${role} ${name}`.toLowerCase().includes(search)));
-}
-function snapshotLineMatches(line, refs, search) {
-    return ((hasSnapshotText(search) && line.toLowerCase().includes(search)) ||
-        [...refs].some((refId) => line.includes(`[ref=${refId}]`) || line.includes(`ref=${refId}`)));
-}
-function filterDescription(request) {
-    return [
-        hasSnapshotText(request.role) ? `role=${request.role}` : undefined,
-        hasSnapshotText(request.search) ? `search=${JSON.stringify(request.search)}` : undefined,
-    ]
-        .filter((part) => part !== undefined)
-        .join(", ");
-}
-export function filterSnapshotData(data, request) {
-    if (!isRecord(data)) {
-        return undefined;
-    }
-    const refs = isRecord(data.refs) ? data.refs : {};
-    const snapshot = typeof data.snapshot === "string" ? data.snapshot : "";
-    const lines = snapshot.split(/\r?\n/);
-    if (!hasSnapshotText(request.role) && !hasSnapshotText(request.search)) {
-        const totalLines = lines.filter((line) => line.length > 0).length;
-        return {
-            data,
-            matchedRefs: Object.keys(refs).length,
-            totalRefs: Object.keys(refs).length,
-            totalLines,
-            visibleLines: totalLines,
-        };
-    }
-    const matchingRefs = Object.entries(refs).filter(([, value]) => refMatches(value, request));
-    const ids = new Set(matchingRefs.map(([id]) => id));
-    const visibleLines = lines.filter((line) => snapshotLineMatches(line, ids, request.search?.trim().toLowerCase()));
-    return {
-        data: {
-            ...data,
-            refs: Object.fromEntries(matchingRefs),
-            snapshot: visibleLines.length > 0
-                ? visibleLines.join("\n")
-                : `(no snapshot lines matched ${filterDescription(request)})`,
-        },
-        matchedRefs: matchingRefs.length,
-        totalRefs: Object.keys(refs).length,
-        totalLines: lines.filter((line) => line.length > 0).length,
-        visibleLines: visibleLines.length,
-    };
-}

package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js

@@ -1,165 +0,0 @@
-import { buildAgentBrowserResultCategoryDetails } from "../../../results/categories.js";
-import { buildSnapshotPresentation } from "../../../results/snapshot.js";
-import { extractRefSnapshotFromData, } from "../../../session-page-state.js";
-import { redactSensitiveValue } from "../../../runtime-redaction.js";
-import { collectScrollPositionSnapshot } from "../interaction-diagnostics.js";
-import { buildSessionDetailFields, runSessionCommandData } from "../session-state.js";
-import { attachRenderedTextMatchRefs, buildRenderedTextSearchEval, extractRenderedTextSearchResult, formatRenderedTextSearchMatches, } from "./snapshot-rendered-text.js";
-import { buildSnapshotDiff, filterSnapshotData, hasSnapshotText, parseSnapshotFilterRequest, } from "./snapshot-filter-data.js";
-async function collectRenderedText(options, request, snapshotData) {
-    if (!hasSnapshotText(request.search)) {
-        return undefined;
-    }
-    const data = await runSessionCommandData({
-        ...options,
-        args: ["eval", "--stdin"],
-        stdin: buildRenderedTextSearchEval(request.search),
-    });
-    const result = extractRenderedTextSearchResult(data);
-    return result
-        ? { ...result, matches: attachRenderedTextMatchRefs(result.matches, snapshotData) }
-        : undefined;
-}
-async function collectSnapshotEvidence(options, request) {
-    const snapshotData = await runSessionCommandData({
-        args: request.cleanArgs,
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-        signal: options.signal,
-    });
-    const filtered = filterSnapshotData(snapshotData, request);
-    if (!filtered) {
-        return undefined;
-    }
-    const renderedTextSearch = await collectRenderedText({
-        cwd: options.cwd,
-        namespace: options.namespace,
-        sessionName: options.sessionName,
-        signal: options.signal,
-    }, request, snapshotData);
-    const viewport = request.viewport
-        ? await collectScrollPositionSnapshot({
-            cwd: options.cwd,
-            namespace: options.namespace,
-            sessionName: options.sessionName,
-            signal: options.signal,
-        })
-        : undefined;
-    const fullSnapshot = extractRefSnapshotFromData(snapshotData);
-    const diff = request.diff
-        ? buildSnapshotDiff(options.previousRefSnapshot, fullSnapshot)
-        : undefined;
-    if (fullSnapshot) {
-        options.sessionPageState.applyRefSnapshot({
-            sessionName: options.sessionStateKey ?? options.sessionName,
-            snapshot: fullSnapshot,
-            update: options.sessionPageStateUpdate,
-        });
-    }
-    return { filtered, renderedTextSearch, viewport, fullSnapshot, diff };
-}
-function snapshotFilterSummary(request, evidence) {
-    if (hasSnapshotText(request.role) || hasSnapshotText(request.search)) {
-        const role = hasSnapshotText(request.role) ? ` role=${request.role}` : "";
-        const search = hasSnapshotText(request.search)
-            ? ` search ${JSON.stringify(request.search)}`
-            : "";
-        return `Snapshot filter: ${evidence.filtered.matchedRefs}/${evidence.filtered.totalRefs} direct refs matched${role}${search}; ${evidence.filtered.visibleLines} surrounding snapshot line${evidence.filtered.visibleLines === 1 ? "" : "s"} shown.`;
-    }
-    return request.diff
-        ? (evidence.diff?.summary ?? "Snapshot diff unavailable.")
-        : "Snapshot viewport metadata collected.";
-}
-function viewportText(viewport) {
-    return viewport
-        ? `Viewport: ${viewport.innerWidth}×${viewport.innerHeight}, scroll ${viewport.scrollX},${viewport.scrollY}, document ${viewport.scrollWidth}×${viewport.scrollHeight}, sampled scroll containers ${viewport.containers.length}/${viewport.containerCount}.`
-        : undefined;
-}
-function snapshotPrefix(request, evidence, summary) {
-    const diffText = hasSnapshotText(request.role) || hasSnapshotText(request.search)
-        ? evidence.diff?.summary
-        : undefined;
-    return [
-        summary,
-        formatRenderedTextSearchMatches(evidence.renderedTextSearch),
-        diffText,
-        viewportText(evidence.viewport),
-    ]
-        .filter((line) => line !== undefined)
-        .join("\n\n");
-}
-async function presentSnapshotFilter(options, evidence, prefix) {
-    const presentation = options.modelVisible === false
-        ? { content: [], data: redactSensitiveValue(evidence.filtered.data), summary: "Snapshot" }
-        : await buildSnapshotPresentation(evidence.filtered.data, options.persistentArtifactStore, options.artifactManifest);
-    const first = presentation.content.at(0);
-    const content = [...presentation.content];
-    if (first?.type === "text") {
-        content[0] = { ...first, text: `${prefix}\n\n${first.text}` };
-    }
-    return { ...presentation, content };
-}
-function snapshotFilterDetails(request, evidence) {
-    if (!hasSnapshotText(request.role) && !hasSnapshotText(request.search)) {
-        return undefined;
-    }
-    return {
-        cleanArgs: request.cleanArgs,
-        matchedRefs: evidence.filtered.matchedRefs,
-        renderedTextMatches: evidence.renderedTextSearch?.matches,
-        renderedTextTotalMatches: evidence.renderedTextSearch?.totalMatches,
-        renderedTextTruncated: evidence.renderedTextSearch?.truncated,
-        role: request.role,
-        search: request.search,
-        totalLines: evidence.filtered.totalLines,
-        totalRefs: evidence.filtered.totalRefs,
-        visibleLines: evidence.filtered.visibleLines,
-    };
-}
-function snapshotToolResult(options, request, evidence, presentation) {
-    const summary = snapshotFilterSummary(request, evidence);
-    return {
-        content: [...presentation.content],
-        details: {
-            args: options.redactedArgs,
-            artifactManifest: presentation.artifactManifest,
-            artifactRetentionSummary: presentation.artifactRetentionSummary,
-            command: "snapshot",
-            compatibilityWorkaround: options.compatibilityWorkaround,
-            data: presentation.data,
-            effectiveArgs: options.effectiveArgs,
-            fullOutputPath: presentation.fullOutputPath,
-            fullOutputPaths: presentation.fullOutputPaths,
-            refSnapshot: evidence.fullSnapshot,
-            sessionMode: options.sessionMode,
-            snapshotDiff: evidence.diff,
-            snapshotFilter: snapshotFilterDetails(request, evidence),
-            snapshotViewport: evidence.viewport,
-            ...buildAgentBrowserResultCategoryDetails({
-                args: options.effectiveArgs,
-                command: "snapshot",
-                succeeded: true,
-            }),
-            ...buildSessionDetailFields(options.sessionName, options.usedImplicitSession, options.namespace, options.managedSessionRestoreDisabled()),
-            summary,
-        },
-        isError: false,
-    };
-}
-export async function trySnapshotFilter(options) {
-    const request = parseSnapshotFilterRequest(options.commandTokens);
-    if (!request || !hasSnapshotText(options.sessionName)) {
-        return undefined;
-    }
-    const evidence = await collectSnapshotEvidence({ ...options, sessionName: options.sessionName }, request);
-    if (!evidence) {
-        return undefined;
-    }
-    const summary = snapshotFilterSummary(request, evidence);
-    const presentation = await presentSnapshotFilter(options, evidence, snapshotPrefix(request, evidence, summary));
-    return {
-        artifactManifest: presentation.artifactManifest,
-        result: snapshotToolResult(options, request, evidence, presentation),
-    };
-}