@demigodmode/pi-web-agent 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -7,13 +7,41 @@ The format is intentionally simple and release-oriented.
 ## Unreleased
 
 ### Added
-- Nothing yet.
+- None.
+
+### Changed
+- None.
+
+### Fixed
+- None.
+
+### 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.
+- `/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.
 
 ### Changed
-- Nothing yet.
+- None.
 
 ### Fixed
-- Nothing yet.
+- Updated vulnerable dependency paths reported by `npm audit`, including Vitest, Pi dev tooling, `undici`, `ws`, `protobufjs`, `postcss`, and the Vite docs toolchain override.
 
 ### Breaking
 - None.
@@ -30,7 +58,7 @@ The format is intentionally simple and release-oriented.
 - Backend config validation and fallback metadata now understand Brave, including clear `fallbackFrom: 'brave'` reporting when DuckDuckGo fallback is used.
 
 ### Fixed
-- Nothing yet.
+- None.
 
 ### Breaking
 - None.
@@ -44,7 +72,7 @@ The format is intentionally simple and release-oriented.
 - Partial research caveats are now more specific when evidence is community-only, low-diversity, blocked, or cautionary.
 
 ### Fixed
-- Nothing yet.
+- None.
 
 ### Breaking
 - None.
@@ -71,10 +99,10 @@ The format is intentionally simple and release-oriented.
 - Added interactive URL prompts for SearXNG and Firecrawl backend setup.
 
 ### Changed
-- Nothing yet.
+- None.
 
 ### Fixed
-- Nothing yet.
+- None.
 
 ### Breaking
 - None.
@@ -89,7 +117,7 @@ The format is intentionally simple and release-oriented.
 - `/web-agent show` and `/web-agent doctor` now report configured backend fallback/options.
 
 ### Fixed
-- Nothing yet.
+- None.
 
 ### Breaking
 - None.
@@ -102,7 +130,7 @@ The format is intentionally simple and release-oriented.
 - Migrated Pi package imports to `@earendil-works/*` after the upstream Pi scope move.
 
 ### Fixed
-- Nothing yet.
+- None.
 
 ### Breaking
 - This release requires Pi 0.74+. Users on older Pi versions should stay on `@demigodmode/pi-web-agent@0.6.x` until they update Pi.
@@ -126,10 +154,10 @@ The format is intentionally simple and release-oriented.
 
 ## [0.5.1] - 2026-05-04
 ### Added
-- Nothing yet.
+- None.
 
 ### Changed
-- Nothing yet.
+- None.
 
 ### Fixed
 - Fixed the Windows browser-resolution test so it is deterministic on Linux CI.
@@ -174,7 +202,7 @@ The format is intentionally simple and release-oriented.
 
 ## [0.3.1] - 2026-04-22
 ### Added
-- Nothing yet.
+- None.
 
 ### Changed
 - Stopped self-upgrading npm inside the publish workflow before install and publish steps.
@@ -222,10 +250,10 @@ The format is intentionally simple and release-oriented.
 
 ## [0.2.1] - 2026-04-20
 ### Added
-- Nothing yet.
+- None.
 
 ### Changed
-- Nothing yet.
+- None.
 
 ### Fixed
 - Added the missing npm `--provenance` flag to the publish workflow so Trusted Publishing can exchange the GitHub OIDC token correctly.

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,7 @@ 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.
 
 Backend settings can be changed from:
 
@@ -117,9 +117,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.
 
-If you already run SearXNG or Firecrawl, see the self-hosted backend guide:
+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.js

@@ -124,7 +124,7 @@ 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',
@@ -135,8 +135,8 @@ function buildBackendSettingsItems(scope, backends) {
         {
             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 +144,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',
@@ -255,7 +261,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 +272,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 {

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.0",
+  "version": "1.6.0",
   "description": "Pi package for reliable web access with explicit search, fetch, and headless boundaries.",
   "type": "module",
   "main": "./dist/extension.js",
@@ -61,17 +61,20 @@
     "typebox": "^1.1.37"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.74.0",
-    "@earendil-works/pi-tui": "^0.74.0",
+    "@earendil-works/pi-coding-agent": "^0.79.10",
+    "@earendil-works/pi-tui": "^0.79.10",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^24.0.0",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.6",
     "typescript": "^5.8.0",
     "vitepress": "^1.6.4",
-    "vitest": "^3.2.0"
+    "vitest": "^3.2.6"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
+  },
+  "overrides": {
+    "vite": "6.4.3"
   }
 }