@selesai/code 0.13.3 → 0.13.5

package/dist/extensions/pi-web-agent/src/fetch/headless-fetch.ts

@@ -1,117 +1,117 @@
-import { chromium } from 'playwright';
-import { extractReadableContentSafely } from '../extract/readability.js';
-import { resolveBrowserExecutable, type BrowserResolutionResult } from './browser-resolution.js';
-import type { WebFetchHeadlessResponse } from '../types.js';
-
-function cleanupRenderedText(text: string): string {
-  let cleaned = text.replace(/(Show more)(\s+\1){1,}/gi, '$1');
-  cleaned = cleaned.replace(/(Privacy Terms)(\s+\1){1,}/gi, '$1');
-  cleaned = cleaned.replace(/\s+/g, ' ').trim();
-  return cleaned;
-}
-
-export async function headlessFetch(
-  url: string,
-  {
-    configuredPath,
-    resolveBrowser = (options?: { configuredPath?: string }) =>
-      resolveBrowserExecutable({ configuredPath: options?.configuredPath }),
-    launchBrowser = ({ executablePath, headless }: { executablePath?: string; headless: true }) =>
-      chromium.launch(executablePath ? { executablePath, headless } : { headless }),
-    now = () => Date.now()
-  }: {
-    configuredPath?: string;
-    resolveBrowser?: (options?: { configuredPath?: string }) => Promise<BrowserResolutionResult>;
-    launchBrowser?: (options: { executablePath?: string; headless: true }) => Promise<{
-      newContext: () => Promise<{ newPage: () => Promise<any>; close: () => Promise<void> }>;
-      close: () => Promise<void>;
-    }>;
-    now?: () => number;
-  } = {}
-): Promise<WebFetchHeadlessResponse> {
-  const resolved = await resolveBrowser({ configuredPath });
-  if (!resolved.ok && resolved.error.code === 'CONFIGURED_BROWSER_NOT_FOUND') {
-    return {
-      status: 'error',
-      url,
-      metadata: { method: 'headless', cacheHit: false },
-      error: resolved.error
-    };
-  }
-
-  const browserName = resolved.ok ? resolved.browser : 'chromium';
-  const launchOptions = resolved.ok
-    ? { executablePath: resolved.executablePath, headless: true as const }
-    : { headless: true as const };
-
-  let browser: Awaited<ReturnType<typeof launchBrowser>> | undefined;
-  let context: Awaited<ReturnType<Awaited<ReturnType<typeof launchBrowser>>['newContext']>> | undefined;
-  let page: Awaited<ReturnType<Awaited<ReturnType<Awaited<ReturnType<typeof launchBrowser>>['newContext']>>['newPage']>> | undefined;
-
-  try {
-    browser = await launchBrowser(launchOptions);
-    context = await browser.newContext();
-    page = await context.newPage();
-
-    const startedAt = now();
-    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 20000 });
-    await page.waitForLoadState('load', { timeout: 10000 });
-    await page.waitForLoadState('networkidle', { timeout: 5000 }).catch(() => undefined);
-    const html = await page.content();
-    const finishedAt = now();
-
-    const extraction = extractReadableContentSafely(html);
-    const cleanedContent = {
-      ...extraction.content,
-      text: cleanupRenderedText(extraction.content.text)
-    };
-
-    if (!cleanedContent.text || cleanedContent.text.length < 40) {
-      return {
-        status: 'blocked',
-        url,
-        metadata: {
-          method: 'headless',
-          cacheHit: false,
-          browser: browserName,
-          navigationMs: finishedAt - startedAt
-        },
-        error: {
-          code: 'HEADLESS_EXTRACTION_WEAK',
-          message: 'Rendered page did not produce enough readable content.'
-        }
-      };
-    }
-
-    return {
-      status: 'ok',
-      url,
-      content: cleanedContent,
-      metadata: {
-        method: 'headless',
-        cacheHit: false,
-        browser: browserName,
-        navigationMs: finishedAt - startedAt,
-        truncated: cleanedContent.text.length >= 4000
-      }
-    };
-  } catch (error) {
-    return {
-      status: 'error',
-      url,
-      metadata: {
-        method: 'headless',
-        cacheHit: false,
-        browser: browserName
-      },
-      error: {
-        code: 'HEADLESS_NAVIGATION_FAILED',
-        message: error instanceof Error ? error.message : 'Unknown headless navigation failure.'
-      }
-    };
-  } finally {
-    await page?.close?.().catch(() => undefined);
-    await context?.close?.().catch(() => undefined);
-    await browser?.close?.().catch(() => undefined);
-  }
-}
+import { chromium } from 'playwright';
+import { extractReadableContentSafely } from '../extract/readability.js';
+import { resolveBrowserExecutable, type BrowserResolutionResult } from './browser-resolution.js';
+import type { WebFetchHeadlessResponse } from '../types.js';
+
+function cleanupRenderedText(text: string): string {
+  let cleaned = text.replace(/(Show more)(\s+\1){1,}/gi, '$1');
+  cleaned = cleaned.replace(/(Privacy Terms)(\s+\1){1,}/gi, '$1');
+  cleaned = cleaned.replace(/\s+/g, ' ').trim();
+  return cleaned;
+}
+
+export async function headlessFetch(
+  url: string,
+  {
+    configuredPath,
+    resolveBrowser = (options?: { configuredPath?: string }) =>
+      resolveBrowserExecutable({ configuredPath: options?.configuredPath }),
+    launchBrowser = ({ executablePath, headless }: { executablePath?: string; headless: true }) =>
+      chromium.launch(executablePath ? { executablePath, headless } : { headless }),
+    now = () => Date.now()
+  }: {
+    configuredPath?: string;
+    resolveBrowser?: (options?: { configuredPath?: string }) => Promise<BrowserResolutionResult>;
+    launchBrowser?: (options: { executablePath?: string; headless: true }) => Promise<{
+      newContext: () => Promise<{ newPage: () => Promise<any>; close: () => Promise<void> }>;
+      close: () => Promise<void>;
+    }>;
+    now?: () => number;
+  } = {}
+): Promise<WebFetchHeadlessResponse> {
+  const resolved = await resolveBrowser({ configuredPath });
+  if (!resolved.ok && resolved.error.code === 'CONFIGURED_BROWSER_NOT_FOUND') {
+    return {
+      status: 'error',
+      url,
+      metadata: { method: 'headless', cacheHit: false },
+      error: resolved.error
+    };
+  }
+
+  const browserName = resolved.ok ? resolved.browser : 'chromium';
+  const launchOptions = resolved.ok
+    ? { executablePath: resolved.executablePath, headless: true as const }
+    : { headless: true as const };
+
+  let browser: Awaited<ReturnType<typeof launchBrowser>> | undefined;
+  let context: Awaited<ReturnType<Awaited<ReturnType<typeof launchBrowser>>['newContext']>> | undefined;
+  let page: Awaited<ReturnType<Awaited<ReturnType<Awaited<ReturnType<typeof launchBrowser>>['newContext']>>['newPage']>> | undefined;
+
+  try {
+    browser = await launchBrowser(launchOptions);
+    context = await browser.newContext();
+    page = await context.newPage();
+
+    const startedAt = now();
+    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 20000 });
+    await page.waitForLoadState('load', { timeout: 10000 });
+    await page.waitForLoadState('networkidle', { timeout: 5000 }).catch(() => undefined);
+    const html = await page.content();
+    const finishedAt = now();
+
+    const extraction = extractReadableContentSafely(html);
+    const cleanedContent = {
+      ...extraction.content,
+      text: cleanupRenderedText(extraction.content.text)
+    };
+
+    if (!cleanedContent.text || cleanedContent.text.length < 40) {
+      return {
+        status: 'blocked',
+        url,
+        metadata: {
+          method: 'headless',
+          cacheHit: false,
+          browser: browserName,
+          navigationMs: finishedAt - startedAt
+        },
+        error: {
+          code: 'HEADLESS_EXTRACTION_WEAK',
+          message: 'Rendered page did not produce enough readable content.'
+        }
+      };
+    }
+
+    return {
+      status: 'ok',
+      url,
+      content: cleanedContent,
+      metadata: {
+        method: 'headless',
+        cacheHit: false,
+        browser: browserName,
+        navigationMs: finishedAt - startedAt,
+        truncated: cleanedContent.text.length >= 4000
+      }
+    };
+  } catch (error) {
+    return {
+      status: 'error',
+      url,
+      metadata: {
+        method: 'headless',
+        cacheHit: false,
+        browser: browserName
+      },
+      error: {
+        code: 'HEADLESS_NAVIGATION_FAILED',
+        message: error instanceof Error ? error.message : 'Unknown headless navigation failure.'
+      }
+    };
+  } finally {
+    await page?.close?.().catch(() => undefined);
+    await context?.close?.().catch(() => undefined);
+    await browser?.close?.().catch(() => undefined);
+  }
+}

package/dist/extensions/pi-web-agent/src/fetch/http-fetch.ts

@@ -1,67 +1,67 @@
-import { extractReadableContentSafely } from '../extract/readability.js';
-import type { WebFetchResponse } from '../types.js';
-
-function looksLikeScriptShell(html: string): boolean {
-  const lower = html.toLowerCase();
-  return lower.includes('<script') && (lower.includes('id="app"') || lower.includes('id="root"'));
-}
-
-function isWeakHttpContent(options: { html: string; title?: string; text: string }): boolean {
-  const normalizedText = options.text.replace(/\s+/g, ' ').trim();
-  const normalizedHtml = options.html.replace(/\s+/g, ' ').trim();
-  const textLength = normalizedText.length;
-  const htmlLength = normalizedHtml.length;
-  const hasGenericShellMarker = /enable javascript|javascript required|please turn on javascript/i.test(
-    options.html
-  );
-  const veryShortBody = textLength > 0 && textLength < 120;
-  const lowDensity = htmlLength > 0 && textLength / htmlLength < 0.02;
-
-  return veryShortBody && (lowDensity || hasGenericShellMarker);
-}
-
-export function createHttpFetcher({
-  fetchImpl = fetch
-}: {
-  fetchImpl?: typeof fetch;
-} = {}) {
-  return async function httpFetch(url: string): Promise<WebFetchResponse> {
-    const response = await fetchImpl(url);
-    const contentType = response.headers.get('content-type') ?? '';
-
-    if (!contentType.includes('text/html')) {
-      return {
-        status: 'unsupported',
-        url: response.url,
-        metadata: { method: 'http', cacheHit: false, contentType }
-      };
-    }
-
-    const html = await response.text();
-    const extraction = extractReadableContentSafely(html);
-    const content = extraction.content;
-
-    if (
-      looksLikeScriptShell(html) ||
-      content.text.length < 40 ||
-      isWeakHttpContent({ html, title: content.title, text: content.text })
-    ) {
-      return {
-        status: 'needs_headless',
-        url: response.url,
-        metadata: { method: 'http', cacheHit: false, contentType },
-        error: {
-          code: 'WEAK_EXTRACTION',
-          message: 'HTTP extraction was not reliable enough.'
-        }
-      };
-    }
-
-    return {
-      status: 'ok',
-      url: response.url,
-      content,
-      metadata: { method: 'http', cacheHit: false, contentType, truncated: content.text.length >= 4000 }
-    };
-  };
-}
+import { extractReadableContentSafely } from '../extract/readability.js';
+import type { WebFetchResponse } from '../types.js';
+
+function looksLikeScriptShell(html: string): boolean {
+  const lower = html.toLowerCase();
+  return lower.includes('<script') && (lower.includes('id="app"') || lower.includes('id="root"'));
+}
+
+function isWeakHttpContent(options: { html: string; title?: string; text: string }): boolean {
+  const normalizedText = options.text.replace(/\s+/g, ' ').trim();
+  const normalizedHtml = options.html.replace(/\s+/g, ' ').trim();
+  const textLength = normalizedText.length;
+  const htmlLength = normalizedHtml.length;
+  const hasGenericShellMarker = /enable javascript|javascript required|please turn on javascript/i.test(
+    options.html
+  );
+  const veryShortBody = textLength > 0 && textLength < 120;
+  const lowDensity = htmlLength > 0 && textLength / htmlLength < 0.02;
+
+  return veryShortBody && (lowDensity || hasGenericShellMarker);
+}
+
+export function createHttpFetcher({
+  fetchImpl = fetch
+}: {
+  fetchImpl?: typeof fetch;
+} = {}) {
+  return async function httpFetch(url: string): Promise<WebFetchResponse> {
+    const response = await fetchImpl(url);
+    const contentType = response.headers.get('content-type') ?? '';
+
+    if (!contentType.includes('text/html')) {
+      return {
+        status: 'unsupported',
+        url: response.url,
+        metadata: { method: 'http', cacheHit: false, contentType }
+      };
+    }
+
+    const html = await response.text();
+    const extraction = extractReadableContentSafely(html);
+    const content = extraction.content;
+
+    if (
+      looksLikeScriptShell(html) ||
+      content.text.length < 40 ||
+      isWeakHttpContent({ html, title: content.title, text: content.text })
+    ) {
+      return {
+        status: 'needs_headless',
+        url: response.url,
+        metadata: { method: 'http', cacheHit: false, contentType },
+        error: {
+          code: 'WEAK_EXTRACTION',
+          message: 'HTTP extraction was not reliable enough.'
+        }
+      };
+    }
+
+    return {
+      status: 'ok',
+      url: response.url,
+      content,
+      metadata: { method: 'http', cacheHit: false, contentType, truncated: content.text.length >= 4000 }
+    };
+  };
+}

package/dist/extensions/pi-web-agent/src/orchestration/answer-synthesizer.ts

@@ -1,60 +1,60 @@
-import type { ResearchEvidence } from './research-types.js';
-import type { EvidenceCaveatReason } from './evidence-quality.js';
-
-function normalizeSummary(summary: string) {
-  return summary.replace(/\s+/g, ' ').trim();
-}
-
-function sentenceForReason(reason: EvidenceCaveatReason): string {
-  switch (reason) {
-    case 'community-only':
-      return 'the strongest readable sources were mostly community/practical context';
-    case 'low-diversity':
-      return 'the source set was narrow';
-    case 'unreadable-direct-source':
-      return 'one or more linked sources could not be read reliably';
-    case 'unreadable-thread-source':
-      return 'one or more thread sources could not be read reliably';
-    case 'possible-conflict':
-      return 'readable sources include cautionary or possibly conflicting guidance';
-    case 'bot-check':
-      return 'some candidate sources showed bot-check or security verification pages';
-  }
-}
-
-function joinReasons(reasons: string[]) {
-  if (reasons.length === 0) return '';
-  if (reasons.length === 1) return reasons[0];
-  return `${reasons.slice(0, -1).join(', ')}, and ${reasons.at(-1)}`;
-}
-
-function caveatText(partial: boolean, caveatReasons: EvidenceCaveatReason[] = []) {
-  if (!partial) return undefined;
-  const specificReasons = caveatReasons.map(sentenceForReason);
-  if (specificReasons.length > 0) {
-    return `Evidence is partial: ${joinReasons(specificReasons)}.`;
-  }
-  return 'Evidence is partial, so this answer is based on the strongest source found within the bounded research budget.';
-}
-
-export function synthesizeAnswer({
-  evidence,
-  partial,
-  caveatReasons = []
-}: {
-  evidence: ResearchEvidence[];
-  partial: boolean;
-  caveatReasons?: EvidenceCaveatReason[];
-}) {
-  const findings = evidence.slice(0, 5).map((item) => {
-    const summary = normalizeSummary(item.summary);
-    return item.sourceKind === 'community' || item.sourceKind === 'issue-thread'
-      ? `Community/practical context: ${summary}`
-      : summary;
-  });
-
-  return {
-    findings,
-    caveat: caveatText(partial, caveatReasons)
-  };
-}
+import type { ResearchEvidence } from './research-types.js';
+import type { EvidenceCaveatReason } from './evidence-quality.js';
+
+function normalizeSummary(summary: string) {
+  return summary.replace(/\s+/g, ' ').trim();
+}
+
+function sentenceForReason(reason: EvidenceCaveatReason): string {
+  switch (reason) {
+    case 'community-only':
+      return 'the strongest readable sources were mostly community/practical context';
+    case 'low-diversity':
+      return 'the source set was narrow';
+    case 'unreadable-direct-source':
+      return 'one or more linked sources could not be read reliably';
+    case 'unreadable-thread-source':
+      return 'one or more thread sources could not be read reliably';
+    case 'possible-conflict':
+      return 'readable sources include cautionary or possibly conflicting guidance';
+    case 'bot-check':
+      return 'some candidate sources showed bot-check or security verification pages';
+  }
+}
+
+function joinReasons(reasons: string[]) {
+  if (reasons.length === 0) return '';
+  if (reasons.length === 1) return reasons[0];
+  return `${reasons.slice(0, -1).join(', ')}, and ${reasons.at(-1)}`;
+}
+
+function caveatText(partial: boolean, caveatReasons: EvidenceCaveatReason[] = []) {
+  if (!partial) return undefined;
+  const specificReasons = caveatReasons.map(sentenceForReason);
+  if (specificReasons.length > 0) {
+    return `Evidence is partial: ${joinReasons(specificReasons)}.`;
+  }
+  return 'Evidence is partial, so this answer is based on the strongest source found within the bounded research budget.';
+}
+
+export function synthesizeAnswer({
+  evidence,
+  partial,
+  caveatReasons = []
+}: {
+  evidence: ResearchEvidence[];
+  partial: boolean;
+  caveatReasons?: EvidenceCaveatReason[];
+}) {
+  const findings = evidence.slice(0, 5).map((item) => {
+    const summary = normalizeSummary(item.summary);
+    return item.sourceKind === 'community' || item.sourceKind === 'issue-thread'
+      ? `Community/practical context: ${summary}`
+      : summary;
+  });
+
+  return {
+    findings,
+    caveat: caveatText(partial, caveatReasons)
+  };
+}

package/dist/extensions/pi-web-agent/src/orchestration/candidate-selector.ts

@@ -1,12 +1,13 @@
 import type { SearchResult } from '../types.js';
-import { classifySourceProfile } from './source-profile.js';
+import { classifySourceProfile, hostOf } from './source-profile.js';
 
 function wantsDiscussionSources(query = '') {
   return /reddit|forum|forums|discussion|thread|comments|community|user experience|people recommend/i.test(query);
 }
 
 function candidateScore(result: SearchResult, query?: string) {
-  const url = result.url.toLowerCase();
+  const host = hostOf(result.url);
+  const isGithub = host === 'github.com' || (host?.endsWith('.github.com') ?? false);
   const profile = classifySourceProfile(result.url);
   const wantsThreads = wantsDiscussionSources(query);
 
@@ -16,13 +17,13 @@ function candidateScore(result: SearchResult, query?: string) {
   if (wantsThreads) {
     if (profile.kind === 'forum-thread') return 2;
     if (profile.kind === 'issue-thread') return 3;
-    if (url.includes('github.com/')) return 4;
+    if (isGithub) return 4;
     if (profile.kind === 'package-page') return 6;
     return 5;
   }
 
   if (profile.kind === 'issue-thread') return 2;
-  if (url.includes('github.com/')) return 3;
+  if (isGithub) return 3;
   if (profile.kind === 'package-page') return 5;
   return 4;
 }

package/dist/extensions/pi-web-agent/src/orchestration/direct-url.ts

@@ -1,13 +1,4 @@
-const TRACKING_PARAMS = new Set([
-  'utm_source',
-  'utm_medium',
-  'utm_campaign',
-  'utm_term',
-  'utm_content',
-  'utm_name',
-  'fbclid',
-  'gclid'
-]);
+import { canonicalizeUrl } from './url.js';
 
 function stripTrailingPunctuation(raw: string): string {
   let next = raw.trim();
@@ -22,21 +13,7 @@ function stripTrailingPunctuation(raw: string): string {
 }
 
 function normalizeDirectUrl(raw: string): string | undefined {
-  try {
-    const url = new URL(stripTrailingPunctuation(raw));
-    if (url.protocol !== 'http:' && url.protocol !== 'https:') return undefined;
-
-    for (const key of [...url.searchParams.keys()]) {
-      if (TRACKING_PARAMS.has(key.toLowerCase())) {
-        url.searchParams.delete(key);
-      }
-    }
-
-    url.hash = '';
-    return url.toString().replace(/\/$/, '');
-  } catch {
-    return undefined;
-  }
+  return canonicalizeUrl(stripTrailingPunctuation(raw), { canonicalizeHost: false });
 }
 
 export function extractDirectUrls(query: string): string[] {

package/dist/extensions/pi-web-agent/src/orchestration/evidence-quality.ts

@@ -15,6 +15,7 @@ export type EvidenceQualityReport = {
     community: number;
     thread: number;
     packagePage: number;
+    primaryContent: number;
     distinctHosts: number;
   };
   flags: {
@@ -65,11 +66,12 @@ export function analyzeEvidenceQuality({
   const community = evidence.filter((item) => item.sourceKind === 'community').length;
   const thread = evidence.filter((item) => item.sourceKind === 'issue-thread' || item.sourceKind === 'official-discussion').length;
   const packagePage = evidence.filter((item) => item.sourceKind === 'package-page').length;
+  const primaryContent = evidence.filter((item) => item.sourceKind === 'primary-content').length;
   const distinctHosts = new Set(evidence.map((item) => hostname(item.url))).size;
 
   const hasOfficialEvidence = official > 0;
-  const hasOnlyCommunityEvidence = evidence.length > 0 && official === 0;
-  const hasLowDiversity = evidence.length > 1 && distinctHosts <= 1;
+  const hasOnlyCommunityEvidence = evidence.length > 0 && official === 0 && primaryContent === 0;
+  const hasLowDiversity = evidence.length > 1 && distinctHosts <= 1 && primaryContent === 0;
   const hasUnreadableDirectSource = gaps.some((gap) => /Direct URL could not be read reliably/i.test(gap.message));
   const hasUnreadableThreadSource = gaps.some((gap) => /Thread source could not be read reliably/i.test(gap.message));
   const hasPossibleConflict = hasConflictMarkers(evidence);
@@ -90,6 +92,7 @@ export function analyzeEvidenceQuality({
       community,
       thread,
       packagePage,
+      primaryContent,
       distinctHosts
     },
     flags: {

package/dist/extensions/pi-web-agent/src/orchestration/evidence-ranker.ts

@@ -2,6 +2,8 @@ import type { ResearchEvidence } from './research-types.js';
 
 function sourceRank(sourceKind: ResearchEvidence['sourceKind']) {
   switch (sourceKind) {
+    case 'primary-content':
+      return -1;
     case 'official-docs':
       return 0;
     case 'official-api':

package/dist/extensions/pi-web-agent/src/orchestration/index.ts

@@ -1,28 +1,28 @@
-import { createBackendSet } from '../backends/factory.js';
-import type { BackendConfig } from '../backends/config.js';
-import type { WebFetchHeadlessResponse, WebFetchResponse, WebSearchResponse } from '../types.js';
-import { createResearchOrchestrator } from './research-orchestrator.js';
-import { createResearchWorker } from './research-worker.js';
-
-export function createResearchWorkflow({
-  backendConfig,
-  search,
-  fetchPage,
-  headlessFetch
-}: {
-  backendConfig?: BackendConfig;
-  search?: (input: { query: string }) => Promise<WebSearchResponse>;
-  fetchPage?: (input: { url: string }) => Promise<WebFetchResponse>;
-  headlessFetch?: (input: { url: string }) => Promise<WebFetchHeadlessResponse>;
-} = {}) {
-  const backends = createBackendSet(backendConfig);
-  const resolvedSearch = search ?? backends.search;
-  const resolvedFetchPage = fetchPage ?? backends.fetchPage;
-  const resolvedHeadlessFetch = headlessFetch ?? backends.headlessFetch;
-  const worker = createResearchWorker({ search: resolvedSearch, fetchPage: resolvedFetchPage });
-  return createResearchOrchestrator({
-    worker,
-    fetchDirect: resolvedFetchPage,
-    headlessFetch: resolvedHeadlessFetch
-  });
-}
+import { createBackendSet } from '../backends/factory.js';
+import type { BackendConfig } from '../backends/config.js';
+import type { WebFetchHeadlessResponse, WebFetchResponse, WebSearchResponse } from '../types.js';
+import { createResearchOrchestrator } from './research-orchestrator.js';
+import { createResearchWorker } from './research-worker.js';
+
+export function createResearchWorkflow({
+  backendConfig,
+  search,
+  fetchPage,
+  headlessFetch
+}: {
+  backendConfig?: BackendConfig;
+  search?: (input: { query: string }) => Promise<WebSearchResponse>;
+  fetchPage?: (input: { url: string }) => Promise<WebFetchResponse>;
+  headlessFetch?: (input: { url: string }) => Promise<WebFetchHeadlessResponse>;
+} = {}) {
+  const backends = createBackendSet(backendConfig);
+  const resolvedSearch = search ?? backends.search;
+  const resolvedFetchPage = fetchPage ?? backends.fetchPage;
+  const resolvedHeadlessFetch = headlessFetch ?? backends.headlessFetch;
+  const worker = createResearchWorker({ search: resolvedSearch, fetchPage: resolvedFetchPage });
+  return createResearchOrchestrator({
+    worker,
+    fetchDirect: resolvedFetchPage,
+    headlessFetch: resolvedHeadlessFetch
+  });
+}