@staticn0va/wigolo 0.1.0 → 0.1.1

package/dist/search/searxng.js

@@ -1,87 +1,77 @@
-import { getConfig } from '../config.js';
-import { createLogger } from '../logger.js';
-const log = createLogger('search');
+import { getConfig } from "../config.js";
+import { createLogger } from "../logger.js";
+const log = createLogger("search");
 const CATEGORY_MAP = {
-    general: 'general',
-    news: 'news',
-    code: 'it',
-    docs: 'it',
-    papers: 'science',
-    images: 'images',
+  general: "general",
+  news: "news",
+  code: "it",
+  docs: "general",
+  papers: "science",
+  images: "images"
 };
 function computeTimeRange(fromDate, toDate) {
-    if (!fromDate)
-        return null;
-    const from = new Date(fromDate);
-    if (isNaN(from.getTime()))
-        return null;
-    const now = toDate ? new Date(toDate) : new Date();
-    if (isNaN(now.getTime()))
-        return null;
-    const diffDays = Math.round((now.getTime() - from.getTime()) / (1000 * 60 * 60 * 24));
-    if (diffDays <= 1)
-        return 'day';
-    if (diffDays <= 7)
-        return 'week';
-    if (diffDays <= 30)
-        return 'month';
-    return 'year';
+  if (!fromDate) return null;
+  const from = new Date(fromDate);
+  if (isNaN(from.getTime())) return null;
+  const now = toDate ? new Date(toDate) : /* @__PURE__ */ new Date();
+  if (isNaN(now.getTime())) return null;
+  const diffDays = Math.round((now.getTime() - from.getTime()) / (1e3 * 60 * 60 * 24));
+  if (diffDays <= 1) return "day";
+  if (diffDays <= 7) return "week";
+  if (diffDays <= 30) return "month";
+  return "year";
 }
-export class SearxngClient {
-    baseUrl;
-    name = 'searxng';
-    constructor(baseUrl) {
-        this.baseUrl = baseUrl;
+class SearxngClient {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  baseUrl;
+  name = "searxng";
+  async search(query, options = {}) {
+    const config = getConfig();
+    const timeoutMs = options.timeoutMs ?? config.searxngQueryTimeoutMs;
+    const maxResults = options.maxResults ?? 10;
+    let queryStr = query;
+    if (options.includeDomains?.length) {
+      const siteFilter = options.includeDomains.map((d) => `site:${d}`).join(" OR ");
+      queryStr = options.includeDomains.length === 1 ? `${query} site:${options.includeDomains[0]}` : `${query} (${siteFilter})`;
     }
-    async search(query, options = {}) {
-        const config = getConfig();
-        const timeoutMs = options.timeoutMs ?? config.searxngQueryTimeoutMs;
-        const maxResults = options.maxResults ?? 10;
-        // Build query with domain site: operators
-        let queryStr = query;
-        if (options.includeDomains?.length) {
-            // Best-effort: site: syntax works on Google/Bing but not all SearXNG engines.
-            // Post-filter in filters.ts handles the gap for engines that ignore it.
-            const siteFilter = options.includeDomains.map(d => `site:${d}`).join(' OR ');
-            queryStr = options.includeDomains.length === 1
-                ? `${query} site:${options.includeDomains[0]}`
-                : `${query} (${siteFilter})`;
-        }
-        // exclude_domains are NOT passed to SearXNG — handled by post-filter
-        const params = new URLSearchParams({
-            q: queryStr,
-            format: 'json',
-            pageno: '1',
-        });
-        if (options.timeRange)
-            params.set('time_range', options.timeRange);
-        if (options.language)
-            params.set('language', options.language);
-        // Category pass-through
-        if (options.category) {
-            params.set('categories', CATEGORY_MAP[options.category] ?? 'general');
-        }
-        // Date range -> time_range bucket (SearXNG doesn't support arbitrary dates)
-        if (!options.timeRange && (options.fromDate || options.toDate)) {
-            const range = computeTimeRange(options.fromDate, options.toDate);
-            if (range)
-                params.set('time_range', range);
-        }
-        const url = `${this.baseUrl}/search?${params}`;
-        log.debug('querying searxng', { query: queryStr, url });
-        const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
-        if (!response.ok) {
-            throw new Error(`SearXNG returned ${response.status}`);
-        }
-        const data = (await response.json());
-        const total = data.results.length;
-        return data.results.slice(0, maxResults).map((r, i) => ({
-            title: r.title,
-            url: r.url,
-            snippet: r.content,
-            relevance_score: r.score != null ? Math.min(r.score, 1) : 1 - i / Math.max(total, 1),
-            engine: 'searxng',
-        }));
+    const params = new URLSearchParams({
+      q: queryStr,
+      format: "json",
+      pageno: "1"
+    });
+    if (options.timeRange) params.set("time_range", options.timeRange);
+    if (options.language) params.set("language", options.language);
+    if (options.category) {
+      params.set("categories", CATEGORY_MAP[options.category] ?? "general");
     }
+    if (!options.timeRange && (options.fromDate || options.toDate)) {
+      const range = computeTimeRange(options.fromDate, options.toDate);
+      if (range) params.set("time_range", range);
+    }
+    const url = `${this.baseUrl}/search?${params}`;
+    log.debug("querying searxng", { query: queryStr, url });
+    const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!response.ok) {
+      throw new Error(`SearXNG returned ${response.status}`);
+    }
+    const data = await response.json();
+    const total = data.results.length;
+    return data.results.slice(0, maxResults).map((r, i) => {
+      const published = r.publishedDate ?? r.pubdate ?? void 0;
+      return {
+        title: r.title,
+        url: r.url,
+        snippet: r.content,
+        relevance_score: r.score != null ? Math.min(r.score, 1) : 1 - i / Math.max(total, 1),
+        engine: "searxng",
+        ...published ? { published_date: published } : {}
+      };
+    });
+  }
 }
+export {
+  SearxngClient
+};
 //# sourceMappingURL=searxng.js.map

package/dist/search/searxng.js.map

@@ -1 +1 @@
-{"version":3,"file":"searxng.js","sourceRoot":"","sources":["../../src/search/searxng.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../src/search/searxng.ts"],"sourcesContent":["import type { SearchEngine, SearchEngineOptions, RawSearchResult } from '../types.js';\nimport { getConfig } from '../config.js';\nimport { createLogger } from '../logger.js';\n\nconst log = createLogger('search');\n\n// 'docs' deliberately routes to 'general' instead of SearXNG's 'it' category.\n// SearXNG 'it' returns generic developer docs (MDN, Docker, Stack Overflow, etc.)\n// regardless of the query subject — e.g. \"Next.js authentication\" surfaces\n// MDN WebRTC docs. Domain scoping (include_domains) + reranking handle relevance\n// far better than category narrowing for AI-driven queries.\nconst CATEGORY_MAP: Record<string, string> = {\n  general: 'general',\n  news: 'news',\n  code: 'it',\n  docs: 'general',\n  papers: 'science',\n  images: 'images',\n};\n\nfunction computeTimeRange(fromDate?: string, toDate?: string): string | null {\n  if (!fromDate) return null;\n  const from = new Date(fromDate);\n  if (isNaN(from.getTime())) return null;\n  const now = toDate ? new Date(toDate) : new Date();\n  if (isNaN(now.getTime())) return null;\n  const diffDays = Math.round((now.getTime() - from.getTime()) / (1000 * 60 * 60 * 24));\n  if (diffDays <= 1) return 'day';\n  if (diffDays <= 7) return 'week';\n  if (diffDays <= 30) return 'month';\n  return 'year';\n}\n\ninterface SearxngApiResult {\n  title: string;\n  url: string;\n  content: string;\n  score?: number | null;\n  engine: string;\n  engines: string[];\n  publishedDate?: string | null;\n  pubdate?: string | null;\n}\n\ninterface SearxngApiResponse {\n  results: SearxngApiResult[];\n  query: string;\n  number_of_results: number;\n}\n\nexport class SearxngClient implements SearchEngine {\n  name = 'searxng';\n\n  constructor(private readonly baseUrl: string) {}\n\n  async search(query: string, options: SearchEngineOptions = {}): Promise<RawSearchResult[]> {\n    const config = getConfig();\n    const timeoutMs = options.timeoutMs ?? config.searxngQueryTimeoutMs;\n    const maxResults = options.maxResults ?? 10;\n\n    // Build query with domain site: operators\n    let queryStr = query;\n    if (options.includeDomains?.length) {\n      // Best-effort: site: syntax works on Google/Bing but not all SearXNG engines.\n      // Post-filter in filters.ts handles the gap for engines that ignore it.\n      const siteFilter = options.includeDomains.map(d => `site:${d}`).join(' OR ');\n      queryStr = options.includeDomains.length === 1\n        ? `${query} site:${options.includeDomains[0]}`\n        : `${query} (${siteFilter})`;\n    }\n    // exclude_domains are NOT passed to SearXNG — handled by post-filter\n\n    const params = new URLSearchParams({\n      q: queryStr,\n      format: 'json',\n      pageno: '1',\n    });\n\n    if (options.timeRange) params.set('time_range', options.timeRange);\n    if (options.language) params.set('language', options.language);\n\n    // Category pass-through\n    if (options.category) {\n      params.set('categories', CATEGORY_MAP[options.category] ?? 'general');\n    }\n\n    // Date range -> time_range bucket (SearXNG doesn't support arbitrary dates)\n    if (!options.timeRange && (options.fromDate || options.toDate)) {\n      const range = computeTimeRange(options.fromDate, options.toDate);\n      if (range) params.set('time_range', range);\n    }\n\n    const url = `${this.baseUrl}/search?${params}`;\n    log.debug('querying searxng', { query: queryStr, url });\n\n    const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });\n\n    if (!response.ok) {\n      throw new Error(`SearXNG returned ${response.status}`);\n    }\n\n    const data = (await response.json()) as SearxngApiResponse;\n    const total = data.results.length;\n\n    return data.results.slice(0, maxResults).map((r, i) => {\n      const published = r.publishedDate ?? r.pubdate ?? undefined;\n      return {\n        title: r.title,\n        url: r.url,\n        snippet: r.content,\n        relevance_score: r.score != null ? Math.min(r.score, 1) : 1 - i / Math.max(total, 1),\n        engine: 'searxng',\n        ...(published ? { published_date: published } : {}),\n      };\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/search/tokens.d.ts

@@ -0,0 +1,3 @@
+export declare function countTokens(text: string): number;
+export declare function truncateByTokens(text: string, maxTokens: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/search/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/search/tokens.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAMD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA2BxE"}

package/dist/search/tokens.js

@@ -0,0 +1,39 @@
+import { encode, decode } from "gpt-tokenizer";
+const TRUNC_MARKER = "\n\n[... content truncated]";
+const MARKER_TOKEN_BUDGET = 6;
+function countTokens(text) {
+  if (!text) return 0;
+  return encode(text).length;
+}
+function truncateByTokens(text, maxTokens) {
+  if (maxTokens <= 0) return TRUNC_MARKER.trim();
+  if (!text) return "";
+  const tokens = encode(text);
+  if (tokens.length <= maxTokens) return text;
+  const budget = Math.max(0, maxTokens - MARKER_TOKEN_BUDGET);
+  const head = decode(tokens.slice(0, budget));
+  const threshold = head.length * 0.7;
+  const lastSentence = Math.max(
+    head.lastIndexOf(". "),
+    head.lastIndexOf(".\n"),
+    head.lastIndexOf("? "),
+    head.lastIndexOf("! ")
+  );
+  if (lastSentence > threshold) {
+    return head.slice(0, lastSentence + 1) + TRUNC_MARKER;
+  }
+  const lastPara = head.lastIndexOf("\n\n");
+  if (lastPara > threshold) {
+    return head.slice(0, lastPara) + TRUNC_MARKER;
+  }
+  const lastHeading = head.lastIndexOf("\n#");
+  if (lastHeading > threshold) {
+    return head.slice(0, lastHeading) + TRUNC_MARKER;
+  }
+  return head + TRUNC_MARKER;
+}
+export {
+  countTokens,
+  truncateByTokens
+};
+//# sourceMappingURL=tokens.js.map

package/dist/search/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/search/tokens.ts"],"sourcesContent":["import { encode, decode } from 'gpt-tokenizer';\n\nconst TRUNC_MARKER = '\\n\\n[... content truncated]';\nconst MARKER_TOKEN_BUDGET = 6;\n\nexport function countTokens(text: string): number {\n  if (!text) return 0;\n  return encode(text).length;\n}\n\n// Token-budget truncation. Prefer sentence > paragraph > section boundary\n// within the last 30% of the budget. Falls back to a hard token cut + marker.\n// Caveat: gpt-tokenizer uses cl100k-base (OpenAI). Counts on Claude/Gemini/\n// Llama may drift ~5-15%. Treat as approximation; we are not billing.\nexport function truncateByTokens(text: string, maxTokens: number): string {\n  if (maxTokens <= 0) return TRUNC_MARKER.trim();\n  if (!text) return '';\n  const tokens = encode(text);\n  if (tokens.length <= maxTokens) return text;\n\n  const budget = Math.max(0, maxTokens - MARKER_TOKEN_BUDGET);\n  const head = decode(tokens.slice(0, budget));\n  const threshold = head.length * 0.7;\n  const lastSentence = Math.max(\n    head.lastIndexOf('. '),\n    head.lastIndexOf('.\\n'),\n    head.lastIndexOf('? '),\n    head.lastIndexOf('! '),\n  );\n  if (lastSentence > threshold) {\n    return head.slice(0, lastSentence + 1) + TRUNC_MARKER;\n  }\n  const lastPara = head.lastIndexOf('\\n\\n');\n  if (lastPara > threshold) {\n    return head.slice(0, lastPara) + TRUNC_MARKER;\n  }\n  const lastHeading = head.lastIndexOf('\\n#');\n  if (lastHeading > threshold) {\n    return head.slice(0, lastHeading) + TRUNC_MARKER;\n  }\n  return head + TRUNC_MARKER;\n}\n"],"mappings":"AAAA,SAAS,QAAQ,cAAc;AAE/B,MAAM,eAAe;AACrB,MAAM,sBAAsB;AAErB,SAAS,YAAY,MAAsB;AAChD,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,OAAO,IAAI,EAAE;AACtB;AAMO,SAAS,iBAAiB,MAAc,WAA2B;AACxE,MAAI,aAAa,EAAG,QAAO,aAAa,KAAK;AAC7C,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,SAAS,OAAO,IAAI;AAC1B,MAAI,OAAO,UAAU,UAAW,QAAO;AAEvC,QAAM,SAAS,KAAK,IAAI,GAAG,YAAY,mBAAmB;AAC1D,QAAM,OAAO,OAAO,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3C,QAAM,YAAY,KAAK,SAAS;AAChC,QAAM,eAAe,KAAK;AAAA,IACxB,KAAK,YAAY,IAAI;AAAA,IACrB,KAAK,YAAY,KAAK;AAAA,IACtB,KAAK,YAAY,IAAI;AAAA,IACrB,KAAK,YAAY,IAAI;AAAA,EACvB;AACA,MAAI,eAAe,WAAW;AAC5B,WAAO,KAAK,MAAM,GAAG,eAAe,CAAC,IAAI;AAAA,EAC3C;AACA,QAAM,WAAW,KAAK,YAAY,MAAM;AACxC,MAAI,WAAW,WAAW;AACxB,WAAO,KAAK,MAAM,GAAG,QAAQ,IAAI;AAAA,EACnC;AACA,QAAM,cAAc,KAAK,YAAY,KAAK;AAC1C,MAAI,cAAc,WAAW;AAC3B,WAAO,KAAK,MAAM,GAAG,WAAW,IAAI;AAAA,EACtC;AACA,SAAO,OAAO;AAChB;","names":[]}

package/dist/search/truncate.d.ts

@@ -0,0 +1,6 @@
+export declare function truncateSmartly(text: string, maxChars: number): string;
+export declare function applyOutputBudget(text: string, opts: {
+    maxTokensOut?: number;
+    maxChars?: number;
+}): string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/search/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/search/truncate.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CActE;AAKD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAKR"}

package/dist/search/truncate.js

@@ -0,0 +1,26 @@
+import { truncateByTokens } from "./tokens.js";
+const TRUNC_MARKER = "\n\n[... content truncated]";
+function truncateSmartly(text, maxChars) {
+  if (maxChars <= 0) return TRUNC_MARKER;
+  if (text.length <= maxChars) return text;
+  const head = text.slice(0, maxChars);
+  const lastPara = head.lastIndexOf("\n\n");
+  const lastHeading = head.lastIndexOf("\n#");
+  const lastBreak = Math.max(lastPara, lastHeading);
+  const threshold = maxChars * 0.7;
+  if (lastBreak > threshold) {
+    return head.slice(0, lastBreak) + TRUNC_MARKER;
+  }
+  return head + TRUNC_MARKER;
+}
+function applyOutputBudget(text, opts) {
+  if (!text) return text;
+  if (opts.maxTokensOut != null) return truncateByTokens(text, opts.maxTokensOut);
+  if (opts.maxChars != null) return truncateSmartly(text, opts.maxChars);
+  return text;
+}
+export {
+  applyOutputBudget,
+  truncateSmartly
+};
+//# sourceMappingURL=truncate.js.map

package/dist/search/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/search/truncate.ts"],"sourcesContent":["import { truncateByTokens } from './tokens.js';\n\nconst TRUNC_MARKER = '\\n\\n[... content truncated]';\n\nexport function truncateSmartly(text: string, maxChars: number): string {\n  if (maxChars <= 0) return TRUNC_MARKER;\n  if (text.length <= maxChars) return text;\n\n  const head = text.slice(0, maxChars);\n  const lastPara = head.lastIndexOf('\\n\\n');\n  const lastHeading = head.lastIndexOf('\\n#');\n  const lastBreak = Math.max(lastPara, lastHeading);\n  const threshold = maxChars * 0.7;\n\n  if (lastBreak > threshold) {\n    return head.slice(0, lastBreak) + TRUNC_MARKER;\n  }\n  return head + TRUNC_MARKER;\n}\n\n// max_tokens_out wins over max_chars whenever both are set. Falls back to\n// truncateSmartly for chars-only budgets, and returns text unchanged when\n// neither is set.\nexport function applyOutputBudget(\n  text: string,\n  opts: { maxTokensOut?: number; maxChars?: number },\n): string {\n  if (!text) return text;\n  if (opts.maxTokensOut != null) return truncateByTokens(text, opts.maxTokensOut);\n  if (opts.maxChars != null) return truncateSmartly(text, opts.maxChars);\n  return text;\n}\n"],"mappings":"AAAA,SAAS,wBAAwB;AAEjC,MAAM,eAAe;AAEd,SAAS,gBAAgB,MAAc,UAA0B;AACtE,MAAI,YAAY,EAAG,QAAO;AAC1B,MAAI,KAAK,UAAU,SAAU,QAAO;AAEpC,QAAM,OAAO,KAAK,MAAM,GAAG,QAAQ;AACnC,QAAM,WAAW,KAAK,YAAY,MAAM;AACxC,QAAM,cAAc,KAAK,YAAY,KAAK;AAC1C,QAAM,YAAY,KAAK,IAAI,UAAU,WAAW;AAChD,QAAM,YAAY,WAAW;AAE7B,MAAI,YAAY,WAAW;AACzB,WAAO,KAAK,MAAM,GAAG,SAAS,IAAI;AAAA,EACpC;AACA,SAAO,OAAO;AAChB;AAKO,SAAS,kBACd,MACA,MACQ;AACR,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,KAAK,gBAAgB,KAAM,QAAO,iBAAiB,MAAM,KAAK,YAAY;AAC9E,MAAI,KAAK,YAAY,KAAM,QAAO,gBAAgB,MAAM,KAAK,QAAQ;AACrE,SAAO;AACT;","names":[]}

package/dist/search/url-unwrap.d.ts

@@ -0,0 +1,3 @@
+export declare function unwrapRedirect(input: string): string | null;
+export declare function normalizeResultUrl(input: string): string;
+//# sourceMappingURL=url-unwrap.d.ts.map

package/dist/search/url-unwrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-unwrap.d.ts","sourceRoot":"","sources":["../../src/search/url-unwrap.ts"],"names":[],"mappings":"AAWA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B3D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/search/url-unwrap.js

@@ -0,0 +1,43 @@
+const REDIRECT_HOSTS = {
+  "duckduckgo.com": "uddg",
+  "www.duckduckgo.com": "uddg",
+  "google.com": "q",
+  "www.google.com": "q"
+};
+function unwrapRedirect(input) {
+  if (!input) return null;
+  let candidate = input;
+  if (candidate.startsWith("//")) candidate = "https:" + candidate;
+  let parsed;
+  try {
+    parsed = new URL(candidate);
+  } catch {
+    return null;
+  }
+  const param = REDIRECT_HOSTS[parsed.hostname];
+  if (!param) return null;
+  const target = parsed.searchParams.get(param);
+  if (!target) return null;
+  let decoded;
+  try {
+    decoded = decodeURIComponent(target);
+  } catch {
+    return null;
+  }
+  if (!/^https?:\/\//i.test(decoded)) return null;
+  try {
+    new URL(decoded);
+  } catch {
+    return null;
+  }
+  return decoded;
+}
+function normalizeResultUrl(input) {
+  const unwrapped = unwrapRedirect(input);
+  return unwrapped ?? input;
+}
+export {
+  normalizeResultUrl,
+  unwrapRedirect
+};
+//# sourceMappingURL=url-unwrap.js.map

package/dist/search/url-unwrap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/search/url-unwrap.ts"],"sourcesContent":["// Unwrap engine-side redirect URLs (DDG /l/?uddg=, Google /url?q=) into\n// the real target URL. Returns null when the input is not a wrapped\n// redirect, or the wrapped value is not a usable http(s) URL.\n\nconst REDIRECT_HOSTS: Record<string, string> = {\n  'duckduckgo.com': 'uddg',\n  'www.duckduckgo.com': 'uddg',\n  'google.com': 'q',\n  'www.google.com': 'q',\n};\n\nexport function unwrapRedirect(input: string): string | null {\n  if (!input) return null;\n  let candidate = input;\n  if (candidate.startsWith('//')) candidate = 'https:' + candidate;\n  let parsed: URL;\n  try {\n    parsed = new URL(candidate);\n  } catch {\n    return null;\n  }\n  const param = REDIRECT_HOSTS[parsed.hostname];\n  if (!param) return null;\n  const target = parsed.searchParams.get(param);\n  if (!target) return null;\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(target);\n  } catch {\n    return null;\n  }\n  if (!/^https?:\\/\\//i.test(decoded)) return null;\n  try {\n    new URL(decoded);\n  } catch {\n    return null;\n  }\n  return decoded;\n}\n\nexport function normalizeResultUrl(input: string): string {\n  const unwrapped = unwrapRedirect(input);\n  return unwrapped ?? input;\n}\n"],"mappings":"AAIA,MAAM,iBAAyC;AAAA,EAC7C,kBAAkB;AAAA,EAClB,sBAAsB;AAAA,EACtB,cAAc;AAAA,EACd,kBAAkB;AACpB;AAEO,SAAS,eAAe,OAA8B;AAC3D,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,YAAY;AAChB,MAAI,UAAU,WAAW,IAAI,EAAG,aAAY,WAAW;AACvD,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,IAAI,SAAS;AAAA,EAC5B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,eAAe,OAAO,QAAQ;AAC5C,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,SAAS,OAAO,aAAa,IAAI,KAAK;AAC5C,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI;AACJ,MAAI;AACF,cAAU,mBAAmB,MAAM;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,gBAAgB,KAAK,OAAO,EAAG,QAAO;AAC3C,MAAI;AACF,QAAI,IAAI,OAAO;AAAA,EACjB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAuB;AACxD,QAAM,YAAY,eAAe,KAAK;AACtC,SAAO,aAAa;AACtB;","names":[]}

package/dist/search/v1/context-rank.d.ts

@@ -0,0 +1,13 @@
+import type { RawSearchResult } from '../../types.js';
+export interface ContextRankOptions {
+    /** Multiplier range; results closer to context vector get higher boost. */
+    minMultiplier?: number;
+    maxMultiplier?: number;
+}
+/**
+ * Re-score results using cosine similarity vs the embedded query+context.
+ * Returns a new array; does NOT mutate input. Returns input unchanged when
+ * contextText is empty, the embed provider is unavailable, or embedding fails.
+ */
+export declare function applyContextRank(results: RawSearchResult[], query: string, contextText: string | undefined, options?: ContextRankOptions): Promise<RawSearchResult[]>;
+//# sourceMappingURL=context-rank.d.ts.map

package/dist/search/v1/context-rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-rank.d.ts","sourceRoot":"","sources":["../../../src/search/v1/context-rank.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMtD,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA0BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CAgD5B"}

package/dist/search/v1/context-rank.js

@@ -0,0 +1,74 @@
+import { getEmbedProvider } from "../../providers/embed-provider.js";
+import { createLogger } from "../../logger.js";
+const log = createLogger("search");
+const DEFAULT_MIN_MULTIPLIER = 0.8;
+const DEFAULT_MAX_MULTIPLIER = 1.2;
+function cosine(a, b) {
+  const n = Math.min(a.length, b.length);
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  for (let i = 0; i < n; i++) {
+    const x = a[i];
+    const y = b[i];
+    dot += x * y;
+    na += x * x;
+    nb += y * y;
+  }
+  if (na === 0 || nb === 0) return 0;
+  return dot / Math.sqrt(na * nb);
+}
+function mapCosineToMultiplier(cos, min, max) {
+  const clamped = cos < -1 ? -1 : cos > 1 ? 1 : cos;
+  return min + (max - min) * (clamped + 1) / 2;
+}
+async function applyContextRank(results, query, contextText, options) {
+  if (results.length === 0) return results;
+  const ctx = contextText?.trim();
+  if (!ctx) return results;
+  const min = options?.minMultiplier ?? DEFAULT_MIN_MULTIPLIER;
+  const max = options?.maxMultiplier ?? DEFAULT_MAX_MULTIPLIER;
+  let provider;
+  try {
+    provider = await getEmbedProvider();
+  } catch (err) {
+    log.warn("context-rank: embed provider unavailable, skipping", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return results;
+  }
+  const combinedQuery = `${query}
+
+Context:
+${ctx}`;
+  const resultTexts = results.map((r) => `${r.title}
+${r.snippet}`);
+  let vectors;
+  try {
+    vectors = await provider.embed([combinedQuery, ...resultTexts]);
+  } catch (err) {
+    log.warn("context-rank: embed call failed, skipping", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return results;
+  }
+  if (vectors.length !== results.length + 1) {
+    log.warn("context-rank: unexpected vector count, skipping", {
+      expected: results.length + 1,
+      got: vectors.length
+    });
+    return results;
+  }
+  const queryVec = vectors[0];
+  const rescored = results.map((r, i) => {
+    const cos = cosine(queryVec, vectors[i + 1]);
+    const multiplier = mapCosineToMultiplier(cos, min, max);
+    return { ...r, relevance_score: r.relevance_score * multiplier };
+  });
+  rescored.sort((a, b) => b.relevance_score - a.relevance_score);
+  return rescored;
+}
+export {
+  applyContextRank
+};
+//# sourceMappingURL=context-rank.js.map

package/dist/search/v1/context-rank.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/search/v1/context-rank.ts"],"sourcesContent":["// Phase 9 — context-aware re-ranking.\n//\n// Re-scores RawSearchResult[] using cosine similarity against an embedded\n// `query + agent context` vector. Maps cosine ∈ [-1, 1] to a multiplier in\n// [min, max] and rescales relevance_score. Embedding failures are non-fatal:\n// on any error the input array is returned unchanged.\n\nimport type { RawSearchResult } from '../../types.js';\nimport { getEmbedProvider } from '../../providers/embed-provider.js';\nimport { createLogger } from '../../logger.js';\n\nconst log = createLogger('search');\n\nexport interface ContextRankOptions {\n  /** Multiplier range; results closer to context vector get higher boost. */\n  minMultiplier?: number;\n  maxMultiplier?: number;\n}\n\nconst DEFAULT_MIN_MULTIPLIER = 0.8;\nconst DEFAULT_MAX_MULTIPLIER = 1.2;\n\nfunction cosine(a: Float32Array, b: Float32Array): number {\n  const n = Math.min(a.length, b.length);\n  let dot = 0;\n  let na = 0;\n  let nb = 0;\n  for (let i = 0; i < n; i++) {\n    const x = a[i];\n    const y = b[i];\n    dot += x * y;\n    na += x * x;\n    nb += y * y;\n  }\n  if (na === 0 || nb === 0) return 0;\n  return dot / Math.sqrt(na * nb);\n}\n\nfunction mapCosineToMultiplier(cos: number, min: number, max: number): number {\n  const clamped = cos < -1 ? -1 : cos > 1 ? 1 : cos;\n  return min + (max - min) * (clamped + 1) / 2;\n}\n\n/**\n * Re-score results using cosine similarity vs the embedded query+context.\n * Returns a new array; does NOT mutate input. Returns input unchanged when\n * contextText is empty, the embed provider is unavailable, or embedding fails.\n */\nexport async function applyContextRank(\n  results: RawSearchResult[],\n  query: string,\n  contextText: string | undefined,\n  options?: ContextRankOptions,\n): Promise<RawSearchResult[]> {\n  if (results.length === 0) return results;\n  const ctx = contextText?.trim();\n  if (!ctx) return results;\n\n  const min = options?.minMultiplier ?? DEFAULT_MIN_MULTIPLIER;\n  const max = options?.maxMultiplier ?? DEFAULT_MAX_MULTIPLIER;\n\n  let provider;\n  try {\n    provider = await getEmbedProvider();\n  } catch (err) {\n    log.warn('context-rank: embed provider unavailable, skipping', {\n      error: err instanceof Error ? err.message : String(err),\n    });\n    return results;\n  }\n\n  const combinedQuery = `${query}\\n\\nContext:\\n${ctx}`;\n  const resultTexts = results.map((r) => `${r.title}\\n${r.snippet}`);\n\n  let vectors: Float32Array[];\n  try {\n    vectors = await provider.embed([combinedQuery, ...resultTexts]);\n  } catch (err) {\n    log.warn('context-rank: embed call failed, skipping', {\n      error: err instanceof Error ? err.message : String(err),\n    });\n    return results;\n  }\n\n  if (vectors.length !== results.length + 1) {\n    log.warn('context-rank: unexpected vector count, skipping', {\n      expected: results.length + 1,\n      got: vectors.length,\n    });\n    return results;\n  }\n\n  const queryVec = vectors[0];\n  const rescored = results.map((r, i) => {\n    const cos = cosine(queryVec, vectors[i + 1]);\n    const multiplier = mapCosineToMultiplier(cos, min, max);\n    return { ...r, relevance_score: r.relevance_score * multiplier };\n  });\n\n  rescored.sort((a, b) => b.relevance_score - a.relevance_score);\n  return rescored;\n}\n"],"mappings":"AAQA,SAAS,wBAAwB;AACjC,SAAS,oBAAoB;AAE7B,MAAM,MAAM,aAAa,QAAQ;AAQjC,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAE/B,SAAS,OAAO,GAAiB,GAAyB;AACxD,QAAM,IAAI,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM;AACrC,MAAI,MAAM;AACV,MAAI,KAAK;AACT,MAAI,KAAK;AACT,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,IAAI,EAAE,CAAC;AACb,UAAM,IAAI,EAAE,CAAC;AACb,WAAO,IAAI;AACX,UAAM,IAAI;AACV,UAAM,IAAI;AAAA,EACZ;AACA,MAAI,OAAO,KAAK,OAAO,EAAG,QAAO;AACjC,SAAO,MAAM,KAAK,KAAK,KAAK,EAAE;AAChC;AAEA,SAAS,sBAAsB,KAAa,KAAa,KAAqB;AAC5E,QAAM,UAAU,MAAM,KAAK,KAAK,MAAM,IAAI,IAAI;AAC9C,SAAO,OAAO,MAAM,QAAQ,UAAU,KAAK;AAC7C;AAOA,eAAsB,iBACpB,SACA,OACA,aACA,SAC4B;AAC5B,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,MAAM,aAAa,KAAK;AAC9B,MAAI,CAAC,IAAK,QAAO;AAEjB,QAAM,MAAM,SAAS,iBAAiB;AACtC,QAAM,MAAM,SAAS,iBAAiB;AAEtC,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,iBAAiB;AAAA,EACpC,SAAS,KAAK;AACZ,QAAI,KAAK,sDAAsD;AAAA,MAC7D,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACxD,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,GAAG,KAAK;AAAA;AAAA;AAAA,EAAiB,GAAG;AAClD,QAAM,cAAc,QAAQ,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK;AAAA,EAAK,EAAE,OAAO,EAAE;AAEjE,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,SAAS,MAAM,CAAC,eAAe,GAAG,WAAW,CAAC;AAAA,EAChE,SAAS,KAAK;AACZ,QAAI,KAAK,6CAA6C;AAAA,MACpD,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACxD,CAAC;AACD,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ,WAAW,QAAQ,SAAS,GAAG;AACzC,QAAI,KAAK,mDAAmD;AAAA,MAC1D,UAAU,QAAQ,SAAS;AAAA,MAC3B,KAAK,QAAQ;AAAA,IACf,CAAC;AACD,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,QAAQ,CAAC;AAC1B,QAAM,WAAW,QAAQ,IAAI,CAAC,GAAG,MAAM;AACrC,UAAM,MAAM,OAAO,UAAU,QAAQ,IAAI,CAAC,CAAC;AAC3C,UAAM,aAAa,sBAAsB,KAAK,KAAK,GAAG;AACtD,WAAO,EAAE,GAAG,GAAG,iBAAiB,EAAE,kBAAkB,WAAW;AAAA,EACjE,CAAC;AAED,WAAS,KAAK,CAAC,GAAG,MAAM,EAAE,kBAAkB,EAAE,eAAe;AAC7D,SAAO;AACT;","names":[]}

package/dist/search/v1/engine-base.d.ts

@@ -0,0 +1,27 @@
+import type { SearchEngine, SearchEngineOptions, RawSearchResult } from '../../types.js';
+export interface EngineEntry {
+    engine: SearchEngine;
+    /** Optional weight for downstream RRF/scoring. Default 1. */
+    weight?: number;
+    /** Whether this engine accepts date filters in options.fromDate/toDate. */
+    supportsDateFilter?: boolean;
+}
+export interface EngineOutcome {
+    engine: string;
+    ok: boolean;
+    results: RawSearchResult[];
+    error?: string;
+    latencyMs: number;
+    /** True when the breaker tripped and we skipped the call. */
+    skipped?: boolean;
+}
+export interface BreakerConfig {
+    /** Fail count to trip. Default 3. */
+    failureThreshold?: number;
+    /** Cooldown after tripping, ms. Default 60_000. */
+    cooldownMs?: number;
+}
+export declare function _resetBreakersForTest(): void;
+export declare function wrapWithRetryAndBreaker(engine: SearchEngine, cfg?: BreakerConfig): SearchEngine;
+export declare function runEnginesParallel(entries: EngineEntry[], query: string, options?: SearchEngineOptions): Promise<EngineOutcome[]>;
+//# sourceMappingURL=engine-base.d.ts.map

package/dist/search/v1/engine-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-base.d.ts","sourceRoot":"","sources":["../../../src/search/v1/engine-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoDD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AASD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,aAAa,GAClB,YAAY,CA8Bd;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,CA0B1B"}

package/dist/search/v1/engine-base.js

@@ -0,0 +1,110 @@
+import { createLogger } from "../../logger.js";
+const log = createLogger("search");
+const DEFAULT_THRESHOLD = 3;
+const DEFAULT_COOLDOWN_MS = 6e4;
+const RETRY_BACKOFF_MS = 100;
+const breakers = /* @__PURE__ */ new Map();
+function getState(name) {
+  let s = breakers.get(name);
+  if (!s) {
+    s = { failures: 0, tripUntil: 0 };
+    breakers.set(name, s);
+  }
+  return s;
+}
+function isTripped(state) {
+  if (state.tripUntil === 0) return false;
+  if (Date.now() >= state.tripUntil) {
+    log.info("breaker auto-reset", {});
+    state.tripUntil = 0;
+    state.failures = 0;
+    return false;
+  }
+  return true;
+}
+function recordFailure(name, threshold, cooldownMs) {
+  const state = getState(name);
+  state.failures += 1;
+  if (state.failures >= threshold && state.tripUntil === 0) {
+    state.tripUntil = Date.now() + cooldownMs;
+    log.warn("breaker tripped", {
+      engine: name,
+      failures: state.failures,
+      cooldownMs
+    });
+  }
+}
+function recordSuccess(name) {
+  const state = getState(name);
+  state.failures = 0;
+  state.tripUntil = 0;
+}
+function _resetBreakersForTest() {
+  breakers.clear();
+}
+class BreakerOpenError extends Error {
+  constructor(name) {
+    super(`breaker open for engine ${name}`);
+    this.name = "BreakerOpenError";
+  }
+}
+function wrapWithRetryAndBreaker(engine, cfg) {
+  const threshold = cfg?.failureThreshold ?? DEFAULT_THRESHOLD;
+  const cooldownMs = cfg?.cooldownMs ?? DEFAULT_COOLDOWN_MS;
+  return {
+    name: engine.name,
+    async search(query, options) {
+      const state = getState(engine.name);
+      if (isTripped(state)) {
+        throw new BreakerOpenError(engine.name);
+      }
+      let lastErr;
+      for (let attempt = 1; attempt <= 2; attempt++) {
+        try {
+          const results = await engine.search(query, options);
+          recordSuccess(engine.name);
+          return results;
+        } catch (err) {
+          lastErr = err;
+          if (attempt === 1) {
+            await new Promise((r) => setTimeout(r, RETRY_BACKOFF_MS));
+          }
+        }
+      }
+      recordFailure(engine.name, threshold, cooldownMs);
+      throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+    }
+  };
+}
+async function runEnginesParallel(entries, query, options) {
+  const promises = entries.map(async (entry) => {
+    const start = Date.now();
+    try {
+      const results = await entry.engine.search(query, options);
+      return {
+        engine: entry.engine.name,
+        ok: true,
+        results,
+        latencyMs: Date.now() - start
+      };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const skipped = err instanceof BreakerOpenError;
+      return {
+        engine: entry.engine.name,
+        ok: false,
+        results: [],
+        error: message,
+        latencyMs: Date.now() - start,
+        ...skipped ? { skipped: true } : {}
+      };
+    }
+  });
+  return Promise.all(promises);
+}
+export {
+  _resetBreakersForTest,
+  runEnginesParallel,
+  wrapWithRetryAndBreaker
+};
+//# sourceMappingURL=engine-base.js.map

package/dist/search/v1/engine-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/search/v1/engine-base.ts"],"sourcesContent":["import type {\n  SearchEngine,\n  SearchEngineOptions,\n  RawSearchResult,\n} from '../../types.js';\nimport { createLogger } from '../../logger.js';\n\nconst log = createLogger('search');\n\nexport interface EngineEntry {\n  engine: SearchEngine;\n  /** Optional weight for downstream RRF/scoring. Default 1. */\n  weight?: number;\n  /** Whether this engine accepts date filters in options.fromDate/toDate. */\n  supportsDateFilter?: boolean;\n}\n\nexport interface EngineOutcome {\n  engine: string;\n  ok: boolean;\n  results: RawSearchResult[];\n  error?: string;\n  latencyMs: number;\n  /** True when the breaker tripped and we skipped the call. */\n  skipped?: boolean;\n}\n\nexport interface BreakerConfig {\n  /** Fail count to trip. Default 3. */\n  failureThreshold?: number;\n  /** Cooldown after tripping, ms. Default 60_000. */\n  cooldownMs?: number;\n}\n\ninterface BreakerState {\n  failures: number;\n  tripUntil: number;\n}\n\nconst DEFAULT_THRESHOLD = 3;\nconst DEFAULT_COOLDOWN_MS = 60_000;\nconst RETRY_BACKOFF_MS = 100;\n\nconst breakers = new Map<string, BreakerState>();\n\nfunction getState(name: string): BreakerState {\n  let s = breakers.get(name);\n  if (!s) {\n    s = { failures: 0, tripUntil: 0 };\n    breakers.set(name, s);\n  }\n  return s;\n}\n\nfunction isTripped(state: BreakerState): boolean {\n  if (state.tripUntil === 0) return false;\n  if (Date.now() >= state.tripUntil) {\n    log.info('breaker auto-reset', { });\n    state.tripUntil = 0;\n    state.failures = 0;\n    return false;\n  }\n  return true;\n}\n\nfunction recordFailure(name: string, threshold: number, cooldownMs: number): void {\n  const state = getState(name);\n  state.failures += 1;\n  if (state.failures >= threshold && state.tripUntil === 0) {\n    state.tripUntil = Date.now() + cooldownMs;\n    log.warn('breaker tripped', {\n      engine: name,\n      failures: state.failures,\n      cooldownMs,\n    });\n  }\n}\n\nfunction recordSuccess(name: string): void {\n  const state = getState(name);\n  state.failures = 0;\n  state.tripUntil = 0;\n}\n\nexport function _resetBreakersForTest(): void {\n  breakers.clear();\n}\n\nclass BreakerOpenError extends Error {\n  constructor(name: string) {\n    super(`breaker open for engine ${name}`);\n    this.name = 'BreakerOpenError';\n  }\n}\n\nexport function wrapWithRetryAndBreaker(\n  engine: SearchEngine,\n  cfg?: BreakerConfig,\n): SearchEngine {\n  const threshold = cfg?.failureThreshold ?? DEFAULT_THRESHOLD;\n  const cooldownMs = cfg?.cooldownMs ?? DEFAULT_COOLDOWN_MS;\n\n  return {\n    name: engine.name,\n    async search(query: string, options?: SearchEngineOptions): Promise<RawSearchResult[]> {\n      const state = getState(engine.name);\n      if (isTripped(state)) {\n        throw new BreakerOpenError(engine.name);\n      }\n\n      let lastErr: unknown;\n      for (let attempt = 1; attempt <= 2; attempt++) {\n        try {\n          const results = await engine.search(query, options);\n          recordSuccess(engine.name);\n          return results;\n        } catch (err) {\n          lastErr = err;\n          if (attempt === 1) {\n            await new Promise((r) => setTimeout(r, RETRY_BACKOFF_MS));\n          }\n        }\n      }\n\n      recordFailure(engine.name, threshold, cooldownMs);\n      throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));\n    },\n  };\n}\n\nexport async function runEnginesParallel(\n  entries: EngineEntry[],\n  query: string,\n  options?: SearchEngineOptions,\n): Promise<EngineOutcome[]> {\n  const promises = entries.map(async (entry): Promise<EngineOutcome> => {\n    const start = Date.now();\n    try {\n      const results = await entry.engine.search(query, options);\n      return {\n        engine: entry.engine.name,\n        ok: true,\n        results,\n        latencyMs: Date.now() - start,\n      };\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      const skipped = err instanceof BreakerOpenError;\n      return {\n        engine: entry.engine.name,\n        ok: false,\n        results: [],\n        error: message,\n        latencyMs: Date.now() - start,\n        ...(skipped ? { skipped: true } : {}),\n      };\n    }\n  });\n\n  return Promise.all(promises);\n}\n"],"mappings":"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","names":[]}