@taurgis/bonsai 1.0.5 → 3.0.0

package/dist/lib/research/docs/discovery-index.d.ts

@@ -1,14 +0,0 @@
-import type { DocsSearchResult } from './search-index.js';
-interface DiscoveryEntry {
-    title: string;
-    url: string;
-    body?: string;
-}
-export interface SitemapParseResult {
-    entries: DiscoveryEntry[];
-    sitemapUrls: string[];
-}
-export declare function parseSitemap(body: string): SitemapParseResult;
-export declare function searchSitemap(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export declare function searchLlmsTxt(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export {};

package/dist/lib/research/docs/discovery-index.js

@@ -1,112 +0,0 @@
-import { DOMParser } from 'linkedom';
-function queryTerms(query) {
-    return query.toLowerCase().split(/\s+/).filter(Boolean);
-}
-function scoreEntry(entry, terms) {
-    const haystack = `${entry.title} ${entry.url} ${entry.body ?? ''}`.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-        if (entry.title.toLowerCase().includes(term))
-            score += 10;
-        if (entry.url.toLowerCase().includes(term))
-            score += 5;
-        score += Math.min(haystack.split(term).length - 1, 5);
-    }
-    return score;
-}
-function snippetFrom(entry) {
-    return (entry.body || entry.url).replace(/\s+/g, ' ').trim().slice(0, 150);
-}
-function titleFromUrl(url) {
-    try {
-        const parsed = new URL(url);
-        const last = parsed.pathname.split('/').filter(Boolean).pop();
-        return last ? last.replace(/\.[a-z0-9]+$/i, '').replace(/[-_]+/g, ' ') : parsed.hostname;
-    }
-    catch {
-        return url;
-    }
-}
-function toResults(entries, indexUrl, provider, query) {
-    const terms = queryTerms(query);
-    return entries
-        .map((entry) => ({ entry, score: scoreEntry(entry, terms) }))
-        .filter(({ score }) => score > 0)
-        .map(({ entry, score }) => ({
-        title: entry.title,
-        url: entry.url,
-        snippet: snippetFrom(entry),
-        provider,
-        score,
-        indexUrl,
-    }))
-        .sort((a, b) => b.score - a.score);
-}
-function textContent(element) {
-    const text = element?.textContent?.trim();
-    return text || undefined;
-}
-export function parseSitemap(body) {
-    const trimmed = body.trim();
-    if (!trimmed)
-        return { entries: [], sitemapUrls: [] };
-    if (!trimmed.startsWith('<')) {
-        const entries = trimmed
-            .split(/\r?\n/)
-            .map((line) => line.trim())
-            .filter((line) => /^https?:\/\//i.test(line))
-            .map((url) => ({ title: titleFromUrl(url), url }));
-        return { entries, sitemapUrls: [] };
-    }
-    const doc = new DOMParser().parseFromString(trimmed, 'text/xml');
-    const sitemapUrls = Array.from(doc.querySelectorAll('sitemap > loc'))
-        .map((loc) => textContent(loc))
-        .filter((url) => !!url);
-    const entries = Array.from(doc.querySelectorAll('url'))
-        .map((urlElement) => {
-        const url = textContent(urlElement.querySelector('loc'));
-        if (!url)
-            return null;
-        const lastmod = textContent(urlElement.querySelector('lastmod'));
-        return { title: titleFromUrl(url), url, body: lastmod ? `Last modified ${lastmod}` : '' };
-    })
-        .filter((entry) => !!entry);
-    return { entries, sitemapUrls };
-}
-export function searchSitemap(body, indexUrl, query) {
-    return toResults(parseSitemap(body).entries, indexUrl, 'sitemap', query);
-}
-function referenceDefinitions(body) {
-    const refs = new Map();
-    for (const match of body.matchAll(/^\s*\[([^\]]+)\]:\s*(\S+)/gm)) {
-        refs.set(match[1].toLowerCase(), match[2]);
-    }
-    return refs;
-}
-export function searchLlmsTxt(body, indexUrl, query) {
-    const refs = referenceDefinitions(body);
-    const entries = [];
-    let section = '';
-    for (const line of body.split(/\r?\n/)) {
-        const heading = line.match(/^##\s+(.+?)\s*$/);
-        if (heading)
-            section = heading[1];
-        const inline = line.match(/^\s*[-*]\s+\[([^\]]+)\]\(([^)]+)\)\s*:?\s*(.*)$/);
-        const ref = line.match(/^\s*[-*]\s+\[([^\]]+)\]\s*:?\s*(.*)$/);
-        const title = inline?.[1] ?? ref?.[1];
-        const url = inline?.[2] ?? (title ? refs.get(title.toLowerCase()) : undefined);
-        if (!title || !url)
-            continue;
-        try {
-            entries.push({
-                title,
-                url: new URL(url, indexUrl).toString(),
-                body: [section, inline?.[3] ?? ref?.[2]].filter(Boolean).join(' - '),
-            });
-        }
-        catch {
-            // Ignore malformed links in untrusted machine-readable text.
-        }
-    }
-    return toResults(entries, indexUrl, 'llms.txt', query);
-}

package/dist/lib/research/docs/remote-search-runner.d.ts

@@ -1,21 +0,0 @@
-import type { DocsSearchResult } from './search-index.js';
-export interface RemoteSearchDeps {
-    fetchStatic: (url: string) => Promise<{
-        content: string;
-        finalUrl: string;
-    }>;
-    fetchText: (url: string) => Promise<{
-        content: string;
-        status: number;
-    }>;
-    postJson: (url: string, body: unknown, headers: Record<string, string>) => Promise<string>;
-}
-export interface RemoteSearchOutcome {
-    provider: string;
-    results: DocsSearchResult[];
-}
-/**
- * Runs remote docs search for a documentation site. Detects the provider from the page, queries the
- * matching connector, and returns normalized results. Throws when no verified connector applies.
- */
-export declare function runRemoteDocsSearch(docsUrl: string, query: string, deps: RemoteSearchDeps): Promise<RemoteSearchOutcome>;

package/dist/lib/research/docs/remote-search-runner.js

@@ -1,114 +0,0 @@
-import { detectDocsEngine } from './detect.js';
-import { probeLlmsTxt } from './machine-readable.js';
-import { searchMkDocsIndex, searchJekyllIndex, searchSphinxIndex } from './search-index.js';
-import { parseSitemap, searchLlmsTxt, searchSitemap } from './discovery-index.js';
-import { extractAlgoliaConfig, algoliaQueryUrl, parseAlgoliaResponse } from './remote-search.js';
-async function getText(url, deps) {
-    const res = await deps.fetchText(url);
-    if (res.status === 304 || !res.content)
-        throw new Error(`empty search index at ${url}`);
-    return res.content;
-}
-function sameHost(url, base) {
-    try {
-        return new URL(url).hostname === new URL(base).hostname;
-    }
-    catch {
-        return false;
-    }
-}
-// Conventional static index path + parser per framework (verified by T-25 fixtures).
-async function staticIndexSearch(framework, origin, query, deps) {
-    if (framework === 'mkdocs' || framework === 'material-mkdocs') {
-        const indexUrl = `${origin}/search/search_index.json`;
-        return {
-            provider: 'mkdocs-local',
-            results: searchMkDocsIndex(await getText(indexUrl, deps), indexUrl, query),
-        };
-    }
-    if (framework === 'sphinx') {
-        const indexUrl = `${origin}/searchindex.js`;
-        return {
-            provider: 'sphinx-searchindex',
-            results: searchSphinxIndex(await getText(indexUrl, deps), indexUrl, query),
-        };
-    }
-    if (framework === 'just-the-docs') {
-        const indexUrl = `${origin}/assets/js/search-data.json`;
-        return {
-            provider: 'jekyll-json',
-            results: searchJekyllIndex(await getText(indexUrl, deps), indexUrl, query),
-        };
-    }
-    return null;
-}
-async function llmsTxtSearch(docsUrl, caps, query, deps) {
-    const llms = await probeLlmsTxt(docsUrl, caps, async (url) => {
-        const res = await deps.fetchText(url);
-        return { ...res, finalUrl: url, contentType: 'text/plain' };
-    });
-    if (!llms)
-        return null;
-    return {
-        provider: llms.artifact.type,
-        results: searchLlmsTxt(llms.body, llms.artifact.url, query),
-    };
-}
-async function sitemapSearch(pageUrl, query, deps) {
-    const origin = new URL(pageUrl).origin;
-    const firstSegment = new URL(pageUrl).pathname.split('/').filter(Boolean)[0];
-    const candidates = [
-        `${origin}/sitemap.xml`,
-        `${origin}/sitemap_index.xml`,
-        firstSegment ? `${origin}/${firstSegment}/sitemap.xml` : undefined,
-    ].filter((url) => !!url);
-    for (const sitemapUrl of [...new Set(candidates)]) {
-        try {
-            const body = await getText(sitemapUrl, deps);
-            const results = searchSitemap(body, sitemapUrl, query);
-            if (results.length > 0)
-                return { provider: 'sitemap', results };
-            const index = parseSitemap(body);
-            const childResults = [];
-            for (const childUrl of index.sitemapUrls.slice(0, 10)) {
-                if (!sameHost(childUrl, pageUrl))
-                    continue;
-                const childBody = await getText(childUrl, deps);
-                childResults.push(...searchSitemap(childBody, childUrl, query));
-            }
-            if (childResults.length > 0) {
-                return { provider: 'sitemap', results: childResults.sort((a, b) => b.score - a.score) };
-            }
-        }
-        catch {
-            // Try the next conventional sitemap location.
-        }
-    }
-    return null;
-}
-/**
- * Runs remote docs search for a documentation site. Detects the provider from the page, queries the
- * matching connector, and returns normalized results. Throws when no verified connector applies.
- */
-export async function runRemoteDocsSearch(docsUrl, query, deps) {
-    const page = await deps.fetchStatic(docsUrl);
-    const origin = new URL(page.finalUrl).origin;
-    const algolia = extractAlgoliaConfig(page.content);
-    if (algolia) {
-        const url = algoliaQueryUrl(algolia);
-        const body = await deps.postJson(url, { params: `query=${encodeURIComponent(query)}` }, { 'X-Algolia-API-Key': algolia.apiKey, 'X-Algolia-Application-Id': algolia.appId });
-        return { provider: 'algolia-docsearch', results: parseAlgoliaResponse(body, url) };
-    }
-    const caps = detectDocsEngine(page.content, page.finalUrl);
-    const staticResult = await staticIndexSearch(caps.framework, origin, query, deps);
-    if (staticResult)
-        return staticResult;
-    const llmsResult = await llmsTxtSearch(page.finalUrl, caps, query, deps);
-    if (llmsResult)
-        return llmsResult;
-    const sitemapResult = await sitemapSearch(page.finalUrl, query, deps);
-    if (sitemapResult)
-        return sitemapResult;
-    throw new Error(`No verified remote search connector for this site (detected: ${caps.framework ?? caps.docsEngine ?? 'unknown'}). ` +
-        'Supported: Algolia DocSearch, MkDocs/Material, Sphinx, Just the Docs, llms.txt, sitemap.xml.');
-}

package/dist/lib/research/docs/remote-search.d.ts

@@ -1,14 +0,0 @@
-import type { DocsSearchResult } from './search-index.js';
-export interface AlgoliaConfig {
-    appId: string;
-    apiKey: string;
-    indexName: string;
-}
-export declare function extractAlgoliaConfig(html: string): AlgoliaConfig | null;
-export declare function algoliaQueryUrl(config: AlgoliaConfig): string;
-export declare function parseAlgoliaResponse(body: string, indexUrl: string): DocsSearchResult[];
-/**
- * Parses a VitePress local search index (MiniSearch documents) and ranks docs by query term hits.
- * `base` is the docs site origin/base used to resolve the relative `id` routes.
- */
-export declare function searchVitePressLocalIndex(body: string, indexUrl: string, base: string, query: string): DocsSearchResult[];

package/dist/lib/research/docs/remote-search.js

@@ -1,101 +0,0 @@
-// Algolia identifiers extracted from untrusted page HTML are interpolated into the request URL, so
-// they MUST be format-validated to prevent SSRF (an unvalidated appId like "evil.com/x" would point
-// the request at an attacker host). App IDs are uppercase alphanumeric; public search keys are hex;
-// the index name must contain no slash (it is path-encoded but we still reject separators).
-const ALGOLIA_APP_ID_RE = /^[A-Z0-9]{6,24}$/;
-const ALGOLIA_API_KEY_RE = /^[a-f0-9]{16,64}$/;
-const ALGOLIA_INDEX_RE = /^[A-Za-z0-9._~-]{1,128}$/;
-// Pulls a DocSearch config out of embedded site data. Returns null unless all three fields are
-// present AND well-formed — a partial or malformed signal is not enough to query.
-export function extractAlgoliaConfig(html) {
-    const text = html.replace(/\\"/g, '"');
-    const appId = text.match(/"appId"\s*:\s*"([^"]+)"/)?.[1];
-    const apiKey = text.match(/"apiKey"\s*:\s*"([^"]+)"/)?.[1];
-    const indexName = text.match(/"indexName"\s*:\s*"([^"]+)"/)?.[1];
-    if (!appId || !apiKey || !indexName)
-        return null;
-    if (!ALGOLIA_APP_ID_RE.test(appId) ||
-        !ALGOLIA_API_KEY_RE.test(apiKey) ||
-        !ALGOLIA_INDEX_RE.test(indexName)) {
-        return null;
-    }
-    return { appId, apiKey, indexName };
-}
-export function algoliaQueryUrl(config) {
-    return `https://${config.appId}-dsn.algolia.net/1/indexes/${encodeURIComponent(config.indexName)}/query`;
-}
-// DocSearch records nest the page hierarchy under `hierarchy` and the page URL under `url`.
-function algoliaTitle(hit) {
-    const h = hit?.hierarchy ?? {};
-    // Prefer the deepest (most specific) hierarchy level present.
-    for (const level of ['lvl6', 'lvl5', 'lvl4', 'lvl3', 'lvl2', 'lvl1', 'lvl0']) {
-        if (h[level])
-            return String(h[level]);
-    }
-    return hit?.url ?? 'Untitled';
-}
-export function parseAlgoliaResponse(body, indexUrl) {
-    const data = JSON.parse(body);
-    if (!Array.isArray(data.hits))
-        throw new Error('Algolia response missing "hits"');
-    return data.hits
-        .filter((hit) => typeof hit?.url === 'string')
-        .map((hit, i) => ({
-        title: algoliaTitle(hit),
-        url: hit.url,
-        snippet: hit?.content ?? undefined,
-        provider: 'algolia-docsearch',
-        score: data.hits.length - i, // preserve Algolia's relevance order
-        indexUrl,
-    }));
-}
-function vitepressUrl(base, id) {
-    try {
-        return new URL(id, base).toString();
-    }
-    catch {
-        return null;
-    }
-}
-// Ranks one VitePress doc by query term hits: a title match weighs 10×, body occurrences 1× each
-// (capped at 5). Kept separate so the search loop stays a flat filter → score → format.
-function scoreVitePressDoc(doc, terms) {
-    const haystack = `${doc.title ?? ''} ${(doc.titles ?? []).join(' ')} ${doc.text ?? ''}`.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-        if ((doc.title ?? '').toLowerCase().includes(term))
-            score += 10;
-        score += Math.min(haystack.split(term).length - 1, 5);
-    }
-    return score;
-}
-/**
- * Parses a VitePress local search index (MiniSearch documents) and ranks docs by query term hits.
- * `base` is the docs site origin/base used to resolve the relative `id` routes.
- */
-export function searchVitePressLocalIndex(body, indexUrl, base, query) {
-    const docs = JSON.parse(body);
-    if (!Array.isArray(docs))
-        throw new Error('VitePress local index is not an array');
-    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
-    const results = [];
-    for (const doc of docs) {
-        if (!doc.id)
-            continue;
-        const score = scoreVitePressDoc(doc, terms);
-        if (score <= 0)
-            continue;
-        const url = vitepressUrl(base, doc.id);
-        if (!url)
-            continue;
-        results.push({
-            title: doc.title ?? doc.id,
-            url,
-            snippet: (doc.text ?? '').slice(0, 150),
-            provider: 'vitepress-local',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}

package/dist/lib/research/docs/search-index.d.ts

@@ -1,13 +0,0 @@
-import type { SearchProvider } from './capabilities.js';
-export interface DocsSearchResult {
-    title: string;
-    url: string;
-    anchor?: string;
-    snippet?: string;
-    provider: SearchProvider;
-    score: number;
-    indexUrl: string;
-}
-export declare function searchMkDocsIndex(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export declare function searchJekyllIndex(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export declare function searchSphinxIndex(js: string, indexUrl: string, query: string): DocsSearchResult[];

package/dist/lib/research/docs/search-index.js

@@ -1,176 +0,0 @@
-function queryTerms(query) {
-    return query.toLowerCase().split(/\s+/).filter(Boolean);
-}
-// Score = title term hits (heavy) + body term hits (light). Zero means no match (dropped).
-function scoreText(title, body, terms) {
-    const t = title.toLowerCase();
-    const b = body.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-        if (t.includes(term))
-            score += 10;
-        const bodyHits = b.split(term).length - 1;
-        score += Math.min(bodyHits, 5);
-    }
-    return score;
-}
-function snippetFrom(text, terms) {
-    const lower = text.toLowerCase();
-    let idx = 0;
-    for (const term of terms) {
-        const found = lower.indexOf(term);
-        if (found !== -1) {
-            idx = found;
-            break;
-        }
-    }
-    const start = Math.max(0, idx - 40);
-    return text
-        .slice(start, start + 150)
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-function splitAnchor(location) {
-    const hashIdx = location.indexOf('#');
-    if (hashIdx === -1)
-        return { path: location };
-    return { path: location.slice(0, hashIdx), anchor: location.slice(hashIdx + 1) || undefined };
-}
-function resolve(base, relative) {
-    try {
-        return new URL(relative, base).toString();
-    }
-    catch {
-        return null;
-    }
-}
-// MkDocs / Material for MkDocs: { docs: [ { location: "page/#anchor", title, text } ] }.
-// Locations are relative to the site root (the index sits at <root>/search/search_index.json).
-export function searchMkDocsIndex(body, indexUrl, query) {
-    const data = JSON.parse(body);
-    if (!Array.isArray(data.docs))
-        throw new Error('MkDocs index missing "docs" array');
-    const root = resolve(indexUrl, '../') ?? indexUrl;
-    const terms = queryTerms(query);
-    const results = [];
-    for (const doc of data.docs) {
-        if (!doc.location && doc.location !== '')
-            continue;
-        const { path, anchor } = splitAnchor(doc.location ?? '');
-        const url = resolve(root, path);
-        if (!url)
-            continue;
-        const score = scoreText(doc.title ?? '', doc.text ?? '', terms);
-        if (score <= 0)
-            continue;
-        results.push({
-            title: doc.title ?? path,
-            url,
-            anchor,
-            snippet: snippetFrom(doc.text ?? '', terms),
-            provider: 'mkdocs-local',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}
-// Just the Docs: { "0": { title, content, url|relUrl }, "1": {...} } keyed by stringified ints.
-export function searchJekyllIndex(body, indexUrl, query) {
-    const data = JSON.parse(body);
-    if (typeof data !== 'object' || data === null)
-        throw new Error('Jekyll index is not an object');
-    const terms = queryTerms(query);
-    const results = [];
-    for (const entry of Object.values(data)) {
-        const rel = entry.url ?? entry.relUrl;
-        if (!rel)
-            continue;
-        const { path, anchor } = splitAnchor(rel);
-        const url = resolve(indexUrl, path);
-        if (!url)
-            continue;
-        const score = scoreText(entry.title ?? '', entry.content ?? '', terms);
-        if (score <= 0)
-            continue;
-        results.push({
-            title: entry.title ?? path,
-            url,
-            anchor,
-            snippet: snippetFrom(entry.content ?? '', terms),
-            provider: 'jekyll-json',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}
-// Extracts the object literal from `Search.setIndex({...})` as inert data and JSON.parses it —
-// never eval. Anchors on the `setIndex(` call so leading comments/whitespace can't shift the slice;
-// falls back to first-`{`/last-`}` for index variants that assign the object differently.
-function parseSphinxObject(js) {
-    const call = js.indexOf('setIndex(');
-    const start = call !== -1 ? js.indexOf('{', call) : js.indexOf('{');
-    const end = js.lastIndexOf('}');
-    if (start === -1 || end <= start)
-        throw new Error('Sphinx index has no object literal');
-    return JSON.parse(js.slice(start, end + 1));
-}
-function collectDocIndices(map, terms) {
-    const hits = new Map();
-    if (!map)
-        return hits;
-    for (const [word, posting] of Object.entries(map)) {
-        const lower = word.toLowerCase();
-        if (!terms.some((t) => lower.includes(t)))
-            continue;
-        const docs = Array.isArray(posting) ? posting : [posting];
-        for (const d of docs)
-            hits.set(d, (hits.get(d) ?? 0) + 1);
-    }
-    return hits;
-}
-// Scores each Sphinx doc index by term hits: title-term hits and exact title matches weigh 10×,
-// body-term hits 1×. Kept separate so the search function stays a flat parse → score → format.
-function scoreSphinxDocs(index, terms, titles) {
-    const scores = new Map();
-    for (const [doc, count] of collectDocIndices(index.titleterms, terms)) {
-        scores.set(doc, (scores.get(doc) ?? 0) + count * 10);
-    }
-    for (const [doc, count] of collectDocIndices(index.terms, terms)) {
-        scores.set(doc, (scores.get(doc) ?? 0) + count);
-    }
-    for (let i = 0; i < titles.length; i++) {
-        if (terms.some((t) => (titles[i] ?? '').toLowerCase().includes(t))) {
-            scores.set(i, (scores.get(i) ?? 0) + 10);
-        }
-    }
-    return scores;
-}
-// Sphinx searchindex.js. Page URLs are docname + ".html" relative to the index's directory.
-export function searchSphinxIndex(js, indexUrl, query) {
-    const index = parseSphinxObject(js);
-    const docnames = index.docnames ?? [];
-    const titles = index.titles ?? [];
-    if (docnames.length === 0)
-        throw new Error('Sphinx index has no docnames');
-    const terms = queryTerms(query);
-    const scores = scoreSphinxDocs(index, terms, titles);
-    const results = [];
-    for (const [doc, score] of scores) {
-        const name = docnames[doc];
-        if (!name || score <= 0)
-            continue;
-        const url = resolve(indexUrl, `${name}.html`);
-        if (!url)
-            continue;
-        results.push({
-            title: titles[doc] ?? name,
-            url,
-            provider: 'sphinx-searchindex',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}

package/dist/sites/salesforce/browser-search.d.ts

@@ -1,7 +0,0 @@
-import type { SiteSearchResult } from '../types.js';
-/**
- * Searches Salesforce Help via Coveo. Reuses a cached token for a direct API call when
- * possible; otherwise drives a headless browser, reads the page's own Coveo search response,
- * and caches the Coveo token (intercepted from the page's Aura call) for the next run.
- */
-export declare function searchSalesforce(query: string, limit?: number): Promise<SiteSearchResult[]>;

package/dist/sites/salesforce/browser-search.js

@@ -1,82 +0,0 @@
-import { openCdpPage, waitForLoad, ResponseCapture } from '../../lib/research/browser.js';
-import { checkDnsSafety } from '../../lib/research/fetcher.js';
-import { buildSearchPageUrl, extractCoveoResults, searchCoveoDirect, COVEO_SEARCH_PATH, AURA_PATH, } from './coveo.js';
-import { loadToken, storeToken, isTokenValid, parseAuraToken } from './token.js';
-const DEFAULT_LIMIT = 10;
-const PAGE_LOAD_TIMEOUT_MS = 15_000;
-const COVEO_WAIT_MS = 30_000;
-const TOKEN_WAIT_MS = 5_000;
-const DEBUG = Boolean(process.env.RESEARCH_DEBUG);
-function dbg(message) {
-    if (DEBUG)
-        console.error(`[salesforce-search] ${message}`);
-}
-// Salesforce gates content behind a OneTrust cookie banner; dismissing it lets the page run.
-const ACCEPT_CONSENT_EXPRESSION = "(() => { const b = document.querySelector('#onetrust-accept-btn-handler'); if (b) b.click(); })()";
-/**
- * Searches Salesforce Help via Coveo. Reuses a cached token for a direct API call when
- * possible; otherwise drives a headless browser, reads the page's own Coveo search response,
- * and caches the Coveo token (intercepted from the page's Aura call) for the next run.
- */
-export async function searchSalesforce(query, limit = DEFAULT_LIMIT) {
-    const cached = loadToken();
-    if (cached && isTokenValid(cached.expiresAtMs)) {
-        dbg('using cached token (direct Coveo call)');
-        const results = extractCoveoResults(await searchCoveoDirect(cached, query, limit), limit);
-        if (results.length)
-            return results;
-        dbg('cached token returned no results; falling back to browser');
-    }
-    return searchViaBrowser(query, limit);
-}
-async function searchViaBrowser(query, limit) {
-    await checkDnsSafety('help.salesforce.com');
-    const page = await openCdpPage();
-    try {
-        // No asset blocking: the search SPA must fully boot to run its query and mint its token.
-        const capture = new ResponseCapture(page, [
-            { key: 'coveo', test: ({ url }) => url.includes(COVEO_SEARCH_PATH) },
-            // help.salesforce.com runs on LWR (no global $A to mint a token ourselves), so we
-            // intercept the page's own Aura token response — the one whose body parses to a token.
-            {
-                key: 'token',
-                test: ({ url }) => url.includes(AURA_PATH),
-                accept: (body) => parseAuraToken(body) !== null,
-            },
-        ]);
-        await page.client.send('Page.navigate', { url: buildSearchPageUrl(query) }, page.sessionId);
-        await waitForLoad(page.client, page.sessionId, PAGE_LOAD_TIMEOUT_MS).catch(() => { });
-        await page.client
-            .send('Runtime.evaluate', { expression: ACCEPT_CONSENT_EXPRESSION }, page.sessionId)
-            .catch(() => { });
-        const coveoBody = await capture.waitFor('coveo', COVEO_WAIT_MS);
-        await cacheToken(capture);
-        if (!coveoBody) {
-            dbg('no Coveo search response captured');
-            return [];
-        }
-        return extractCoveoResults(parseJson(coveoBody), limit);
-    }
-    finally {
-        await page.close();
-    }
-}
-async function cacheToken(capture) {
-    const tokenBody = await capture.waitFor('token', TOKEN_WAIT_MS);
-    const token = tokenBody ? parseAuraToken(tokenBody) : null;
-    if (token) {
-        storeToken(token);
-        dbg('cached Coveo token for next run');
-    }
-    else {
-        dbg('no Aura token response intercepted; next run will use the browser again');
-    }
-}
-function parseJson(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}