pi-agent-browser-native 0.9.5 → 0.9.6

package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js

@@ -1,142 +0,0 @@
-import { readFile, readdir } from "node:fs/promises";
-import { extname, join } from "node:path";
-import { distinctNetworkCandidates } from "./lookup-network-evidence.js";
-import { SOURCE_LOOKUP_IGNORED_DIRECTORIES, SOURCE_LOOKUP_WORKSPACE_EXTENSIONS, } from "./types.js";
-async function walkWorkspaceSourceFiles(root, maxFiles) {
-    const files = [];
-    async function visit(directory) {
-        if (files.length >= maxFiles) {
-            return;
-        }
-        let entries;
-        try {
-            entries = await readdir(directory, { withFileTypes: true });
-        }
-        catch {
-            // Unreadable workspace directories contribute no source candidates.
-            return;
-        }
-        for (const entry of entries) {
-            if (files.length >= maxFiles) {
-                return;
-            }
-            const path = join(directory, entry.name);
-            if (entry.isDirectory() && !SOURCE_LOOKUP_IGNORED_DIRECTORIES.has(entry.name)) {
-                // Ordered depth-first traversal preserves which files enter the bounded scan.
-                // oxlint-disable-next-line no-await-in-loop
-                await visit(path);
-            }
-            if (entry.isFile() && SOURCE_LOOKUP_WORKSPACE_EXTENSIONS.has(extname(entry.name))) {
-                files.push(path);
-            }
-        }
-    }
-    await visit(root);
-    return files;
-}
-async function readWorkspaceText(file) {
-    try {
-        return await readFile(file, "utf8");
-    }
-    catch {
-        // A file removed or unreadable after enumeration is not lookup evidence.
-        return undefined;
-    }
-}
-function scanLimitations(files, maxFiles) {
-    return files.length >= maxFiles ? [`Workspace source scan stopped at ${maxFiles} files.`] : [];
-}
-function componentPattern(name) {
-    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    return new RegExp(`(?:function|class)\\s+${escaped}\\b|(?:const|let|var)\\s+${escaped}\\s*=|export\\s+default\\s+function\\s+${escaped}\\b`);
-}
-export async function scanWorkspaceComponent(query, cwd) {
-    const componentName = query.componentName;
-    if (componentName === undefined || componentName.length === 0) {
-        return { candidates: [], limitations: [] };
-    }
-    const files = await walkWorkspaceSourceFiles(cwd, query.maxWorkspaceFiles);
-    const pattern = componentPattern(componentName);
-    const candidates = [];
-    for (const file of files) {
-        // Reads remain serial so the ten-candidate budget stops further filesystem work.
-        // oxlint-disable-next-line no-await-in-loop
-        const text = await readWorkspaceText(file);
-        if (text === undefined) {
-            continue;
-        }
-        const match = pattern.exec(text);
-        if (match === null) {
-            continue;
-        }
-        candidates.push({
-            componentName,
-            confidence: "low",
-            evidence: [`local workspace contains a matching ${componentName} declaration`],
-            file,
-            line: text.slice(0, match.index).split("\n").length,
-            source: "workspace-search",
-        });
-        if (candidates.length >= 10) {
-            break;
-        }
-    }
-    return { candidates, limitations: scanLimitations(files, query.maxWorkspaceFiles) };
-}
-function requestNeedles(value) {
-    try {
-        const parsed = new URL(value);
-        return [value, parsed.pathname].filter((item) => item.length > 0 && item !== "/");
-    }
-    catch {
-        return [value];
-    }
-}
-function workspaceRequestNeedles(query, failedRequests) {
-    return [
-        ...new Set([query.url, query.filter, ...failedRequests.map((request) => request.url)]
-            .filter((value) => typeof value === "string" && value.length > 0)
-            .flatMap(requestNeedles)),
-    ].slice(0, 8);
-}
-function requestLiteralCandidates(text, file, needles) {
-    const candidates = [];
-    for (const needle of needles) {
-        const index = text.indexOf(needle);
-        if (index !== -1) {
-            candidates.push({
-                confidence: "low",
-                evidence: [`local workspace contains request URL literal ${needle}`],
-                file,
-                line: text.slice(0, index).split("\n").length,
-                requestUrl: needle,
-                source: "workspace-search",
-            });
-        }
-    }
-    return candidates;
-}
-export async function scanWorkspaceRequests(query, failedRequests, cwd) {
-    const needles = workspaceRequestNeedles(query, failedRequests);
-    if (needles.length === 0) {
-        return { candidates: [], limitations: [] };
-    }
-    const files = await walkWorkspaceSourceFiles(cwd, query.maxWorkspaceFiles);
-    let candidates = [];
-    for (const file of files) {
-        // Preserve first-match ordering and stop reading files at the candidate budget.
-        // oxlint-disable-next-line no-await-in-loop
-        const text = await readWorkspaceText(file);
-        if (text === undefined) {
-            continue;
-        }
-        candidates = distinctNetworkCandidates([
-            ...candidates,
-            ...requestLiteralCandidates(text, file, needles),
-        ]).slice(0, 10);
-        if (candidates.length >= 10) {
-            break;
-        }
-    }
-    return { candidates, limitations: scanLimitations(files, query.maxWorkspaceFiles) };
-}

package/dist/extensions/agent-browser/lib/input-modes/lookups.js

@@ -1,84 +0,0 @@
-export { compileAgentBrowserNetworkSourceLookup, compileAgentBrowserSourceLookup, } from "./lookup-plan.js";
-export { redactNetworkSourceLookupAnalysis, redactNetworkSourceLookupArgs, redactNetworkSourceLookupSurface, redactNetworkSourceLookupUrl, } from "./lookup-redaction.js";
-function sourceStatus(candidateCount, unsupported) {
-    if (candidateCount > 0) {
-        return "candidates-found";
-    }
-    return unsupported ? "unsupported" : "no-candidates";
-}
-function sourceSummary(status, candidateCount, electronWorkspace) {
-    switch (status) {
-        case "candidates-found":
-            return `Source lookup found ${candidateCount} candidate location(s).`;
-        case "unsupported":
-            return "Source lookup could not inspect React metadata in this session.";
-        case "no-candidates":
-            if (electronWorkspace !== undefined) {
-                return `Source lookup found no candidate locations. The workspace scan was limited to ${electronWorkspace}; packaged Electron app code may live outside that cwd in app resources or app.asar.`;
-            }
-            return "Source lookup found no candidate locations.";
-    }
-}
-export async function analyzeSourceLookupResults(data, compiled, cwd, context) {
-    const { distinctSourceCandidates, observeSourceCandidates } = await import("./lookup-source-evidence.js");
-    const { scanWorkspaceComponent } = await import("./lookup-workspace.js");
-    const observed = observeSourceCandidates(data);
-    const workspace = await scanWorkspaceComponent(compiled.query, cwd);
-    const candidates = distinctSourceCandidates([...observed.candidates, ...workspace.candidates]);
-    const status = sourceStatus(candidates.length, observed.unsupported);
-    const electronContext = status === "no-candidates" ? context?.electronContext : undefined;
-    const workspaceRoot = context?.workspaceRoot ?? cwd;
-    const limitations = [
-        "Experimental lookup only reports candidates with evidence; it cannot guarantee a DOM node maps to one source file.",
-        "React source hints require the page to be opened with --enable react-devtools and source information from the app build.",
-        ...workspace.limitations,
-    ];
-    if (electronContext) {
-        limitations.push(`Workspace source scan is limited to the captured execution directory: ${workspaceRoot}.`, "Packaged Electron app code may live inside installed app resources or app.asar outside the workspace; the wrapper does not unpack asar files or scan app bundle resources.");
-    }
-    return {
-        candidates,
-        electronContext,
-        limitations,
-        status,
-        summary: sourceSummary(status, candidates.length, electronContext ? workspaceRoot : undefined),
-        workspaceRoot: electronContext ? workspaceRoot : undefined,
-    };
-}
-function networkStatus(failedCount, candidateCount) {
-    if (failedCount === 0) {
-        return "no-failed-requests";
-    }
-    return candidateCount > 0 ? "failed-requests-found" : "no-candidates";
-}
-function networkSummary(status, failedCount, candidateCount) {
-    switch (status) {
-        case "no-failed-requests":
-            return "Network source lookup found no failed requests.";
-        case "failed-requests-found":
-            return `Network source lookup found ${failedCount} failed request(s) and ${candidateCount} candidate source hint(s).`;
-        case "no-candidates":
-            return `Network source lookup found ${failedCount} failed request(s) but no source candidates.`;
-    }
-}
-export async function analyzeNetworkSourceLookupResults(data, compiled, cwd) {
-    const { distinctNetworkCandidates, getFailedNetworkRequests, observeInitiatorCandidates } = await import("./lookup-network-evidence.js");
-    const { scanWorkspaceRequests } = await import("./lookup-workspace.js");
-    const queryText = compiled.query.filter ?? compiled.query.url;
-    const failedRequests = getFailedNetworkRequests(data, queryText);
-    const observed = observeInitiatorCandidates(data, failedRequests, queryText);
-    const workspace = await scanWorkspaceRequests(compiled.query, failedRequests, cwd);
-    const candidates = distinctNetworkCandidates([...observed, ...workspace.candidates]);
-    const status = networkStatus(failedRequests.length, candidates.length);
-    return {
-        candidates,
-        failedRequests,
-        limitations: [
-            "Experimental network source hints report candidates only; failed requests can be triggered indirectly by frameworks, caches, service workers, or third-party scripts.",
-            "Initiator/source-map metadata is upstream/browser-build dependent and may be absent.",
-            ...workspace.limitations,
-        ],
-        status,
-        summary: networkSummary(status, failedRequests.length, candidates.length),
-    };
-}

package/dist/extensions/agent-browser/lib/input-modes/params.js

@@ -1,195 +0,0 @@
-import { JsonSchema as Type } from "../json-schema.js";
-import { StringEnum } from "../string-enum-schema.js";
-import { ELECTRON_DISCOVERY_DEFAULT_MAX_RESULTS, ELECTRON_DISCOVERY_MAX_RESULTS, } from "../electron/discovery-types.js";
-import { AGENT_BROWSER_CODE_MAX_TIMEOUT_MS, AGENT_BROWSER_ELECTRON_HANDOFFS, AGENT_BROWSER_ELECTRON_TARGET_TYPES, AGENT_BROWSER_QA_LOAD_STATES, AGENT_BROWSER_SEMANTIC_ACTIONS, AGENT_BROWSER_SEMANTIC_LOCATORS, DEFAULT_SESSION_MODE, SOURCE_LOOKUP_MAX_WORKSPACE_FILES, } from "./types.js";
-const AGENT_BROWSER_ADVANCED_TOOLS = ["action", "qa", "electron", "source", "network"];
-function outputProperties() {
-    return {
-        outputPath: Type.Optional(Type.String({
-            description: "Result-data path, separate from browser artifact paths.",
-            minLength: 1,
-        })),
-        timeoutMs: Type.Optional(Type.Integer({ description: "Timeout in ms; exceed explicit waits.", minimum: 1 })),
-    };
-}
-function sessionModeProperty() {
-    return Type.Optional(StringEnum(["auto", "fresh"], {
-        description: "Native configured sessions win; auto reuses the browser, fresh intentionally launches a separate managed browser.",
-        default: DEFAULT_SESSION_MODE,
-    }));
-}
-// Keep the always-on schemas small; specialized guidance belongs to each advanced tool.
-export function createAgentBrowserParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        args: Type.Array(Type.String(), {
-            description: "Native agent-browser argv without the binary or shell syntax. Fixed sequences: batch --bail with JSON-array stdin.",
-            minItems: 1,
-        }),
-        stdin: Type.Optional(Type.String({
-            description: "Native batch JSON, eval --stdin source, or auth save --password-stdin text.",
-        })),
-        ...outputProperties(),
-        sessionMode: sessionModeProperty(),
-    }, { additionalProperties: false }));
-}
-export function createAgentBrowserCodeParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        code: Type.String({
-            description: "JavaScript with await browser({args, stdin?, timeoutMs?}), emit(JSON), and emitImage(image handle). Fresh JS context; persistent browser.",
-            minLength: 1,
-            maxLength: 65_536,
-        }),
-        session: Type.Optional(Type.String({
-            description: "Explicit native session; omitted uses the ordinary default browser.",
-            minLength: 1,
-        })),
-        namespace: Type.Optional(Type.String({
-            description: "Native namespace; empty string selects the default namespace.",
-        })),
-        ...outputProperties(),
-        timeoutMs: Type.Optional(Type.Integer({ minimum: 1, maximum: AGENT_BROWSER_CODE_MAX_TIMEOUT_MS })),
-    }, { additionalProperties: false }));
-}
-export function createAgentBrowserActionParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        action: StringEnum(AGENT_BROWSER_SEMANTIC_ACTIONS),
-        locator: Type.Optional(StringEnum(AGENT_BROWSER_SEMANTIC_LOCATORS, {
-            description: "Select supports role or label.",
-        })),
-        value: Type.Optional(Type.String({
-            description: "Locator value or select option; label text for select by label.",
-        })),
-        values: Type.Optional(Type.Array(Type.String(), {
-            description: "Select options; required for select by label.",
-            minItems: 1,
-        })),
-        selector: Type.Optional(Type.String({ description: "Direct selector or current @ref." })),
-        text: Type.Optional(Type.String({ description: "Fill text." })),
-        role: Type.Optional(Type.String({ description: "Role locator; select needs combobox or listbox." })),
-        name: Type.Optional(Type.String({ description: "Accessible name." })),
-        session: Type.Optional(Type.String({ description: "Upstream session name." })),
-        ...outputProperties(),
-    }, {
-        additionalProperties: false,
-        // Top-level properties let Pi normalize optional nulls before validating branches.
-        anyOf: [
-            Type.Object({
-                action: StringEnum(["select"]),
-                locator: Type.Optional(StringEnum(["role", "label"])),
-            }, { not: { required: ["text"] } }),
-            Type.Object({ action: StringEnum(["check", "click", "fill"]) }, { not: { required: ["values"] } }),
-        ],
-    }));
-}
-export function createAgentBrowserQaParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        url: Type.Optional(Type.String()),
-        attached: Type.Optional(Type.Boolean()),
-        expectedText: Type.Optional(Type.Union([Type.String(), Type.Array(Type.String())])),
-        expectedSelector: Type.Optional(Type.String()),
-        screenshotPath: Type.Optional(Type.String()),
-        checkConsole: Type.Optional(Type.Boolean()),
-        checkErrors: Type.Optional(Type.Boolean()),
-        checkNetwork: Type.Optional(Type.Boolean()),
-        loadState: Type.Optional(StringEnum(AGENT_BROWSER_QA_LOAD_STATES)),
-        ...outputProperties(),
-        sessionMode: sessionModeProperty(),
-    }, {
-        additionalProperties: false,
-        anyOf: [
-            Type.Object({
-                attached: Type.Literal(true),
-                sessionMode: Type.Optional(StringEnum(["auto"])),
-            }, { not: { required: ["url"] } }),
-            Type.Object({ url: Type.String(), attached: Type.Optional(Type.Literal(false)) }),
-        ],
-    }));
-}
-export function createAgentBrowserElectronParamsSchema() {
-    const common = { outputPath: outputProperties().outputPath };
-    const timeoutMs = Type.Optional(Type.Integer({ minimum: 1 }));
-    const list = {
-        query: Type.Optional(Type.String({ description: "Case-insensitive app filter.", minLength: 1 })),
-        maxResults: Type.Optional(Type.Integer({
-            description: `Result cap; default ${ELECTRON_DISCOVERY_DEFAULT_MAX_RESULTS}, clamped to ${ELECTRON_DISCOVERY_MAX_RESULTS}.`,
-            minimum: 1,
-        })),
-    };
-    const launch = {
-        appPath: Type.Optional(Type.String({ description: "macOS .app path.", minLength: 1 })),
-        appName: Type.Optional(Type.String({ description: "Name from agent_browser_electron list.", minLength: 1 })),
-        bundleId: Type.Optional(Type.String({ minLength: 1 })),
-        executablePath: Type.Optional(Type.String({ minLength: 1 })),
-        appArgs: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
-        handoff: Type.Optional(StringEnum(AGENT_BROWSER_ELECTRON_HANDOFFS)),
-        targetType: Type.Optional(StringEnum(AGENT_BROWSER_ELECTRON_TARGET_TYPES)),
-        timeoutMs,
-        allow: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
-        deny: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
-    };
-    const probe = { launchId: Type.Optional(Type.String({ minLength: 1 })), timeoutMs };
-    const lifecycle = { ...probe, all: Type.Optional(Type.Literal(true)) };
-    // Strict providers need an object root; Pi needs root properties to normalize optional nulls.
-    // Each branch retains its original action-specific field boundary.
-    return Type.Unsafe(Type.Object({
-        action: StringEnum(["list", "launch", "status", "cleanup", "probe"]),
-        ...list,
-        ...launch,
-        ...lifecycle,
-        ...common,
-    }, {
-        additionalProperties: false,
-        anyOf: [
-            Type.Object({ action: StringEnum(["list"]), ...list, ...common }, { additionalProperties: false }),
-            Type.Object({ action: StringEnum(["launch"]), ...launch, ...common }, { additionalProperties: false }),
-            Type.Object({ action: StringEnum(["status", "cleanup"]), ...lifecycle, ...common }, { additionalProperties: false, not: { required: ["launchId", "all"] } }),
-            Type.Object({ action: StringEnum(["probe"]), ...probe, ...common }, { additionalProperties: false }),
-        ],
-    }));
-}
-export function createAgentBrowserSourceParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        selector: Type.Optional(Type.String({ description: "Visible selector or @ref." })),
-        reactFiberId: Type.Optional(Type.String({ description: "React fiber id; requires --enable react-devtools." })),
-        componentName: Type.Optional(Type.String({ description: "Component for local source search." })),
-        includeDomHints: Type.Optional(Type.Boolean({ description: "Inspect DOM hints; default true." })),
-        maxWorkspaceFiles: Type.Optional(Type.Integer({
-            description: "Source scan cap; default 2000.",
-            minimum: 1,
-            maximum: SOURCE_LOOKUP_MAX_WORKSPACE_FILES,
-        })),
-        ...outputProperties(),
-        sessionMode: sessionModeProperty(),
-    }, { additionalProperties: false }));
-}
-export function createAgentBrowserNetworkSourceParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        filter: Type.Optional(Type.String({ description: "Network request filter." })),
-        namespace: Type.Optional(Type.String()),
-        requestId: Type.Optional(Type.String({ description: "Request id to inspect." })),
-        session: Type.Optional(Type.String()),
-        url: Type.Optional(Type.String({ description: "Failed URL or fragment." })),
-        maxWorkspaceFiles: Type.Optional(Type.Integer({
-            description: "Source scan cap; default 2000.",
-            minimum: 1,
-            maximum: SOURCE_LOOKUP_MAX_WORKSPACE_FILES,
-        })),
-        ...outputProperties(),
-        sessionMode: sessionModeProperty(),
-    }, { additionalProperties: false }));
-}
-export function createAgentBrowserToolsParamsSchema() {
-    return Type.Unsafe(Type.Object({
-        enable: Type.Optional(Type.Array(StringEnum(AGENT_BROWSER_ADVANCED_TOOLS), {
-            description: "Add capabilities to active tools; omit to list inventory.",
-        })),
-    }, { additionalProperties: false }));
-}
-export const AGENT_BROWSER_PARAMS = createAgentBrowserParamsSchema();
-export const AGENT_BROWSER_CODE_PARAMS = createAgentBrowserCodeParamsSchema();
-export const AGENT_BROWSER_ACTION_PARAMS = createAgentBrowserActionParamsSchema();
-export const AGENT_BROWSER_QA_PARAMS = createAgentBrowserQaParamsSchema();
-export const AGENT_BROWSER_ELECTRON_PARAMS = createAgentBrowserElectronParamsSchema();
-export const AGENT_BROWSER_SOURCE_PARAMS = createAgentBrowserSourceParamsSchema();
-export const AGENT_BROWSER_NETWORK_SOURCE_PARAMS = createAgentBrowserNetworkSourceParamsSchema();
-export const AGENT_BROWSER_TOOLS_PARAMS = createAgentBrowserToolsParamsSchema();