@xrkseek/harness-cli 0.0.2 → 0.0.3

package/node_modules/@xrkseek/exec-web/dist/search-duckduckgo.js

@@ -0,0 +1,139 @@
+/**
+ * Keyless DuckDuckGo HTML search (ported from XRK-AGT web-search-duckduckgo).
+ * No API key; scrapes https://html.duckduckgo.com/html.
+ */
+import { WebError } from "./types.js";
+const SEARCH_TIMEOUT_MS = 30_000;
+const DDG_HTML_ENDPOINT = "https://html.duckduckgo.com/html";
+const DDG_USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36";
+function capSources(sources, maxResults) {
+    if (sources.length <= maxResults) {
+        return { sources, truncated: false };
+    }
+    return {
+        sources: sources.slice(0, maxResults),
+        truncated: true,
+    };
+}
+function decodeHtmlEntities(text) {
+    return text
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&#x27;/g, "'")
+        .replace(/&#x2F;/g, "/")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&ndash;/g, "-")
+        .replace(/&mdash;/g, "--")
+        .replace(/&hellip;/g, "...")
+        .replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)))
+        .replace(/&#x([0-9a-f]+);/gi, (_, code) => String.fromCodePoint(Number.parseInt(code, 16)));
+}
+function stripHtml(html) {
+    return html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+}
+function decodeDuckDuckGoUrl(rawUrl) {
+    try {
+        const normalized = rawUrl.startsWith("//") ? `https:${rawUrl}` : rawUrl;
+        const parsed = new URL(normalized);
+        const uddg = parsed.searchParams.get("uddg");
+        if (uddg)
+            return uddg;
+    }
+    catch {
+        /* keep original */
+    }
+    return rawUrl;
+}
+function readHrefAttribute(tagAttributes) {
+    return /\bhref="([^"]*)"/i.exec(tagAttributes)?.[1] ?? "";
+}
+function isBotChallenge(html) {
+    if (/class="[^"]*\bresult__a\b[^"]*"/i.test(html))
+        return false;
+    return /g-recaptcha|are you a human|id="challenge-form"|name="challenge"/i.test(html);
+}
+/** Parse DuckDuckGo HTML result page into sources (exported for tests). */
+export function parseDuckDuckGoHtml(html) {
+    const results = [];
+    const resultRegex = /<a\b(?=[^>]*\bclass="[^"]*\bresult__a\b[^"]*")([^>]*)>([\s\S]*?)<\/a>/gi;
+    const nextResultRegex = /<a\b(?=[^>]*\bclass="[^"]*\bresult__a\b[^"]*")[^>]*>/i;
+    const snippetRegex = /<a\b(?=[^>]*\bclass="[^"]*\bresult__snippet\b[^"]*")[^>]*>([\s\S]*?)<\/a>/i;
+    for (const match of html.matchAll(resultRegex)) {
+        const rawAttributes = match[1] ?? "";
+        const rawTitle = match[2] ?? "";
+        const rawUrl = readHrefAttribute(rawAttributes);
+        const matchEnd = (match.index ?? 0) + match[0].length;
+        const trailingHtml = html.slice(matchEnd);
+        const nextResultIndex = trailingHtml.search(nextResultRegex);
+        const scopedTrailingHtml = nextResultIndex >= 0
+            ? trailingHtml.slice(0, nextResultIndex)
+            : trailingHtml;
+        const rawSnippet = snippetRegex.exec(scopedTrailingHtml)?.[1] ?? "";
+        const title = stripHtml(decodeHtmlEntities(rawTitle));
+        const url = decodeDuckDuckGoUrl(decodeHtmlEntities(rawUrl));
+        const snippet = stripHtml(decodeHtmlEntities(rawSnippet));
+        if (title && url) {
+            results.push({
+                url,
+                title,
+                ...(snippet ? { snippet } : {}),
+            });
+        }
+    }
+    return results;
+}
+function translateAbort(err, outer, timed) {
+    if (timed.aborted && !outer?.aborted) {
+        throw new WebError("web search timed out", "WEB_FETCH_TIMEOUT");
+    }
+    if (outer?.aborted || timed.aborted) {
+        throw new WebError("web search aborted", "WEB_ABORTED");
+    }
+    throw new WebError(err instanceof Error ? err.message : String(err), "WEB_PROVIDER_ERROR");
+}
+export function createDuckDuckGoSearch(options) {
+    const fetchFn = options.fetch ?? globalThis.fetch;
+    const timeoutMs = options.timeoutMs ?? SEARCH_TIMEOUT_MS;
+    const region = options.region?.trim() ?? "";
+    return {
+        async search(request, signal) {
+            if (signal?.aborted) {
+                throw new WebError("web search aborted", "WEB_ABORTED");
+            }
+            const timed = AbortSignal.timeout(timeoutMs);
+            const combined = signal ? AbortSignal.any([signal, timed]) : timed;
+            const url = new URL(DDG_HTML_ENDPOINT);
+            url.searchParams.set("q", request.query);
+            if (region)
+                url.searchParams.set("kl", region);
+            url.searchParams.set("kp", "-1"); // moderate safe search
+            let response;
+            try {
+                response = await fetchFn(url.toString(), {
+                    method: "GET",
+                    signal: combined,
+                    headers: {
+                        "User-Agent": DDG_USER_AGENT,
+                        Accept: "text/html",
+                    },
+                });
+            }
+            catch (err) {
+                translateAbort(err, signal, timed);
+            }
+            const html = await response.text();
+            if (!response.ok) {
+                throw new WebError(`DuckDuckGo answered HTTP ${response.status}`, "WEB_PROVIDER_ERROR");
+            }
+            if (isBotChallenge(html)) {
+                throw new WebError("DuckDuckGo returned a bot challenge; try again later or set XRK_TAVILY_API_KEY / XRK_BRAVE_SEARCH_API_KEY", "WEB_PROVIDER_ERROR");
+            }
+            return capSources(parseDuckDuckGoHtml(html), request.maxResults);
+        },
+    };
+}
+//# sourceMappingURL=search-duckduckgo.js.map

package/node_modules/@xrkseek/exec-web/dist/search-duckduckgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-duckduckgo.js","sourceRoot":"","sources":["../src/search-duckduckgo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAC7D,MAAM,cAAc,GAClB,uGAAuG,CAAC;AAE1G,SAAS,UAAU,CACjB,OAAmC,EACnC,UAAkB;IAElB,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QACjC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvC,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACrC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;SACzB,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;SAC3B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CACxC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CACnC;SACA,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAChD,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAChD,CAAC;AACN,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACnE,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,aAAqB;IAC9C,OAAO,mBAAmB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,mEAAmE,CAAC,IAAI,CAC7E,IAAI,CACL,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,WAAW,GACf,yEAAyE,CAAC;IAC5E,MAAM,eAAe,GACnB,uDAAuD,CAAC;IAC1D,MAAM,YAAY,GAChB,4EAA4E,CAAC;IAE/E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC7D,MAAM,kBAAkB,GACtB,eAAe,IAAI,CAAC;YAClB,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;YACxC,CAAC,CAAC,YAAY,CAAC;QACnB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,SAAS,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,SAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1D,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG;gBACH,KAAK;gBACL,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CACrB,GAAY,EACZ,KAA8B,EAC9B,KAAkB;IAElB,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,QAAQ,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,QAAQ,CAChB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAChD,oBAAoB,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAKtC;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5C,OAAO;QACL,KAAK,CAAC,MAAM,CACV,OAAyB,EACzB,MAAoB;YAEpB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACnE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,MAAM;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB;YAEzD,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;oBACvC,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE;wBACP,YAAY,EAAE,cAAc;wBAC5B,MAAM,EAAE,WAAW;qBACpB;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,QAAQ,CAChB,4BAA4B,QAAQ,CAAC,MAAM,EAAE,EAC7C,oBAAoB,CACrB,CAAC;YACJ,CAAC;YACD,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,QAAQ,CAChB,2GAA2G,EAC3G,oBAAoB,CACrB,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/exec-web/dist/search-mcp-client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Minimal streamable-HTTP MCP client for Parallel Search free endpoint.
+ * Ported (slimmed) from XRK-AGT web-search-mcp-client — no SDK dependency.
+ */
+import type { FetchFn } from "./types.js";
+export declare function iterMcpMessages(text: string): Record<string, unknown>[];
+export declare function selectMcpEnvelope(text: string, requestId: string): Record<string, unknown>;
+export declare function extractMcpToolPayload(envelope: Record<string, unknown>): Record<string, unknown>;
+/**
+ * MCP initialize → notifications/initialized → tools/call.
+ */
+export declare function callMcpTool(params: {
+    readonly url: string;
+    readonly toolName: string;
+    readonly toolArgs: Record<string, unknown>;
+    readonly fetch?: FetchFn;
+    readonly signal?: AbortSignal;
+    readonly clientName?: string;
+    readonly clientVersion?: string;
+}): Promise<Record<string, unknown>>;
+//# sourceMappingURL=search-mcp-client.d.ts.map

package/node_modules/@xrkseek/exec-web/dist/search-mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-mcp-client.d.ts","sourceRoot":"","sources":["../src/search-mcp-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAS1C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CA4CvE;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB;AAuCD;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4DnC"}

package/node_modules/@xrkseek/exec-web/dist/search-mcp-client.js

@@ -0,0 +1,175 @@
+/**
+ * Minimal streamable-HTTP MCP client for Parallel Search free endpoint.
+ * Ported (slimmed) from XRK-AGT web-search-mcp-client — no SDK dependency.
+ */
+import { randomUUID } from "node:crypto";
+import { WebError } from "./types.js";
+const MCP_PROTOCOL_VERSION = "2025-06-18";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function iterMcpMessages(text) {
+    const out = [];
+    const emit = (payload) => {
+        if (Array.isArray(payload)) {
+            for (const entry of payload) {
+                if (isRecord(entry))
+                    out.push(entry);
+            }
+        }
+        else if (isRecord(payload)) {
+            out.push(payload);
+        }
+    };
+    const body = text.trim();
+    if (!body)
+        return out;
+    if (body.startsWith("{") || body.startsWith("[")) {
+        try {
+            emit(JSON.parse(body));
+        }
+        catch {
+            /* non-json */
+        }
+        return out;
+    }
+    let dataLines = [];
+    const flush = () => {
+        if (dataLines.length === 0)
+            return;
+        try {
+            emit(JSON.parse(dataLines.join("\n")));
+        }
+        catch {
+            /* skip */
+        }
+        dataLines = [];
+    };
+    for (const raw of body.split("\n")) {
+        const line = raw.replace(/\r$/, "");
+        if (line.startsWith("data:")) {
+            dataLines.push(line.slice("data:".length).replace(/^ /, ""));
+        }
+        else if (line.trim() === "") {
+            flush();
+        }
+    }
+    flush();
+    return out;
+}
+export function selectMcpEnvelope(text, requestId) {
+    let fallback = {};
+    for (const msg of iterMcpMessages(text)) {
+        if (!("result" in msg || "error" in msg))
+            continue;
+        if (msg.id === requestId)
+            return msg;
+        fallback = msg;
+    }
+    return fallback;
+}
+export function extractMcpToolPayload(envelope) {
+    if ("error" in envelope) {
+        throw new WebError(`MCP error: ${JSON.stringify(envelope.error).slice(0, 500)}`, "WEB_PROVIDER_ERROR");
+    }
+    const result = isRecord(envelope.result) ? envelope.result : {};
+    if (result.isError) {
+        throw new WebError(`MCP tool error: ${JSON.stringify(result).slice(0, 500)}`, "WEB_PROVIDER_ERROR");
+    }
+    if (isRecord(result.structuredContent))
+        return result.structuredContent;
+    const content = Array.isArray(result.content) ? result.content : [];
+    for (const block of content) {
+        if (isRecord(block) &&
+            block.type === "text" &&
+            typeof block.text === "string" &&
+            block.text) {
+            try {
+                const parsed = JSON.parse(block.text);
+                if (isRecord(parsed))
+                    return parsed;
+            }
+            catch {
+                /* next */
+            }
+        }
+    }
+    throw new WebError(`MCP returned no parseable content: ${JSON.stringify(result).slice(0, 500)}`, "WEB_PROVIDER_ERROR");
+}
+async function postMcp(fetchFn, url, params) {
+    const headers = {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream",
+    };
+    if (params.sessionId)
+        headers["Mcp-Session-Id"] = params.sessionId;
+    if (params.protocolVersion) {
+        headers["MCP-Protocol-Version"] = params.protocolVersion;
+    }
+    const response = await fetchFn(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(params.body),
+        ...(params.signal ? { signal: params.signal } : {}),
+    });
+    return {
+        ok: response.ok,
+        status: response.status,
+        text: await response.text(),
+        sessionIdHeader: response.headers.get("mcp-session-id"),
+    };
+}
+/**
+ * MCP initialize → notifications/initialized → tools/call.
+ */
+export async function callMcpTool(params) {
+    const fetchFn = params.fetch ?? globalThis.fetch;
+    const clientName = params.clientName ?? "xrk-harness";
+    const clientVersion = params.clientVersion ?? "0.0.0";
+    const initId = randomUUID();
+    const init = await postMcp(fetchFn, params.url, {
+        body: {
+            jsonrpc: "2.0",
+            id: initId,
+            method: "initialize",
+            params: {
+                protocolVersion: MCP_PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: clientName, version: clientVersion },
+            },
+        },
+        ...(params.signal ? { signal: params.signal } : {}),
+    });
+    if (!init.ok) {
+        throw new WebError(`MCP initialize failed (${init.status}): ${init.text.slice(0, 300)}`, "WEB_PROVIDER_ERROR");
+    }
+    const sessionId = init.sessionIdHeader ?? undefined;
+    const initEnvelope = selectMcpEnvelope(init.text, initId);
+    const negotiatedVersion = (isRecord(initEnvelope.result) &&
+        typeof initEnvelope.result.protocolVersion === "string"
+        ? initEnvelope.result.protocolVersion
+        : undefined) ?? MCP_PROTOCOL_VERSION;
+    await postMcp(fetchFn, params.url, {
+        body: { jsonrpc: "2.0", method: "notifications/initialized" },
+        ...(sessionId ? { sessionId } : {}),
+        protocolVersion: negotiatedVersion,
+        ...(params.signal ? { signal: params.signal } : {}),
+    });
+    const callId = randomUUID();
+    const call = await postMcp(fetchFn, params.url, {
+        body: {
+            jsonrpc: "2.0",
+            id: callId,
+            method: "tools/call",
+            params: { name: params.toolName, arguments: params.toolArgs },
+        },
+        ...(sessionId ? { sessionId } : {}),
+        protocolVersion: negotiatedVersion,
+        ...(params.signal ? { signal: params.signal } : {}),
+    });
+    if (!call.ok) {
+        throw new WebError(`MCP tools/call failed (${call.status}): ${call.text.slice(0, 300)}`, "WEB_PROVIDER_ERROR");
+    }
+    return extractMcpToolPayload(selectMcpEnvelope(call.text, callId));
+}
+//# sourceMappingURL=search-mcp-client.js.map

package/node_modules/@xrkseek/exec-web/dist/search-mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-mcp-client.js","sourceRoot":"","sources":["../src/search-mcp-client.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/exec-web/dist/search-parallel-free.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Parallel Search free MCP (keyless) — aligned with XRK-AGT parallel-free.
+ * Default MCP URL: https://search.parallel.ai/mcp
+ */
+import type { FetchFn, WebSearch } from "./types.js";
+export declare const PARALLEL_MCP_SEARCH_URL = "https://search.parallel.ai/mcp";
+export declare function createParallelFreeSearch(options: {
+    readonly mcpUrl?: string;
+    readonly fetch?: FetchFn;
+    readonly timeoutMs?: number;
+}): WebSearch;
+//# sourceMappingURL=search-parallel-free.d.ts.map

package/node_modules/@xrkseek/exec-web/dist/search-parallel-free.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-parallel-free.d.ts","sourceRoot":"","sources":["../src/search-parallel-free.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EAIV,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAuExE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,CA0CZ"}

package/node_modules/@xrkseek/exec-web/dist/search-parallel-free.js

@@ -0,0 +1,105 @@
+/**
+ * Parallel Search free MCP (keyless) — aligned with XRK-AGT parallel-free.
+ * Default MCP URL: https://search.parallel.ai/mcp
+ */
+import { randomUUID } from "node:crypto";
+import { callMcpTool } from "./search-mcp-client.js";
+import { WebError } from "./types.js";
+export const PARALLEL_MCP_SEARCH_URL = "https://search.parallel.ai/mcp";
+const SEARCH_TIMEOUT_MS = 30_000;
+function asRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function asString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function mapParallelSources(payload) {
+    const rows = Array.isArray(payload.results) ? payload.results : [];
+    const sources = [];
+    for (const row of rows) {
+        const entry = asRecord(row);
+        if (!entry)
+            continue;
+        const url = asString(entry.url);
+        if (!url)
+            continue;
+        const title = asString(entry.title);
+        const excerpts = Array.isArray(entry.excerpts)
+            ? entry.excerpts.filter((e) => typeof e === "string")
+            : [];
+        const snippet = excerpts.join("\n\n") ||
+            asString(entry.snippet) ||
+            asString(entry.description);
+        const publishedAt = asString(entry.publish_date) ?? asString(entry.publishedAt);
+        sources.push({
+            url,
+            ...(title ? { title } : {}),
+            ...(snippet ? { snippet } : {}),
+            ...(publishedAt ? { publishedAt } : {}),
+        });
+    }
+    return sources;
+}
+function capSources(sources, maxResults) {
+    if (sources.length <= maxResults) {
+        return { sources, truncated: false };
+    }
+    return {
+        sources: sources.slice(0, maxResults),
+        truncated: true,
+    };
+}
+function translateAbort(err, outer, timed) {
+    if (timed.aborted && !outer?.aborted) {
+        throw new WebError("web search timed out", "WEB_FETCH_TIMEOUT");
+    }
+    if (outer?.aborted || timed.aborted) {
+        throw new WebError("web search aborted", "WEB_ABORTED");
+    }
+    throw new WebError(err instanceof Error ? err.message : String(err), "WEB_PROVIDER_ERROR");
+}
+export function createParallelFreeSearch(options) {
+    const mcpUrl = options.mcpUrl?.trim() || PARALLEL_MCP_SEARCH_URL;
+    const timeoutMs = options.timeoutMs ?? SEARCH_TIMEOUT_MS;
+    return {
+        async search(request, signal) {
+            if (signal?.aborted) {
+                throw new WebError("web search aborted", "WEB_ABORTED");
+            }
+            const timed = AbortSignal.timeout(timeoutMs);
+            const combined = signal ? AbortSignal.any([signal, timed]) : timed;
+            const query = request.query.trim();
+            if (!query) {
+                throw new WebError("query is required", "WEB_PROVIDER_ERROR");
+            }
+            try {
+                const payload = await callMcpTool({
+                    url: mcpUrl,
+                    toolName: "web_search",
+                    toolArgs: {
+                        objective: query,
+                        search_queries: [query],
+                        session_id: randomUUID(),
+                    },
+                    ...(options.fetch ? { fetch: options.fetch } : {}),
+                    signal: combined,
+                    clientName: "xrk-harness-parallel-free",
+                });
+                return capSources(mapParallelSources(payload), request.maxResults);
+            }
+            catch (err) {
+                if (err instanceof WebError) {
+                    if (timed.aborted && !signal?.aborted) {
+                        throw new WebError("web search timed out", "WEB_FETCH_TIMEOUT");
+                    }
+                    throw err;
+                }
+                translateAbort(err, signal, timed);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-parallel-free.js.map

package/node_modules/@xrkseek/exec-web/dist/search-parallel-free.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-parallel-free.js","sourceRoot":"","sources":["../src/search-parallel-free.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/exec-web/dist/search-providers.d.ts

@@ -1,6 +1,8 @@
 import type { FetchFn, WebSearch, WebSearchResult } from "./types.js";
 export declare const SEARCH_TIMEOUT_MS = 30000;
-export type SearchProviderId = "tavily" | "brave";
+/** AGT-aligned keyless cascade order. */
+export declare const KEYLESS_FALLBACKS: readonly ["parallel-free", "duckduckgo"];
+export type SearchProviderId = "tavily" | "brave" | "parallel-free" | "duckduckgo";
 export declare function capSearchResult(result: WebSearchResult, maxResults: number): WebSearchResult;
 export declare function createTavilySearch(options: {
     readonly apiKey: string;
@@ -13,7 +15,13 @@ export declare function createBraveSearch(options: {
     readonly timeoutMs?: number;
 }): WebSearch;
 export declare function searchUnavailableMessage(env: NodeJS.ProcessEnv): string;
+/**
+ * Prefer keyed providers when present; otherwise parallel-free (AGT).
+ * Unknown `XRK_WEB_SEARCH_PROVIDER` → `undefined` (caller shows unavailable).
+ */
 export declare function resolveSearchProviderId(env: NodeJS.ProcessEnv): SearchProviderId | undefined;
+/** Try primary; on throw or empty sources, walk remaining keyless providers (AGT). */
+export declare function createCascadingSearch(primary: WebSearch, fallbacks: readonly WebSearch[]): WebSearch;
 export declare function createSearchFromEnv(options: {
     readonly env?: NodeJS.ProcessEnv;
     readonly fetch?: FetchFn;

package/node_modules/@xrkseek/exec-web/dist/search-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-providers.d.ts","sourceRoot":"","sources":["../src/search-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EAET,eAAe,EAEhB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,CAAC;AA+BlD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GACjB,eAAe,CAOjB;AA0DD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,CA2CZ;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,CAmCZ;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAYvE;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,gBAAgB,GAAG,SAAS,CAU9B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,SAAS,GAAG,SAAS,CAgBxB"}
+{"version":3,"file":"search-providers.d.ts","sourceRoot":"","sources":["../src/search-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EAET,eAAe,EAEhB,MAAM,YAAY,CAAC;AAKpB,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAExC,yCAAyC;AACzC,eAAO,MAAM,iBAAiB,0CAA2C,CAAC;AAE1E,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,OAAO,GACP,eAAe,GACf,YAAY,CAAC;AA+BjB,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GACjB,eAAe,CAOjB;AA0DD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,CA2CZ;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,SAAS,CAmCZ;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAkBvE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,gBAAgB,GAAG,SAAS,CAY9B;AAuCD,sFAAsF;AACtF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,SAAS,SAAS,EAAE,GAC9B,SAAS,CA4BX;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,SAAS,GAAG,SAAS,CAkBxB"}