@demigodmode/pi-web-agent 1.5.1 → 1.6.1

package/CHANGELOG.md

@@ -18,6 +18,37 @@ The format is intentionally simple and release-oriented.
 ### Breaking
 - None.
 
+## [1.6.1] - 2026-07-05
+### Added
+- None.
+
+### Changed
+- None.
+
+### Fixed
+- Setting a SearXNG URL from **Settings → Backends** now actually saves, and switches the search provider to `searxng` if it wasn't already selected. Previously the URL was silently discarded unless SearXNG was already the active provider. Reported by @Josephur in #33.
+- Same fix applied on the fetch side: setting a Firecrawl URL now switches the fetch provider to `firecrawl` too, instead of leaving it stuck on `http` until you flip it manually.
+- Editing the SearXNG/Firecrawl base URL no longer opens a separate nested input prompt on top of the settings list (which could leave the session unresponsive to further input). It's now an inline field in the same list, and pressing Esc there only cancels the field instead of closing the whole settings screen and discarding unrelated pending changes.
+- The inline URL field now starts with the cursor at the end of the pre-filled value, so typing right away appends instead of inserting at the front of the string.
+
+### Breaking
+- None.
+
+## [1.6.0] - 2026-07-05
+### Added
+- You.com is now available as a hosted search backend for `web_explore`, selectable alongside DuckDuckGo, SearXNG, and Brave. Set `YDC_API_KEY` in the environment and choose `youcom` from **Settings → Backends**. You.com handles source discovery only; `web_explore` still fetches pages, ranks evidence, handles caveats, and synthesizes the answer itself. Contributed by @ydc-oss-bot in #32 - first outside PR this project has had.
+- `/web-agent settings` now treats You.com as a first-class search backend (with optional DuckDuckGo fallback) while keeping API keys out of config files via `YDC_API_KEY`.
+- `/web-agent doctor` now reports You.com setup status, warns when `YDC_API_KEY` is missing, and validates configured You.com access when a key is present.
+
+### Changed
+- None.
+
+### Fixed
+- None.
+
+### Breaking
+- None.
+
 ## [1.5.1] - 2026-06-22
 ### Added
 - None.

package/README.md

@@ -27,7 +27,7 @@ Headless rendering first tries a detectable Chromium-family browser: Chrome, Chr
 Later on, update installed packages with:
 
 ```bash
-pi update
+pi update --extensions
 ```
 
 ## Docs
@@ -109,7 +109,9 @@ Example:
 }
 ```
 
-Backend config is also supported. Defaults remain DuckDuckGo search, plain HTTP fetch, and local-browser headless fallback with managed Chromium fallback configured. If you have a Brave Search API key, Brave can be selected as a hosted search backend while `web_explore` still handles page reading, ranking, and caveats itself.
+Backend config is also supported. Defaults remain DuckDuckGo search, plain HTTP fetch, and local-browser headless fallback with managed Chromium fallback configured. If you have a Brave Search or You.com API key, either can be selected as a hosted search backend while `web_explore` still handles page reading, ranking, and caveats itself.
+
+Search backends: DuckDuckGo (default), SearXNG (self-hosted), Brave Search (hosted), You.com (hosted).
 
 Backend settings can be changed from:
 
@@ -117,9 +119,9 @@ Backend settings can be changed from:
 /web-agent settings
 ```
 
-Choose **Backends** to edit search/fetch providers, fallback behavior, and SearXNG or Firecrawl base URLs interactively. Brave Search uses `PI_WEB_AGENT_BRAVE_API_KEY`. Firecrawl API keys should also stay in environment variables rather than being written into config files.
+Choose **Backends** to edit search/fetch providers, fallback behavior, and SearXNG or Firecrawl base URLs interactively. Brave Search uses `PI_WEB_AGENT_BRAVE_API_KEY` and You.com uses `YDC_API_KEY`. Firecrawl API keys should also stay in environment variables rather than being written into config files.
 
-For the full backend config shape, including SearXNG, Brave, Firecrawl, and fallback behavior, see:
+For the full backend config shape, including SearXNG, Brave, You.com, Firecrawl, and fallback behavior, see:
 
 - https://demigodmode.github.io/pi-web-agent/self-hosted-backends
 

package/dist/backends/config.d.ts

@@ -8,7 +8,7 @@ export type FirecrawlOptions = {
     onlyMainContent?: boolean;
 };
 export type SearchBackendConfig = {
-    provider: 'duckduckgo' | 'searxng' | 'brave';
+    provider: 'duckduckgo' | 'searxng' | 'brave' | 'youcom';
     baseUrl?: string;
     fallback?: 'duckduckgo';
     options?: SearxngOptions;

package/dist/backends/config.js

@@ -40,7 +40,8 @@ export function extractBackendConfigOverride(file) {
     const override = {};
     if (backends?.search?.provider === 'duckduckgo' ||
         backends?.search?.provider === 'searxng' ||
-        backends?.search?.provider === 'brave') {
+        backends?.search?.provider === 'brave' ||
+        backends?.search?.provider === 'youcom') {
         override.search = { provider: backends.search.provider };
         if (backends.search.provider === 'searxng' && typeof backends.search.baseUrl === 'string') {
             override.search.baseUrl = backends.search.baseUrl;
@@ -84,8 +85,8 @@ export function validateBackendConfig(config) {
     if (config.fetch.provider === 'firecrawl' && !config.fetch.baseUrl) {
         issues.push('fetch provider firecrawl requires backends.fetch.baseUrl');
     }
-    if (config.search.fallback === 'duckduckgo' && config.search.provider !== 'searxng' && config.search.provider !== 'brave') {
-        issues.push('search fallback duckduckgo is only supported when search provider is searxng or brave');
+    if (config.search.fallback === 'duckduckgo' && config.search.provider !== 'searxng' && config.search.provider !== 'brave' && config.search.provider !== 'youcom') {
+        issues.push('search fallback duckduckgo is only supported when search provider is searxng, brave, or youcom');
     }
     if (config.fetch.fallback === 'http' && config.fetch.provider !== 'firecrawl') {
         issues.push('fetch fallback http is only supported when fetch provider is firecrawl');

package/dist/backends/doctor.js

@@ -12,6 +12,9 @@ function braveDoctorUrl() {
     url.searchParams.set('count', '1');
     return url.toString();
 }
+function youcomDoctorBody() {
+    return JSON.stringify({ query: 'pi-web-agent-doctor', max_results: 1 });
+}
 function searxngDoctorUrl(baseUrl, options = {}) {
     const url = new URL('/search', baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`);
     url.searchParams.set('q', 'pi-web-agent-doctor');
@@ -69,6 +72,42 @@ export async function checkBackendHealth(config, { fetchImpl = fetch, timeoutMs
             }
         }
     }
+    else if (config.search.provider === 'youcom') {
+        const apiKey = process.env.YDC_API_KEY;
+        if (!apiKey?.trim()) {
+            lines.push('search backend: youcom warning (missing YDC_API_KEY)');
+        }
+        else {
+            const timeout = withTimeout(timeoutMs);
+            try {
+                const response = await fetchImpl('https://api.you.com/v1/agents/search', {
+                    method: 'POST',
+                    headers: {
+                        Accept: 'application/json',
+                        'Content-Type': 'application/json',
+                        'X-API-Key': apiKey
+                    },
+                    body: youcomDoctorBody(),
+                    signal: timeout.signal
+                });
+                if (!response.ok) {
+                    lines.push(`search backend: youcom warning (HTTP ${response.status})`);
+                }
+                else {
+                    const json = (await response.json());
+                    lines.push(Array.isArray(json.results)
+                        ? 'search backend: youcom ok'
+                        : 'search backend: youcom warning (unexpected response)');
+                }
+            }
+            catch (error) {
+                lines.push(`search backend: youcom warning (${message(error)})`);
+            }
+            finally {
+                timeout.done();
+            }
+        }
+    }
     else if (!config.search.baseUrl) {
         lines.push('search backend: searxng warning (missing baseUrl)');
     }

package/dist/backends/factory.d.ts

@@ -1,5 +1,6 @@
 import { createFirecrawlFetcher } from '../fetch/firecrawl-fetch.js';
 import { createBraveSearchTool } from '../search/brave.js';
+import { createYouComSearchTool } from '../search/youcom.js';
 import { createSearxngSearchTool } from '../search/searxng.js';
 import { createWebFetchHeadlessTool } from '../tools/web-fetch-headless.js';
 import { createWebFetchTool } from '../tools/web-fetch.js';
@@ -21,6 +22,7 @@ export type BackendFactoryDeps = {
     createDuckDuckGoSearch?: typeof createWebSearchTool;
     createSearxngSearch?: typeof createSearxngSearchTool;
     createBraveSearch?: typeof createBraveSearchTool;
+    createYouComSearch?: typeof createYouComSearchTool;
     createHttpFetch?: typeof createWebFetchTool;
     createFirecrawlFetch?: typeof createFirecrawlFetcher;
     createHeadlessFetch?: typeof createWebFetchHeadlessTool;

package/dist/backends/factory.js

@@ -1,5 +1,6 @@
 import { createFirecrawlFetcher } from '../fetch/firecrawl-fetch.js';
 import { createBraveSearchTool } from '../search/brave.js';
+import { createYouComSearchTool } from '../search/youcom.js';
 import { createSearxngSearchTool } from '../search/searxng.js';
 import { buildFetchPresentation } from '../presentation/fetch-presentation.js';
 import { buildSearchPresentation } from '../presentation/search-presentation.js';
@@ -73,6 +74,7 @@ export function createBackendSet(config = DEFAULT_BACKEND_CONFIG, deps = {}) {
     const createDuckDuckGoSearch = deps.createDuckDuckGoSearch ?? createWebSearchTool;
     const createSearxngSearch = deps.createSearxngSearch ?? createSearxngSearchTool;
     const createBraveSearch = deps.createBraveSearch ?? createBraveSearchTool;
+    const createYouComSearch = deps.createYouComSearch ?? createYouComSearchTool;
     const createHttpFetch = deps.createHttpFetch ?? createWebFetchTool;
     const createFirecrawlFetch = deps.createFirecrawlFetch ?? createFirecrawlFetcher;
     const createHeadlessFetch = deps.createHeadlessFetch ?? createWebFetchHeadlessTool;
@@ -82,13 +84,18 @@ export function createBackendSet(config = DEFAULT_BACKEND_CONFIG, deps = {}) {
             : invalidSearxngSearch()
         : config.search.provider === 'brave'
             ? createBraveSearch({ apiKey: process.env.PI_WEB_AGENT_BRAVE_API_KEY })
-            : createDuckDuckGoSearch();
+            : config.search.provider === 'youcom'
+                ? createYouComSearch({ apiKey: process.env.YDC_API_KEY })
+                : createDuckDuckGoSearch();
     if (config.search.provider === 'searxng' && config.search.fallback === 'duckduckgo') {
         search = withSearchFallback(search, createDuckDuckGoSearch(), 'searxng');
     }
     if (config.search.provider === 'brave' && config.search.fallback === 'duckduckgo') {
         search = withSearchFallback(search, createDuckDuckGoSearch(), 'brave');
     }
+    if (config.search.provider === 'youcom' && config.search.fallback === 'duckduckgo') {
+        search = withSearchFallback(search, createDuckDuckGoSearch(), 'youcom');
+    }
     const httpFetch = createHttpFetch();
     let fetchPage = config.fetch.provider === 'firecrawl'
         ? config.fetch.baseUrl

package/dist/commands/web-agent-config.d.ts

@@ -1,5 +1,6 @@
 import { type BackendConfig, type BackendConfigOverride } from '../backends/config.js';
 import { type ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { type Component } from '@earendil-works/pi-tui';
 import { loadPresentationConfigLayers, type LoadedPresentationConfig } from '../presentation/config-store.js';
 import { type BrowserResolutionResult } from '../fetch/browser-resolution.js';
 import type { PresentationConfig, PresentationConfigOverride, PresentationScope } from '../presentation/types.js';
@@ -32,6 +33,7 @@ export declare function validateBackendUrl(value: string): {
     ok: false;
     message: string;
 };
+export declare function createBackendUrlEditor(theme: any, label: string, placeholderUrl: string, onOpenChange?: (open: boolean) => void): (currentValue: string, done: (selectedValue?: string) => void) => Component;
 export declare function getInheritedConfigForScope(loaded: Awaited<LoadedPresentationConfig>, scope: PresentationScope): PresentationConfig;
 export declare function getScopeDisplayConfig(loaded: Awaited<LoadedPresentationConfig>, scope: PresentationScope): PresentationConfig;
 export declare function getInheritedBackendsForScope(loaded: Awaited<LoadedPresentationConfig>, scope: PresentationScope): BackendConfig;

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

@@ -1,7 +1,7 @@
 import { DEFAULT_BACKEND_CONFIG, mergeBackendConfigLayers, validateBackendConfig } from '../backends/config.js';
 import { checkBackendHealth } from '../backends/doctor.js';
 import { DynamicBorder, getSettingsListTheme } from '@earendil-works/pi-coding-agent';
-import { Container, SelectList, SettingsList, Text } from '@earendil-works/pi-tui';
+import { Container, Input, SelectList, SettingsList, Text } from '@earendil-works/pi-tui';
 import { DEFAULT_PRESENTATION_CONFIG, mergePresentationConfigLayers, resolvePresentationMode } from '../presentation/config.js';
 import { loadPresentationConfigLayers, resetPresentationConfigScope, saveBackendConfigScope, savePresentationConfigScope } from '../presentation/config-store.js';
 import { resolveBrowserExecutable } from '../fetch/browser-resolution.js';
@@ -112,7 +112,49 @@ function buildPresentationSettingsItems(scope, config) {
         }))
     ];
 }
-function buildBackendSettingsItems(scope, backends) {
+export function createBackendUrlEditor(theme, label, placeholderUrl, onOpenChange) {
+    return (currentValue, done) => {
+        onOpenChange?.(true);
+        const initialValue = currentValue && currentValue !== 'not set' ? currentValue : placeholderUrl;
+        const container = new Container();
+        const hint = new Text(theme.fg('muted', `${label} · enter to save · empty clears · esc cancels`), 1, 0);
+        const input = new Input();
+        input.setValue(initialValue);
+        input.handleInput('\x1b[F'); // move cursor to end; setValue leaves it at 0
+        input.focused = true;
+        const errorText = new Text('', 1, 0);
+        const finish = (selectedValue) => {
+            onOpenChange?.(false);
+            done(selectedValue);
+        };
+        const showError = (message) => {
+            errorText.setText(theme.fg('warning', message));
+            container.invalidate();
+        };
+        input.onSubmit = (value) => {
+            if (!value.trim()) {
+                finish('');
+                return;
+            }
+            const validated = validateBackendUrl(value);
+            if (!validated.ok) {
+                showError(validated.message);
+                return;
+            }
+            finish(validated.value);
+        };
+        input.onEscape = () => finish(undefined);
+        container.addChild(hint);
+        container.addChild(input);
+        container.addChild(errorText);
+        return {
+            render: (width) => container.render(width),
+            invalidate: () => container.invalidate(),
+            handleInput: (data) => input.handleInput(data)
+        };
+    };
+}
+function buildBackendSettingsItems(scope, backends, theme, onUrlEditorOpenChange) {
     return [
         {
             id: 'scope',
@@ -124,19 +166,19 @@ function buildBackendSettingsItems(scope, backends) {
             id: 'backend:search:provider',
             label: 'Search backend',
             currentValue: backends.search.provider,
-            values: ['duckduckgo', 'searxng', 'brave']
+            values: ['duckduckgo', 'searxng', 'brave', 'youcom']
         },
         {
             id: 'backend:search:baseUrl',
             label: 'SearXNG URL',
             currentValue: backends.search.baseUrl ?? 'not set',
-            values: ['edit']
+            submenu: createBackendUrlEditor(theme, 'SearXNG base URL', 'http://localhost:8080', onUrlEditorOpenChange)
         },
         {
             id: 'backend:search:fallback',
             label: 'Search fallback',
-            currentValue: backends.search.provider === 'searxng' || backends.search.provider === 'brave' ? backends.search.fallback ?? 'off' : 'off',
-            values: backends.search.provider === 'searxng' || backends.search.provider === 'brave' ? ['off', 'duckduckgo'] : ['off']
+            currentValue: backends.search.provider === 'searxng' || backends.search.provider === 'brave' || backends.search.provider === 'youcom' ? backends.search.fallback ?? 'off' : 'off',
+            values: backends.search.provider === 'searxng' || backends.search.provider === 'brave' || backends.search.provider === 'youcom' ? ['off', 'duckduckgo'] : ['off']
         },
         {
             id: 'backend:secret:brave',
@@ -144,6 +186,12 @@ function buildBackendSettingsItems(scope, backends) {
             currentValue: 'env var',
             values: ['env var']
         },
+        {
+            id: 'backend:secret:youcom',
+            label: 'You.com API key',
+            currentValue: 'env var',
+            values: ['env var']
+        },
         {
             id: 'backend:fetch:provider',
             label: 'Fetch backend',
@@ -154,7 +202,7 @@ function buildBackendSettingsItems(scope, backends) {
             id: 'backend:fetch:baseUrl',
             label: 'Firecrawl URL',
             currentValue: backends.fetch.baseUrl ?? 'not set',
-            values: ['edit']
+            submenu: createBackendUrlEditor(theme, 'Firecrawl base URL', 'http://localhost:3002', onUrlEditorOpenChange)
         },
         {
             id: 'backend:fetch:fallback',
@@ -255,7 +303,7 @@ export function applySettingsValue(state, id, newValue) {
         }
         currentDraft.tools = nextTools;
     }
-    if (id === 'backend:search:provider' && (newValue === 'duckduckgo' || newValue === 'searxng' || newValue === 'brave')) {
+    if (id === 'backend:search:provider' && (newValue === 'duckduckgo' || newValue === 'searxng' || newValue === 'brave' || newValue === 'youcom')) {
         currentBackends.search.provider = newValue;
         if (newValue !== 'searxng') {
             delete currentBackends.search.baseUrl;
@@ -266,7 +314,7 @@ export function applySettingsValue(state, id, newValue) {
         }
     }
     if (id === 'backend:search:fallback') {
-        if (newValue === 'duckduckgo' && (currentBackends.search.provider === 'searxng' || currentBackends.search.provider === 'brave')) {
+        if (newValue === 'duckduckgo' && (currentBackends.search.provider === 'searxng' || currentBackends.search.provider === 'brave' || currentBackends.search.provider === 'youcom')) {
             currentBackends.search.fallback = 'duckduckgo';
         }
         else {
@@ -274,7 +322,8 @@ export function applySettingsValue(state, id, newValue) {
         }
     }
     if (id === 'backend:search:baseUrl') {
-        if (currentBackends.search.provider === 'searxng' && newValue.trim()) {
+        if (newValue.trim()) {
+            currentBackends.search.provider = 'searxng';
             currentBackends.search.baseUrl = newValue.trim();
         }
         else {
@@ -297,6 +346,7 @@ export function applySettingsValue(state, id, newValue) {
     }
     if (id === 'backend:fetch:baseUrl') {
         if (newValue.trim()) {
+            currentBackends.fetch.provider = 'firecrawl';
             currentBackends.fetch.baseUrl = newValue.trim();
         }
         else {
@@ -488,43 +538,20 @@ async function openPresentationSettingsUi(ctx, loaded, initialScope) {
     });
 }
 async function openBackendSettingsUi(ctx, loaded, initialScope) {
-    return ctx.ui.custom((tui, theme, _kb, done) => {
+    return ctx.ui.custom((_tui, theme, _kb, done) => {
         let state = createSettingsDraftState(loaded, initialScope);
         let settingsList;
+        let urlEditorOpen = false;
         const container = new Container();
         container.addChild(new Text(theme.fg('accent', theme.bold('pi-web-agent · backends')), 1, 1));
         container.addChild(new Text(theme.fg('muted', 'Ctrl+S save · Ctrl+R reset scope · Esc cancel · API keys stay in env vars'), 1, 2));
-        const editUrl = async (id) => {
-            const isSearchUrl = id === 'backend:search:baseUrl';
-            const label = isSearchUrl ? 'SearXNG base URL' : 'Firecrawl base URL';
-            const currentValue = isSearchUrl ? state.backends.search.baseUrl : state.backends.fetch.baseUrl;
-            const entered = await ctx.ui.input(label, currentValue ?? (isSearchUrl ? 'http://localhost:8080' : 'http://localhost:3002'));
-            if (entered === undefined)
-                return;
-            if (!entered.trim()) {
-                state = applySettingsValue(state, id, '');
-                rebuildSettingsList();
-                tui.requestRender?.();
-                return;
-            }
-            const validated = validateBackendUrl(entered);
-            if (!validated.ok) {
-                ctx.ui.notify(validated.message, 'warning');
-                return;
-            }
-            state = applySettingsValue(state, id, validated.value);
-            rebuildSettingsList();
-            tui.requestRender?.();
-        };
         const rebuildSettingsList = () => {
             if (settingsList) {
                 container.removeChild(settingsList);
             }
-            settingsList = new SettingsList(buildBackendSettingsItems(state.scope, state.backends), 12, getSettingsListTheme(), (id, newValue) => {
-                if (id === 'backend:search:baseUrl' || id === 'backend:fetch:baseUrl') {
-                    void editUrl(id);
-                    return;
-                }
+            settingsList = new SettingsList(buildBackendSettingsItems(state.scope, state.backends, theme, (open) => {
+                urlEditorOpen = open;
+            }), 12, getSettingsListTheme(), (id, newValue) => {
                 state = applySettingsValue(state, id, newValue);
                 rebuildSettingsList();
                 container.invalidate();
@@ -536,6 +563,13 @@ async function openBackendSettingsUi(ctx, loaded, initialScope) {
             render: (width) => container.render(width),
             invalidate: () => container.invalidate(),
             handleInput: (data) => {
+                // While the inline URL editor is open, let it (and its own Escape/Enter
+                // handling) consume input first — otherwise these shortcuts close the
+                // whole settings UI out from under an in-progress edit.
+                if (urlEditorOpen) {
+                    settingsList.handleInput?.(data);
+                    return;
+                }
                 const shortcut = handleSettingsShortcut(JSON.stringify(data).slice(1, -1));
                 if (shortcut?.action === 'cancel') {
                     done({ action: 'cancel' });

package/dist/search/youcom.d.ts

@@ -0,0 +1,7 @@
+import type { WebSearchResponse } from '../types.js';
+export declare function createYouComSearchTool({ apiKey, fetchImpl }: {
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+}): ({ query }: {
+    query: string;
+}) => Promise<WebSearchResponse>;

package/dist/search/youcom.js

@@ -0,0 +1,81 @@
+import { buildSearchPresentation } from '../presentation/search-presentation.js';
+const YOUCOM_SEARCH_URL = 'https://api.you.com/v1/agents/search';
+function resultWithPresentation(result) {
+    return { ...result, presentation: buildSearchPresentation(result) };
+}
+function normalizeResults(response) {
+    return (response.results ?? []).flatMap((item) => {
+        if (typeof item.title !== 'string' || typeof item.url !== 'string') {
+            return [];
+        }
+        return [
+            {
+                title: item.title,
+                url: item.url,
+                snippet: typeof item.snippet === 'string' ? item.snippet : ''
+            }
+        ];
+    });
+}
+export function createYouComSearchTool({ apiKey, fetchImpl = fetch }) {
+    return async function youComSearch({ query }) {
+        const normalizedQuery = query.trim();
+        if (!normalizedQuery) {
+            return resultWithPresentation({
+                status: 'error',
+                results: [],
+                metadata: { backend: 'youcom', cacheHit: false },
+                error: { code: 'INVALID_QUERY', message: 'Query must not be empty.' }
+            });
+        }
+        if (!apiKey?.trim()) {
+            return resultWithPresentation({
+                status: 'error',
+                results: [],
+                metadata: { backend: 'youcom', cacheHit: false },
+                error: {
+                    code: 'BACKEND_CONFIG_INVALID',
+                    message: 'You.com search requires YDC_API_KEY.'
+                }
+            });
+        }
+        try {
+            const response = await fetchImpl(YOUCOM_SEARCH_URL, {
+                method: 'POST',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                    'X-API-Key': apiKey
+                },
+                body: JSON.stringify({ query: normalizedQuery, max_results: 10 })
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const parsed = (await response.json());
+            const results = normalizeResults(parsed);
+            if (results.length === 0) {
+                return resultWithPresentation({
+                    status: 'error',
+                    results: [],
+                    metadata: { backend: 'youcom', cacheHit: false },
+                    error: { code: 'NO_RESULTS', message: 'You.com returned no usable results for this query.' }
+                });
+            }
+            return resultWithPresentation({
+                status: 'ok',
+                results,
+                metadata: { backend: 'youcom', cacheHit: false }
+            });
+        }
+        catch (error) {
+            const rawMessage = error instanceof Error ? error.message : String(error);
+            return resultWithPresentation({
+                status: 'error',
+                results: [],
+                metadata: { backend: 'youcom', cacheHit: false },
+                error: { code: 'FETCH_FAILED', message: `You.com search request failed: ${rawMessage}` }
+            });
+        }
+    };
+}

package/dist/types.d.ts

@@ -11,9 +11,9 @@ export type ToolError = {
     message: string;
 };
 export type SearchMetadata = {
-    backend: 'duckduckgo' | 'searxng' | 'brave';
+    backend: 'duckduckgo' | 'searxng' | 'brave' | 'youcom';
     cacheHit: boolean;
-    fallbackFrom?: 'searxng' | 'brave';
+    fallbackFrom?: 'searxng' | 'brave' | 'youcom';
     fallbackReason?: string;
 };
 export type FetchMetadata = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@demigodmode/pi-web-agent",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "Pi package for reliable web access with explicit search, fetch, and headless boundaries.",
   "type": "module",
   "main": "./dist/extension.js",
@@ -21,7 +21,12 @@
     "pi",
     "extension",
     "web-search",
-    "web-fetch"
+    "web-fetch",
+    "duckduckgo",
+    "searxng",
+    "brave-search",
+    "you-com",
+    "firecrawl"
   ],
   "repository": {
     "type": "git",