pi-agent-browser-native 0.9.4 → 0.9.6

package/dist/extensions/agent-browser/lib/web-search-schema.js

@@ -1,82 +0,0 @@
-import { JsonSchema } from "./json-schema.js";
-import { StringEnum as localStringEnum } from "./string-enum-schema.js";
-import { DEFAULT_WEB_SEARCH_PROVIDER, EXA_SEARCH_TYPES, WEB_SEARCH_PROVIDERS, } from "./config.js";
-export const DEFAULT_SEARCH_RESULT_COUNT = 5;
-export const MAX_SEARCH_RESULT_COUNT = 10;
-const WEB_SEARCH_PROVIDER_PARAM_VALUES = ["auto", ...WEB_SEARCH_PROVIDERS];
-const EXA_SEARCH_CATEGORIES = [
-    "company",
-    "people",
-    "publication",
-    "news",
-    "personal site",
-    "financial report",
-];
-const MAX_EXA_DOMAIN_FILTERS = 20;
-const MAX_EXA_ADDITIONAL_QUERIES = 10;
-function createExaFilterProperties(Type, StringEnum) {
-    return {
-        includeDomains: Type.Optional(Type.Array(Type.String({ minLength: 1 }), {
-            minItems: 1,
-            maxItems: MAX_EXA_DOMAIN_FILTERS,
-            description: `Exa only. Limit results to 1–${MAX_EXA_DOMAIN_FILTERS} hostnames, path prefixes (exa.ai/docs), or wildcard subdomains (*.substack.com).`,
-        })),
-        excludeDomains: Type.Optional(Type.Array(Type.String({ minLength: 1 }), {
-            minItems: 1,
-            maxItems: MAX_EXA_DOMAIN_FILTERS,
-            description: `Exa only. Exclude 1–${MAX_EXA_DOMAIN_FILTERS} hostnames, path prefixes, or wildcard subdomains. Not compatible with category company or people.`,
-        })),
-        category: Type.Optional(StringEnum(EXA_SEARCH_CATEGORIES, {
-            description: "Exa-only result category. company and people cannot be combined with freshness or excludeDomains.",
-        })),
-        additionalQueries: Type.Optional(Type.Array(Type.String({ minLength: 1 }), {
-            minItems: 1,
-            maxItems: MAX_EXA_ADDITIONAL_QUERIES,
-            description: `Exa only. Add 1–${MAX_EXA_ADDITIONAL_QUERIES} query variations when the effective searchType is deep-lite, deep, or deep-reasoning.`,
-        })),
-        highlightsDynamic: Type.Optional(Type.Boolean({
-            description: "Exa-only research preview. Allocate one highlight budget across all results; the wrapper sends the required Exa-Beta header. Regular per-page highlights remain the default.",
-        })),
-    };
-}
-export function createAgentBrowserWebSearchParamsSchema(Type = JsonSchema, StringEnum = localStringEnum) {
-    return Type.Object({
-        query: Type.String({
-            minLength: 1,
-            description: "Search query to run with the configured Exa or Brave web search provider.",
-        }),
-        provider: Type.Optional(StringEnum(WEB_SEARCH_PROVIDER_PARAM_VALUES, {
-            description: `Optional provider override. auto uses configured keys and preferredProvider; when both Exa and Brave are available, the default preferred provider is ${DEFAULT_WEB_SEARCH_PROVIDER}.`,
-        })),
-        searchType: Type.Optional(StringEnum(EXA_SEARCH_TYPES, {
-            description: "Exa mode; omitted uses webSearch.defaultSearchType, then auto. instant (~250ms) is only for trivial lookups; fast (~450ms) favors latency; auto (~1s) is balanced. Pass searchType: deep-lite (~4s) for research before implementation unless config already defaults it; do not assume auto is deep enough. deep (4–15s) handles hard multi-source research; deep-reasoning (12–40s) is only for the hardest work. Brave ignores this field.",
-        })),
-        ...createExaFilterProperties(Type, StringEnum),
-        count: Type.Optional(Type.Integer({
-            minimum: 1,
-            maximum: MAX_SEARCH_RESULT_COUNT,
-            description: `Number of web results to return. Defaults to ${DEFAULT_SEARCH_RESULT_COUNT}; max ${MAX_SEARCH_RESULT_COUNT}.`,
-        })),
-        offset: Type.Optional(Type.Integer({
-            minimum: 0,
-            maximum: 9,
-            description: "Zero-based result offset for pagination. Defaults to 0.",
-        })),
-        country: Type.Optional(Type.String({
-            pattern: "^[A-Za-z]{2}$",
-            description: "Optional 2-letter country code, such as US or GB.",
-        })),
-        searchLang: Type.Optional(Type.String({
-            minLength: 2,
-            maxLength: 8,
-            description: "Optional Brave search language code, such as en or en-US.",
-        })),
-        safesearch: Type.Optional(StringEnum(["off", "moderate", "strict"], {
-            description: "Optional search safety setting. Brave forwards this as safesearch; Exa maps moderate/strict to moderation=true.",
-        })),
-        freshness: Type.Optional(StringEnum(["pd", "pw", "pm", "py"], {
-            description: "Optional freshness window: pd=past day, pw=past week, pm=past month, py=past year.",
-        })),
-    }, { additionalProperties: false });
-}
-export const AgentBrowserWebSearchParams = createAgentBrowserWebSearchParamsSchema();

package/dist/extensions/agent-browser/lib/web-search.js

@@ -1,149 +0,0 @@
-import { AGENT_BROWSER_NAMESPACE, AGENT_BROWSER_OUTPUT_SCHEMA, finalizeAgentBrowserNativeResult, } from "./native-output.js";
-import { redactSensitiveText } from "./runtime.js";
-import { resolvePreferredWebSearchCredential, } from "./config.js";
-import { AgentBrowserWebSearchParams, DEFAULT_SEARCH_RESULT_COUNT, MAX_SEARCH_RESULT_COUNT, } from "./web-search-schema.js";
-import { WebSearchRequestGate } from "./web-search-request.js";
-import { WebSearchLocalError, prepareWebSearchRequest } from "./web-search-providers.js";
-import { dedupeSearchResults, formatSearchResults, } from "./web-search-results.js";
-export { EXA_SEARCH_TYPES } from "./config.js";
-export { AgentBrowserWebSearchParams, createAgentBrowserWebSearchParamsSchema, } from "./web-search-schema.js";
-export { WEB_SEARCH_MIN_REQUEST_INTERVAL_MS, WebSearchRequestGate } from "./web-search-request.js";
-export { EXA_SEARCH_SYSTEM_PROMPT, buildBraveSearchUrl, buildExaSearchRequestBody, fetchBraveSearchJson, fetchExaSearchJson, getWebSearchProviderAdapter, } from "./web-search-providers.js";
-export { cleanSearchText, decodeHtmlEntities, normalizeBraveSearchResult, normalizeExaSearchResult, } from "./web-search-results.js";
-export const AGENT_BROWSER_WEB_SEARCH_TOOL_NAME = "agent_browser_web_search";
-function buildMissingCredentialError(provider) {
-    if (provider === "brave") {
-        return "agent_browser_web_search provider brave was requested but no BRAVE_API_KEY/config credential resolved.";
-    }
-    if (provider === "exa") {
-        return "agent_browser_web_search provider exa was requested but no EXA_API_KEY/config credential resolved.";
-    }
-    return "No Exa or Brave web search credential resolved. Configure webSearch.exaApiKey or webSearch.braveApiKey, or load EXA_API_KEY/BRAVE_API_KEY in the runtime environment.";
-}
-function validateRuntimeConfig(state) {
-    if (state.errors.length > 0) {
-        throw new WebSearchLocalError(`agent_browser_web_search config is invalid: ${state.errors.join("; ")}`);
-    }
-    if (!state.webSearchEnabled) {
-        throw new WebSearchLocalError("agent_browser_web_search is disabled by pi-agent-browser-native config.");
-    }
-}
-function validateProviderParams(provider, params) {
-    if (provider !== "brave") {
-        return;
-    }
-    const exaOnlyFields = [
-        params.includeDomains ? "includeDomains" : undefined,
-        params.excludeDomains ? "excludeDomains" : undefined,
-        params.category !== undefined ? "category" : undefined,
-        params.additionalQueries ? "additionalQueries" : undefined,
-        params.highlightsDynamic === true ? "highlightsDynamic" : undefined,
-    ].filter((field) => field !== undefined);
-    if (exaOnlyFields.length > 0) {
-        throw new WebSearchLocalError(`${exaOnlyFields.join(", ")} ${exaOnlyFields.length === 1 ? "requires" : "require"} provider exa; resolved provider was brave.`);
-    }
-}
-async function runWebSearch(state, params, gate, signal) {
-    validateRuntimeConfig(state);
-    const requestedProvider = params.provider ?? "auto";
-    const resolved = await resolvePreferredWebSearchCredential(state, {
-        provider: requestedProvider,
-        signal,
-    });
-    if (!resolved) {
-        throw new WebSearchLocalError(buildMissingCredentialError(requestedProvider));
-    }
-    validateProviderParams(resolved.provider, params);
-    const query = params.query.trim();
-    if (query.length === 0) {
-        throw new WebSearchLocalError("query must not be blank");
-    }
-    const count = Math.min(Math.max(params.count ?? DEFAULT_SEARCH_RESULT_COUNT, 1), MAX_SEARCH_RESULT_COUNT);
-    const offset = Math.max(params.offset ?? 0, 0);
-    const executionParams = {
-        additionalQueries: params.additionalQueries,
-        category: params.category,
-        country: params.country,
-        count,
-        excludeDomains: params.excludeDomains,
-        freshness: params.freshness,
-        highlightsDynamic: params.highlightsDynamic,
-        includeDomains: params.includeDomains,
-        offset,
-        query,
-        safesearch: params.safesearch,
-        searchLang: params.searchLang,
-        searchType: params.searchType ?? state.config.webSearch?.defaultSearchType ?? "auto",
-    };
-    const request = prepareWebSearchRequest(resolved.provider, executionParams, resolved.credential.value, signal);
-    const normalized = await gate.run(signal, request);
-    const results = dedupeSearchResults(normalized.results);
-    const duplicatesRemoved = normalized.results.length - results.length;
-    return {
-        provider: resolved.provider,
-        query,
-        returnedQuery: normalized.returnedQuery,
-        count,
-        offset,
-        ...normalized.extraDetails,
-        fetchedAt: new Date().toISOString(),
-        results,
-        duplicatesRemoved: duplicatesRemoved > 0 ? duplicatesRemoved : undefined,
-    };
-}
-async function presentSearchSuccess(details, params) {
-    const duplicateNotice = details.duplicatesRemoved !== undefined
-        ? `\n\nDuplicate URLs removed: ${details.duplicatesRemoved}.`
-        : "";
-    const result = await finalizeAgentBrowserNativeResult({
-        content: [
-            {
-                type: "text",
-                text: `${formatSearchResults(details.provider, details.returnedQuery, details.results)}${duplicateNotice}`,
-            },
-        ],
-        details: { data: details },
-    }, params);
-    // Keep the finalized spill receipt while flattening the documented search details shape.
-    const finalizedManifest = result.details.artifactManifest;
-    return finalizedManifest === undefined
-        ? { ...result, details }
-        : { ...result, details: { ...details, artifactManifest: finalizedManifest } };
-}
-function failureCategory(error, signal) {
-    if (signal?.aborted === true) {
-        return "aborted";
-    }
-    return error instanceof WebSearchLocalError ? "validation-error" : "upstream-error";
-}
-export function createAgentBrowserWebSearchTool(configState, options = {}) {
-    const requestGate = new WebSearchRequestGate();
-    return {
-        name: AGENT_BROWSER_WEB_SEARCH_TOOL_NAME,
-        namespace: AGENT_BROWSER_NAMESPACE,
-        outputSchema: AGENT_BROWSER_OUTPUT_SCHEMA,
-        label: "Agent Browser Web Search",
-        description: `Search the live web with Exa or Brave for current or external information. For Exa research tasks, use searchType deep-lite or deeper. Returns up to ${MAX_SEARCH_RESULT_COUNT} concise web results.`,
-        promptSnippet: "Search the live web with Exa or Brave for current or external information.",
-        parameters: AgentBrowserWebSearchParams,
-        async execute(_toolCallId, params, signal, _onUpdate, ctx) {
-            try {
-                const state = ctx ? (options.loadConfigState?.(ctx) ?? configState) : configState;
-                const details = await runWebSearch(state, params, requestGate, signal);
-                return await presentSearchSuccess(details, params);
-            }
-            catch (error) {
-                const message = redactSensitiveText(error instanceof Error ? error.message : "Unknown web search failure").slice(0, 1_000);
-                return finalizeAgentBrowserNativeResult({
-                    content: [{ type: "text", text: message }],
-                    details: {
-                        error: message,
-                        resultCategory: "failure",
-                        failureCategory: failureCategory(error, signal),
-                    },
-                    isError: true,
-                }, params);
-            }
-        },
-    };
-}

package/dist/extensions/agent-browser/lib/webmcp-observation.js

@@ -1,35 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { isRecord } from "./parsing.js";
-const observation = new AsyncLocalStorage();
-export function getNativeWebMcpCatalog(data) {
-    if (Array.isArray(data)) {
-        for (let index = data.length - 1; index >= 0; index -= 1) {
-            const row = data[index];
-            const catalog = getNativeWebMcpCatalog(isRecord(row) ? row.result : undefined);
-            if (catalog) {
-                return catalog;
-            }
-        }
-    }
-    if (!isRecord(data) || !isRecord(data.webmcp)) {
-        return undefined;
-    }
-    return Array.isArray(data.webmcp.tools) || data.webmcp.status === "unavailable"
-        ? data.webmcp
-        : undefined;
-}
-export function observeNativeWebMcp(data) {
-    const current = observation.getStore();
-    if (!current) {
-        return;
-    }
-    const catalog = getNativeWebMcpCatalog(data);
-    if (catalog) {
-        current.catalog = catalog;
-    }
-}
-/** Native discovery is edge-triggered; helper reads must not swallow its updates. */
-export async function collectNativeWebMcp(run) {
-    const current = {};
-    return observation.run(current, async () => ({ result: await run(), catalog: current.catalog }));
-}

package/dist/extensions/agent-browser/lib/windows-stock-launcher.js

@@ -1,96 +0,0 @@
-import { readFileSync, statSync } from "node:fs";
-import { dirname, isAbsolute, join, resolve } from "node:path";
-import { isMainThread } from "node:worker_threads";
-import pathKey from "path-key";
-import which from "which";
-import { isRecord } from "./parsing.js";
-function environmentValues(env, name) {
-    return Object.entries(env)
-        .filter(([key, value]) => key.toUpperCase() === name && value !== undefined)
-        .map(([, value]) => value);
-}
-function hasStockEnvironment(env) {
-    const paths = environmentValues(env, "PATH");
-    const extensions = environmentValues(env, "PATHEXT");
-    return (paths.length === 1 &&
-        paths.at(0) !== undefined &&
-        paths.at(0) !== "" &&
-        extensions.length === 1 &&
-        extensions.at(0) === process.env.PATHEXT &&
-        environmentValues(env, "NODEFAULTCURRENTDIRECTORYINEXEPATH").length === 0);
-}
-function hasNativeCommandShell() {
-    const { comspec, SystemRoot } = process.env;
-    if (comspec === undefined ||
-        comspec.length === 0 ||
-        !isAbsolute(comspec) ||
-        SystemRoot === undefined ||
-        SystemRoot.length === 0) {
-        return false;
-    }
-    try {
-        const shell = statSync(comspec, { bigint: true });
-        const native = statSync(join(SystemRoot, "System32", "cmd.exe"), { bigint: true });
-        return shell.dev === native.dev && shell.ino === native.ino;
-    }
-    catch {
-        return false;
-    }
-}
-function selectLauncher(cwd, env) {
-    const previousCwd = process.cwd();
-    try {
-        // which 2 has no cwd option; synchronous resolution matches cross-spawn's child cwd.
-        process.chdir(cwd);
-        return which.sync("agent-browser", { path: env[pathKey({ env })], nothrow: true });
-    }
-    catch {
-        return undefined;
-    }
-    finally {
-        process.chdir(previousCwd);
-    }
-}
-function stockLauncherBinary(absoluteShim) {
-    try {
-        if (statSync(absoluteShim).size > 512) {
-            return undefined;
-        }
-        const text = readFileSync(absoluteShim, "utf8");
-        if (!/^@ECHO off\r?\n"%~dp0node_modules\\agent-browser\\bin\\agent-browser-win32-x64\.exe" %\*(?:\r?\n)?(?![\s\S])/.test(text)) {
-            return undefined;
-        }
-        const packageRoot = join(dirname(absoluteShim), "node_modules", "agent-browser");
-        const manifest = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
-        if (!isRecord(manifest) || manifest.name !== "agent-browser" || !isRecord(manifest.bin)) {
-            return undefined;
-        }
-        const entrypoint = manifest.bin["agent-browser"];
-        if (entrypoint !== "bin/agent-browser.js" && entrypoint !== "./bin/agent-browser.js") {
-            return undefined;
-        }
-        const binary = join(packageRoot, "bin", "agent-browser-win32-x64.exe");
-        return statSync(binary).isFile() ? binary : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/** Bypass only upstream's optimized npm CMD shim: cmd.exe loses literal CR/LF.
- * Keep which/path-key aligned with cross-spawn's public dependency versions.
- * Unknown/custom launchers stay on cross-spawn.
- */
-export function resolveWindowsStockLauncher(cwd, env) {
-    if (process.platform !== "win32" ||
-        !isMainThread ||
-        !hasStockEnvironment(env) ||
-        !hasNativeCommandShell()) {
-        return undefined;
-    }
-    const selected = selectLauncher(cwd, env);
-    // cross-spawn's extensionless lookup cannot select this CMD shim.
-    if (selected === undefined || selected === null || !selected.toLowerCase().endsWith(".cmd")) {
-        return undefined;
-    }
-    return stockLauncherBinary(resolve(cwd, selected));
-}

package/dist/scripts/agent-browser-target.mjs

@@ -1,23 +0,0 @@
-export const TARGET_AGENT_BROWSER_SOURCE = "scripts/agent-browser-target.mjs";
-export const TARGET_AGENT_BROWSER_VERSION = "0.38.1";
-export const TARGET_AGENT_BROWSER_VERSION_LABEL = `agent-browser ${TARGET_AGENT_BROWSER_VERSION}`;
-export const MINIMUM_AGENT_BROWSER_VERSION = "0.35.0";
-export const MINIMUM_AGENT_BROWSER_VERSION_LABEL = `agent-browser ${MINIMUM_AGENT_BROWSER_VERSION}`;
-export const SUPPORTED_AGENT_BROWSER_VERSION_LABEL = `${MINIMUM_AGENT_BROWSER_VERSION_LABEL} or newer`;
-function stableVersionParts(version) {
-    const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.exec(version);
-    return match?.slice(1).map(Number);
-}
-export function isSupportedAgentBrowserVersion(version) {
-    const actual = stableVersionParts(version);
-    const minimum = stableVersionParts(MINIMUM_AGENT_BROWSER_VERSION);
-    if (!actual || !minimum) {
-        return false;
-    }
-    for (let index = 0; index < minimum.length; index += 1) {
-        if (actual[index] !== minimum[index]) {
-            return actual[index] > minimum[index];
-        }
-    }
-    return true;
-}