@demigodmode/pi-web-agent 1.7.2 → 1.9.0

package/CHANGELOG.md

@@ -18,6 +18,34 @@ The format is intentionally simple and release-oriented.
 ### Breaking
 - None.
 
+## [1.9.0] - 2026-08-15
+### Added
+- Search fanout. Ask a hard question and web_explore can now hit several of your configured search backends at once, dedupe the merged results, and rank the pages that more than one provider agreed on to the top. Off by default. Flip it to on or auto in Settings → Backends (auto only fans out when the first provider comes back thin, so easy queries stay cheap). Preview/verbose shows which providers ran and which got skipped. (#35)
+
+### Changed
+- None.
+
+### Fixed
+- web_explore can finally summarize a link you hand it. Paste a GitHub file/issue/PR, a PDF, or a YouTube URL and ask for a summary: it now reads the actual content (raw source, extracted PDF text, the video transcript) and gives the model the whole thing. 1.8.0 added these readers but then squeezed everything down to a ~180-char snippet before the model ever saw it, so summaries were basically guesswork. Now they're grounded in the real text (long content still capped around 24k characters). (#40, #41)
+- Fanout won't stall on a dead provider anymore. Each one gets an 8s timeout, so an unreachable self-hosted SearXNG can't hang a whole research pass. (#35)
+- Fanout only offers and queries the providers you've actually set up (keyless DuckDuckGo, SearXNG when you give it a URL, the hosted ones only when their key is present) instead of acting like all six are on. (#35)
+
+### Breaking
+- None.
+
+## [1.8.0] - 2026-08-14
+### Added
+- Read the content behind GitHub, PDF, and YouTube links directly instead of the page shell. GitHub files, issues and PRs come from the API/raw endpoints (optional `GITHUB_TOKEN` raises the rate limit), PDFs are parsed with unpdf, and YouTube links return the transcript (long content capped around 24k characters). All keyless. Scanned PDFs and caption-less videos are caveated rather than failing. (#39, #40, #41)
+
+### Changed
+- None.
+
+### Fixed
+- None.
+
+### Breaking
+- None.
+
 ## [1.7.2] - 2026-08-12
 ### Added
 - None.

package/dist/backends/config.d.ts

@@ -1,8 +1,13 @@
+import type { FanoutMode, SearchProviderName } from '../types.js';
 export type SearxngOptions = {
     categories?: string[];
     language?: string;
     safesearch?: 0 | 1 | 2;
 };
+export type FanoutConfig = {
+    mode: FanoutMode;
+    providers?: SearchProviderName[];
+};
 export type FirecrawlOptions = {
     formats?: string[];
     onlyMainContent?: boolean;
@@ -12,6 +17,7 @@ export type SearchBackendConfig = {
     baseUrl?: string;
     fallback?: 'duckduckgo';
     options?: SearxngOptions;
+    fanout?: FanoutConfig;
 };
 export type FetchBackendConfig = {
     provider: 'http' | 'firecrawl';
@@ -40,6 +46,7 @@ export type BackendConfigFile = {
             baseUrl?: unknown;
             fallback?: unknown;
             options?: unknown;
+            fanout?: unknown;
         };
         fetch?: {
             provider?: unknown;
@@ -54,6 +61,7 @@ export type BackendConfigFile = {
     };
 };
 export declare const DEFAULT_BACKEND_CONFIG: BackendConfig;
+export declare function usableSearchProviders(search: SearchBackendConfig, env?: NodeJS.ProcessEnv): SearchProviderName[];
 export declare function extractBackendConfigOverride(file: BackendConfigFile | null | undefined): BackendConfigOverride;
 export declare function validateBackendConfig(config: BackendConfig): string[];
 export declare function mergeBackendConfigLayers(...layers: Array<BackendConfig | BackendConfigOverride | undefined>): BackendConfig;

package/dist/backends/config.js

@@ -35,6 +35,38 @@ function extractFirecrawlOptions(value) {
         options.onlyMainContent = raw.onlyMainContent;
     return Object.keys(options).length > 0 ? options : undefined;
 }
+const PROVIDER_NAMES = ['duckduckgo', 'searxng', 'brave', 'youcom', 'exa', 'tavily'];
+export function usableSearchProviders(search, env = process.env) {
+    // Match the provider implementations, which treat a blank/whitespace key as unconfigured.
+    const usable = ['duckduckgo']; // keyless, always usable
+    if (search.baseUrl?.trim())
+        usable.push('searxng');
+    if (env.PI_WEB_AGENT_BRAVE_API_KEY?.trim())
+        usable.push('brave');
+    if (env.YDC_API_KEY?.trim())
+        usable.push('youcom');
+    if (env.EXA_API_KEY?.trim())
+        usable.push('exa');
+    if (env.TAVILY_API_KEY?.trim())
+        usable.push('tavily');
+    return usable;
+}
+function extractFanoutConfig(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const raw = value;
+    if (raw.mode !== 'off' && raw.mode !== 'on' && raw.mode !== 'auto')
+        return undefined;
+    const config = { mode: raw.mode };
+    if (Array.isArray(raw.providers)) {
+        const providers = raw.providers.filter((p) => typeof p === 'string' && PROVIDER_NAMES.includes(p));
+        if (providers.length !== raw.providers.length)
+            return undefined; // fail loud on any invalid entry
+        if (providers.length > 0)
+            config.providers = providers;
+    }
+    return config;
+}
 export function extractBackendConfigOverride(file) {
     const backends = file?.backends;
     const override = {};
@@ -58,6 +90,10 @@ export function extractBackendConfigOverride(file) {
             }
         }
     }
+    const fanout = extractFanoutConfig(backends?.search?.fanout);
+    if (fanout) {
+        override.search = { ...(override.search ?? {}), fanout };
+    }
     if (backends?.fetch?.provider === 'http' || backends?.fetch?.provider === 'firecrawl') {
         override.fetch = { provider: backends.fetch.provider };
         if (typeof backends.fetch.baseUrl === 'string') {
@@ -106,6 +142,15 @@ export function validateBackendConfig(config) {
     if (config.fetch.options?.formats && config.fetch.options.formats.length === 0) {
         issues.push('fetch options.formats must contain at least one format when provided');
     }
+    const fanout = config.search.fanout;
+    if (fanout) {
+        if (fanout.mode !== 'off' && fanout.mode !== 'on' && fanout.mode !== 'auto') {
+            issues.push('search fanout.mode must be off, on, or auto');
+        }
+        if (fanout.providers?.includes('searxng') && !config.search.baseUrl) {
+            issues.push('search fanout with searxng requires backends.search.baseUrl');
+        }
+    }
     return issues;
 }
 function mergeSearchConfig(current, override) {

package/dist/backends/doctor.js

@@ -208,6 +208,39 @@ export async function checkBackendHealth(config, { fetchImpl = fetch, timeoutMs
     if (config.search.fallback) {
         lines.push(`search fallback: ${config.search.fallback}`);
     }
+    if (config.search.fanout && config.search.fanout.mode !== 'off') {
+        const providers = config.search.fanout.providers || ['duckduckgo', 'searxng', 'brave', 'youcom', 'exa', 'tavily'];
+        lines.push(`search fanout: ${config.search.fanout.mode} (${providers.join(', ')})`);
+        for (const provider of providers) {
+            if (provider === 'searxng' && !config.search.baseUrl) {
+                lines.push('search fanout provider searxng warning (missing baseUrl)');
+            }
+            else if (provider === 'brave') {
+                const apiKey = process.env.PI_WEB_AGENT_BRAVE_API_KEY;
+                if (!apiKey?.trim()) {
+                    lines.push('search fanout provider brave warning (missing PI_WEB_AGENT_BRAVE_API_KEY)');
+                }
+            }
+            else if (provider === 'youcom') {
+                const apiKey = process.env.YDC_API_KEY;
+                if (!apiKey?.trim()) {
+                    lines.push('search fanout provider youcom warning (missing YDC_API_KEY)');
+                }
+            }
+            else if (provider === 'exa') {
+                const apiKey = process.env.EXA_API_KEY;
+                if (!apiKey?.trim()) {
+                    lines.push('search fanout provider exa warning (missing EXA_API_KEY)');
+                }
+            }
+            else if (provider === 'tavily') {
+                const apiKey = process.env.TAVILY_API_KEY;
+                if (!apiKey?.trim()) {
+                    lines.push('search fanout provider tavily warning (missing TAVILY_API_KEY)');
+                }
+            }
+        }
+    }
     if (config.fetch.provider === 'http') {
         lines.push('fetch backend: http');
     }

package/dist/backends/factory.js

@@ -4,12 +4,17 @@ import { createYouComSearchTool } from '../search/youcom.js';
 import { createExaSearchTool } from '../search/exa.js';
 import { createTavilySearchTool } from '../search/tavily.js';
 import { createSearxngSearchTool } from '../search/searxng.js';
+import { createFanoutSearch } from '../search/fanout.js';
 import { buildFetchPresentation } from '../presentation/fetch-presentation.js';
 import { buildSearchPresentation } from '../presentation/search-presentation.js';
 import { createWebFetchHeadlessTool } from '../tools/web-fetch-headless.js';
 import { createWebFetchTool } from '../tools/web-fetch.js';
 import { createWebSearchTool } from '../tools/web-search.js';
-import { DEFAULT_BACKEND_CONFIG } from './config.js';
+import { DEFAULT_BACKEND_CONFIG, usableSearchProviders } from './config.js';
+import { createSpecialContentResolver } from '../readers/resolver.js';
+import { createGithubReader } from '../readers/github-reader.js';
+import { createPdfReader } from '../readers/pdf-reader.js';
+import { createYoutubeReader } from '../readers/youtube-reader.js';
 function invalidSearxngSearch() {
     return async function search() {
         const result = {
@@ -82,6 +87,25 @@ export function createBackendSet(config = DEFAULT_BACKEND_CONFIG, deps = {}) {
     const createHttpFetch = deps.createHttpFetch ?? createWebFetchTool;
     const createFirecrawlFetch = deps.createFirecrawlFetch ?? createFirecrawlFetcher;
     const createHeadlessFetch = deps.createHeadlessFetch ?? createWebFetchHeadlessTool;
+    function buildProviderSearch(name) {
+        switch (name) {
+            case 'searxng':
+                return config.search.baseUrl
+                    ? createSearxngSearch({ baseUrl: config.search.baseUrl, options: config.search.options })
+                    : invalidSearxngSearch();
+            case 'brave':
+                return createBraveSearch({ apiKey: process.env.PI_WEB_AGENT_BRAVE_API_KEY });
+            case 'youcom':
+                return createYouComSearch({ apiKey: process.env.YDC_API_KEY });
+            case 'exa':
+                return createExaSearch({ apiKey: process.env.EXA_API_KEY });
+            case 'tavily':
+                return createTavilySearch({ apiKey: process.env.TAVILY_API_KEY });
+            case 'duckduckgo':
+            default:
+                return createDuckDuckGoSearch();
+        }
+    }
     let search = config.search.provider === 'searxng'
         ? config.search.baseUrl
             ? createSearxngSearch({ baseUrl: config.search.baseUrl, options: config.search.options })
@@ -110,6 +134,21 @@ export function createBackendSet(config = DEFAULT_BACKEND_CONFIG, deps = {}) {
     if (config.search.provider === 'tavily' && config.search.fallback === 'duckduckgo') {
         search = withSearchFallback(search, createDuckDuckGoSearch(), 'tavily');
     }
+    const fanoutConfig = config.search.fanout;
+    if (fanoutConfig && fanoutConfig.mode !== 'off') {
+        const baseNames = fanoutConfig.providers && fanoutConfig.providers.length > 0
+            ? fanoutConfig.providers
+            : usableSearchProviders(config.search);
+        // A configured DuckDuckGo fallback must still be honored under fanout: fold it into the set.
+        const providerNames = config.search.fallback === 'duckduckgo' && !baseNames.includes('duckduckgo')
+            ? [...baseNames, 'duckduckgo']
+            : baseNames;
+        const ordered = [config.search.provider, ...providerNames.filter((n) => n !== config.search.provider)].filter((n, i, arr) => arr.indexOf(n) === i);
+        search = createFanoutSearch({
+            providers: ordered.map((name) => ({ name, search: buildProviderSearch(name) })),
+            mode: fanoutConfig.mode
+        });
+    }
     const httpFetch = createHttpFetch();
     let fetchPage = config.fetch.provider === 'firecrawl'
         ? config.fetch.baseUrl
@@ -125,9 +164,13 @@ export function createBackendSet(config = DEFAULT_BACKEND_CONFIG, deps = {}) {
     if (config.fetch.provider === 'firecrawl' && config.fetch.fallback === 'http') {
         fetchPage = withFetchFallback(fetchPage, httpFetch);
     }
+    const fetchPageWithReaders = createSpecialContentResolver({
+        readers: [createGithubReader(), createPdfReader(), createYoutubeReader()],
+        fallback: fetchPage
+    });
     return {
         search,
-        fetchPage,
+        fetchPage: fetchPageWithReaders,
         headlessFetch: createHeadlessFetch()
     };
 }

package/dist/commands/web-agent-config.js

@@ -1,4 +1,4 @@
-import { DEFAULT_BACKEND_CONFIG, mergeBackendConfigLayers, validateBackendConfig } from '../backends/config.js';
+import { DEFAULT_BACKEND_CONFIG, mergeBackendConfigLayers, validateBackendConfig, usableSearchProviders } from '../backends/config.js';
 import { checkBackendHealth } from '../backends/doctor.js';
 import { DynamicBorder, getSettingsListTheme } from '@earendil-works/pi-coding-agent';
 import { Container, Input, SelectList, SettingsList, Text } from '@earendil-works/pi-tui';
@@ -20,7 +20,10 @@ function cloneBackendConfig(config) {
     return {
         search: {
             ...config.search,
-            options: config.search.options ? { ...config.search.options } : undefined
+            options: config.search.options ? { ...config.search.options } : undefined,
+            fanout: config.search.fanout
+                ? { mode: config.search.fanout.mode, providers: config.search.fanout.providers ? [...config.search.fanout.providers] : undefined }
+                : undefined
         },
         fetch: {
             ...config.fetch,
@@ -54,12 +57,16 @@ async function defaultCheckTypebox() {
     }
 }
 function formatSearchOptions(config) {
-    return [
+    const parts = [
         config.fallback ? `fallback ${config.fallback}` : undefined,
         config.options?.categories?.length ? `categories ${config.options.categories.join(',')}` : undefined,
         config.options?.language ? `language ${config.options.language}` : undefined,
-        config.options?.safesearch !== undefined ? `safesearch ${config.options.safesearch}` : undefined
-    ].filter(Boolean).join(' ');
+        config.options?.safesearch !== undefined ? `safesearch ${config.options.safesearch}` : undefined,
+        config.fanout && config.fanout.mode !== 'off'
+            ? `fanout ${config.fanout.mode} (${(config.fanout.providers || usableSearchProviders(config)).join(', ')})`
+            : undefined
+    ].filter(Boolean);
+    return parts.join(' ');
 }
 function formatFetchOptions(config) {
     return [
@@ -155,6 +162,9 @@ export function createBackendUrlEditor(theme, label, placeholderUrl, onOpenChang
     };
 }
 function buildBackendSettingsItems(scope, backends, theme, onUrlEditorOpenChange) {
+    const usable = usableSearchProviders(backends.search);
+    const fanoutMode = backends.search.fanout?.mode ?? 'off';
+    const fanoutProviders = backends.search.fanout?.providers ?? usable;
     return [
         {
             id: 'scope',
@@ -180,6 +190,18 @@ function buildBackendSettingsItems(scope, backends, theme, onUrlEditorOpenChange
             currentValue: backends.search.provider === 'searxng' || backends.search.provider === 'brave' || backends.search.provider === 'youcom' || backends.search.provider === 'exa' || backends.search.provider === 'tavily' ? backends.search.fallback ?? 'off' : 'off',
             values: backends.search.provider === 'searxng' || backends.search.provider === 'brave' || backends.search.provider === 'youcom' || backends.search.provider === 'exa' || backends.search.provider === 'tavily' ? ['off', 'duckduckgo'] : ['off']
         },
+        {
+            id: 'backend:search:fanout:mode',
+            label: 'Search fanout',
+            currentValue: fanoutMode,
+            values: ['off', 'on', 'auto']
+        },
+        ...(fanoutMode !== 'off' ? usable.map((provider) => ({
+            id: `backend:search:fanout:provider:${provider}`,
+            label: `  ${provider}`,
+            currentValue: fanoutProviders.includes(provider) ? 'included' : 'excluded',
+            values: ['included', 'excluded']
+        })) : []),
         {
             id: 'backend:secret:brave',
             label: 'Brave API key',
@@ -333,6 +355,40 @@ export function applySettingsValue(state, id, newValue) {
             delete currentBackends.search.fallback;
         }
     }
+    if (id === 'backend:search:fanout:mode') {
+        if (newValue === 'off') {
+            currentBackends.search.fanout = { mode: 'off' };
+        }
+        else if (newValue === 'on' || newValue === 'auto') {
+            currentBackends.search.fanout = {
+                mode: newValue,
+                providers: undefined
+            };
+        }
+    }
+    if (id.startsWith('backend:search:fanout:provider:')) {
+        const providerName = id.slice('backend:search:fanout:provider:'.length);
+        const usableProviders = usableSearchProviders(currentBackends.search);
+        // Ensure fanout exists
+        if (!currentBackends.search.fanout) {
+            currentBackends.search.fanout = { mode: 'on', providers: undefined };
+        }
+        // Materialize the provider list if it's currently undefined; use usable providers instead of all
+        const currentProviders = currentBackends.search.fanout.providers ?? usableProviders;
+        if (newValue === 'excluded') {
+            // Remove the provider from the list
+            const filtered = currentProviders.filter((p) => p !== providerName);
+            // never allow an empty set: keep at least one provider (empty would be read as "all")
+            if (filtered.length > 0) {
+                currentBackends.search.fanout.providers = filtered;
+            }
+        }
+        else if (newValue === 'included') {
+            // Add the provider back, maintaining canonical order using usable providers
+            const result = usableProviders.filter((p) => currentProviders.includes(p) || p === providerName);
+            currentBackends.search.fanout.providers = result;
+        }
+    }
     if (id === 'backend:search:baseUrl') {
         if (newValue.trim()) {
             currentBackends.search.provider = 'searxng';
@@ -400,7 +456,8 @@ export function collapseBackendConfigToOverride(config, inheritedConfig) {
             : {
                 ...(config.search.baseUrl !== inheritedConfig.search.baseUrl ? { baseUrl: config.search.baseUrl } : {}),
                 ...(config.search.fallback !== inheritedConfig.search.fallback ? { fallback: config.search.fallback } : {}),
-                ...(!sameJson(config.search.options, inheritedConfig.search.options) ? { options: config.search.options } : {})
+                ...(!sameJson(config.search.options, inheritedConfig.search.options) ? { options: config.search.options } : {}),
+                ...(!sameJson(config.search.fanout, inheritedConfig.search.fanout) ? { fanout: config.search.fanout } : {})
             };
         if (config.search.provider !== inheritedConfig.search.provider) {
             override.search.provider = config.search.provider;

package/dist/extension.js

@@ -7,6 +7,30 @@ import { loadPresentationConfigLayers } from './presentation/config-store.js';
 import { selectPresentationView } from './presentation/select-view.js';
 import { createWebExploreTool } from './tools/web-explore.js';
 import { getUpdateChangelogNotice } from './changelog-notice.js';
+import { Text } from '@earendil-works/pi-tui';
+/**
+ * What the model receives as the tool result: the actual synthesized findings (which for a
+ * direct GitHub/PDF/YouTube read is the full extracted content), plus source citations and any
+ * caveat. This is separate from the terminal display (see renderResult), so the model always
+ * gets the substance regardless of the user's compact/preview/verbose presentation setting.
+ */
+function serializeForModel(result) {
+    if (result.status === 'error') {
+        return `Research failed: ${result.error?.message ?? 'Unknown research failure.'}`;
+    }
+    if (result.findings.length === 0 && result.sources.length === 0) {
+        return 'No usable evidence found.';
+    }
+    return [
+        result.findings.join('\n\n'),
+        result.sources.length
+            ? `Sources:\n${result.sources.map((source) => `- ${source.title}: ${source.url}`).join('\n')}`
+            : undefined,
+        result.caveat
+    ]
+        .filter(Boolean)
+        .join('\n\n');
+}
 async function loadWebAgentConfig(pi) {
     const store = pi.__presentationConfigStore;
     return store?.load?.() ?? loadPresentationConfigLayers();
@@ -29,11 +53,6 @@ async function getEffectiveBackendConfig(pi) {
         return DEFAULT_BACKEND_CONFIG;
     }
 }
-async function renderToolText(pi, toolName, details) {
-    const config = await getEffectivePresentationConfig(pi);
-    const mode = resolvePresentationMode(toolName, config);
-    return selectPresentationView(details.presentation, mode) ?? JSON.stringify(details, null, 2);
-}
 export default function extension(pi) {
     registerWebAgentConfigCommands(pi);
     const injectedWebExplore = pi.__webExploreTool;
@@ -79,16 +98,38 @@ export default function extension(pi) {
         async execute(_toolCallId, params) {
             const webExplore = await getConfiguredWebExplore();
             const result = await webExplore({ query: params.query });
+            // Terminal display honors the user's presentation mode; the model gets the full findings.
+            // The fallback must stay terse: never fall back to serializeForModel here, or a missing
+            // presentation would dump the full findings into the terminal.
+            const mode = resolvePresentationMode('web_explore', await getEffectivePresentationConfig(pi));
+            const terseFallback = 'web_explore result';
+            const terminalText = selectPresentationView(result.presentation, mode) ?? terseFallback;
+            const terminalTextExpanded = selectPresentationView(result.presentation, 'verbose') ?? terminalText;
             return {
-                content: [
-                    {
-                        type: 'text',
-                        text: await renderToolText(pi, 'web_explore', result)
-                    }
-                ],
-                details: result,
+                content: [{ type: 'text', text: serializeForModel(result) }],
+                details: { ...result, terminalText, terminalTextExpanded },
                 isError: result.status === 'error'
             };
+        },
+        renderResult(toolResult, options) {
+            const details = toolResult.details;
+            try {
+                // Legacy fallback: results persisted before this change carry `presentation` but no
+                // `terminalText`, so old sessions stay readable instead of rendering blank.
+                const legacy = options.expanded
+                    ? details?.presentation?.views?.verbose ?? details?.presentation?.views?.compact
+                    : details?.presentation?.views?.compact;
+                const text = (options.expanded ? details?.terminalTextExpanded : details?.terminalText) ??
+                    details?.terminalText ??
+                    legacy ??
+                    'web_explore result';
+                return new Text(text, 0, 0);
+            }
+            catch {
+                // Never throw: a thrown renderer makes Pi fall back to raw content, which would dump
+                // the full model-facing findings into the terminal.
+                return new Text('web_explore result', 0, 0);
+            }
         }
     });
 }

package/dist/orchestration/direct-url.js

@@ -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) {
     let next = raw.trim();
     while (/[),.;!?\]]$/.test(next)) {
@@ -19,21 +10,7 @@ function stripTrailingPunctuation(raw) {
     return next;
 }
 function normalizeDirectUrl(raw) {
-    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) {
     const matches = query.match(/https?:\/\/\S+/gi) ?? [];

package/dist/orchestration/evidence-quality.d.ts

@@ -7,6 +7,7 @@ export type EvidenceQualityReport = {
         community: number;
         thread: number;
         packagePage: number;
+        primaryContent: number;
         distinctHosts: number;
     };
     flags: {

package/dist/orchestration/evidence-quality.js

@@ -25,10 +25,11 @@ export function analyzeEvidenceQuality({ evidence, gaps, lowValueOutcomes }) {
     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);
@@ -47,6 +48,7 @@ export function analyzeEvidenceQuality({ evidence, gaps, lowValueOutcomes }) {
             community,
             thread,
             packagePage,
+            primaryContent,
             distinctHosts
         },
         flags: {

package/dist/orchestration/evidence-ranker.js

@@ -1,5 +1,7 @@
 function sourceRank(sourceKind) {
     switch (sourceKind) {
+        case 'primary-content':
+            return -1;
         case 'official-docs':
             return 0;
         case 'official-api':

package/dist/orchestration/index.d.ts

@@ -24,6 +24,8 @@ export declare function createResearchWorkflow({ backendConfig, search, fetchPag
             headlessAttempts: number;
             exhaustedBudget: boolean;
             caveatReasons: import("./evidence-quality.js").EvidenceCaveatReason[];
+            fanoutProviders: import("../types.js").SearchProviderName[] | undefined;
+            fanoutSkipped: import("../types.js").SearchProviderName[] | undefined;
         };
     }>;
 };

package/dist/orchestration/research-orchestrator.d.ts

@@ -1,4 +1,4 @@
-import type { WebFetchHeadlessResponse, WebFetchResponse } from '../types.js';
+import type { SearchProviderName, WebFetchHeadlessResponse, WebFetchResponse } from '../types.js';
 import type { ResearchEvidence, ResearchOrchestratorDecision, ResearchWorkerResult } from './research-types.js';
 import { type EvidenceCaveatReason } from './evidence-quality.js';
 export declare function createResearchOrchestrator({ worker, fetchDirect, headlessFetch }: {
@@ -28,6 +28,8 @@ export declare function createResearchOrchestrator({ worker, fetchDirect, headle
             headlessAttempts: number;
             exhaustedBudget: boolean;
             caveatReasons: EvidenceCaveatReason[];
+            fanoutProviders: SearchProviderName[] | undefined;
+            fanoutSkipped: SearchProviderName[] | undefined;
         };
     }>;
 };