@georgedong32/ccs 7.66.0

package/dist/utils/websearch/status.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * WebSearch Status and Readiness
+ *
+ * Provides status checking and display functions for WebSearch.
+ *
+ * @module utils/websearch/status
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.displayWebSearchStatus = exports.getWebSearchReadiness = exports.buildWebSearchReadiness = exports.getCliInstallHints = exports.hasAnyWebSearchCli = exports.getWebSearchCliProviders = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const ui_1 = require("../ui");
+const unified_config_loader_1 = require("../../config/unified-config-loader");
+const config_manager_1 = require("../config-manager");
+const gemini_cli_1 = require("./gemini-cli");
+const grok_cli_1 = require("./grok-cli");
+const opencode_cli_1 = require("./opencode-cli");
+const provider_secrets_1 = require("./provider-secrets");
+const PROVIDER_STATE_FILE = 'websearch-provider-state.json';
+function hasEnvValue(name) {
+    return (process.env[name] || '').trim().length > 0;
+}
+function getProviderStatePath() {
+    return (0, path_1.join)((0, config_manager_1.getCcsDir)(), 'cache', PROVIDER_STATE_FILE);
+}
+function readProviderCooldowns(now = Date.now()) {
+    try {
+        const statePath = getProviderStatePath();
+        if (!(0, fs_1.existsSync)(statePath)) {
+            return {};
+        }
+        const parsed = JSON.parse((0, fs_1.readFileSync)(statePath, 'utf8'));
+        const nextCooldowns = {};
+        for (const [providerId, entry] of Object.entries(parsed.cooldowns || {})) {
+            const until = Number.parseInt(String(entry?.until || ''), 10);
+            if (!Number.isFinite(until) || until <= now) {
+                continue;
+            }
+            nextCooldowns[providerId] = {
+                reason: typeof entry?.reason === 'string' ? entry.reason : 'rate_limited',
+                until,
+            };
+        }
+        return nextCooldowns;
+    }
+    catch {
+        return {};
+    }
+}
+function formatCooldownDuration(until, now = Date.now()) {
+    const remainingSec = Math.max(1, Math.ceil((until - now) / 1000));
+    if (remainingSec >= 3600) {
+        return `~${Math.ceil(remainingSec / 3600)}h`;
+    }
+    if (remainingSec >= 60) {
+        return `~${Math.ceil(remainingSec / 60)}m`;
+    }
+    return `~${remainingSec}s`;
+}
+function formatCooldownReason(reason) {
+    switch (reason) {
+        case 'quota_exhausted':
+            return 'quota exhaustion';
+        case 'rate_limited':
+            return 'rate limiting';
+        default:
+            return 'a temporary provider error';
+    }
+}
+function applyCooldownStatus(provider, cooldowns, now = Date.now()) {
+    if (!(provider.enabled && provider.available)) {
+        return provider;
+    }
+    const cooldown = cooldowns[provider.id];
+    if (!cooldown) {
+        return provider;
+    }
+    return {
+        ...provider,
+        available: false,
+        detail: `Cooling down ${formatCooldownDuration(cooldown.until, now)} after ${formatCooldownReason(cooldown.reason)}`,
+    };
+}
+function getLegacyProviderStatuses() {
+    const wsConfig = (0, unified_config_loader_1.getWebSearchConfig)();
+    const geminiStatus = (0, gemini_cli_1.getGeminiCliStatus)();
+    const grokStatus = (0, grok_cli_1.getGrokCliStatus)();
+    const opencodeStatus = (0, opencode_cli_1.getOpenCodeCliStatus)();
+    const geminiAuthed = geminiStatus.installed && (0, gemini_cli_1.isGeminiAuthenticated)();
+    return [
+        {
+            id: 'gemini',
+            kind: 'legacy-cli',
+            name: 'Gemini CLI',
+            command: 'gemini',
+            enabled: wsConfig.providers?.gemini?.enabled ?? false,
+            available: geminiAuthed,
+            version: geminiStatus.version ?? null,
+            installCommand: 'npm install -g @google/gemini-cli',
+            docsUrl: 'https://github.com/google-gemini/gemini-cli',
+            requiresApiKey: false,
+            description: 'Optional legacy LLM fallback with Google web search.',
+            detail: geminiStatus.installed
+                ? geminiAuthed
+                    ? 'Authenticated'
+                    : "Run 'gemini' to login"
+                : 'Not installed',
+        },
+        {
+            id: 'opencode',
+            kind: 'legacy-cli',
+            name: 'OpenCode',
+            command: 'opencode',
+            enabled: wsConfig.providers?.opencode?.enabled ?? false,
+            available: opencodeStatus.installed,
+            version: opencodeStatus.version ?? null,
+            installCommand: 'curl -fsSL https://opencode.ai/install | bash',
+            docsUrl: 'https://github.com/sst/opencode',
+            requiresApiKey: false,
+            description: 'Optional legacy LLM fallback via OpenCode.',
+            detail: opencodeStatus.installed ? 'Installed' : 'Not installed',
+        },
+        {
+            id: 'grok',
+            kind: 'legacy-cli',
+            name: 'Grok CLI',
+            command: 'grok',
+            enabled: wsConfig.providers?.grok?.enabled ?? false,
+            available: grokStatus.installed && hasEnvValue('GROK_API_KEY'),
+            version: grokStatus.version ?? null,
+            installCommand: 'npm install -g @vibe-kit/grok-cli',
+            docsUrl: 'https://github.com/superagent-ai/grok-cli',
+            requiresApiKey: true,
+            apiKeyEnvVar: 'GROK_API_KEY',
+            description: 'Optional legacy LLM fallback with xAI Grok.',
+            detail: grokStatus.installed
+                ? hasEnvValue('GROK_API_KEY')
+                    ? 'Ready'
+                    : 'Set GROK_API_KEY'
+                : 'Not installed',
+        },
+    ];
+}
+/**
+ * Get all WebSearch providers with their current status.
+ */
+function getWebSearchCliProviders() {
+    const wsConfig = (0, unified_config_loader_1.getWebSearchConfig)();
+    const apiKeyStates = (0, provider_secrets_1.getWebSearchApiKeyStates)();
+    const cooldowns = readProviderCooldowns();
+    const providers = [
+        {
+            id: 'exa',
+            kind: 'backend',
+            name: 'Exa',
+            enabled: wsConfig.providers?.exa?.enabled ?? false,
+            available: (wsConfig.providers?.exa?.enabled ?? false) && apiKeyStates.exa.available,
+            version: null,
+            docsUrl: 'https://docs.exa.ai/reference/search',
+            requiresApiKey: true,
+            apiKeyEnvVar: 'EXA_API_KEY',
+            description: 'API-backed search with strong relevance and content extraction.',
+            detail: apiKeyStates.exa.available
+                ? `API key detected (${wsConfig.providers?.exa?.max_results ?? 5} results)`
+                : apiKeyStates.exa.configured
+                    ? 'Stored in dashboard, but Global Env is disabled'
+                    : 'Set EXA_API_KEY',
+        },
+        {
+            id: 'tavily',
+            kind: 'backend',
+            name: 'Tavily',
+            enabled: wsConfig.providers?.tavily?.enabled ?? false,
+            available: (wsConfig.providers?.tavily?.enabled ?? false) && apiKeyStates.tavily.available,
+            version: null,
+            docsUrl: 'https://docs.tavily.com/documentation/api-reference/endpoint/search',
+            requiresApiKey: true,
+            apiKeyEnvVar: 'TAVILY_API_KEY',
+            description: 'Search API optimized for agent workflows and concise web result synthesis.',
+            detail: apiKeyStates.tavily.available
+                ? `API key detected (${wsConfig.providers?.tavily?.max_results ?? 5} results)`
+                : apiKeyStates.tavily.configured
+                    ? 'Stored in dashboard, but Global Env is disabled'
+                    : 'Set TAVILY_API_KEY',
+        },
+        {
+            id: 'duckduckgo',
+            kind: 'backend',
+            name: 'DuckDuckGo',
+            enabled: wsConfig.providers?.duckduckgo?.enabled ?? true,
+            available: wsConfig.providers?.duckduckgo?.enabled ?? true,
+            version: null,
+            docsUrl: 'https://duckduckgo.com',
+            requiresApiKey: false,
+            description: 'Default built-in HTML search backend. Zero setup.',
+            detail: `Built-in (${wsConfig.providers?.duckduckgo?.max_results ?? 5} results)`,
+        },
+        {
+            id: 'brave',
+            kind: 'backend',
+            name: 'Brave Search',
+            enabled: wsConfig.providers?.brave?.enabled ?? false,
+            available: (wsConfig.providers?.brave?.enabled ?? false) && apiKeyStates.brave.available,
+            version: null,
+            docsUrl: 'https://brave.com/search/api/',
+            requiresApiKey: true,
+            apiKeyEnvVar: 'BRAVE_API_KEY',
+            description: 'API-backed web search with cleaner result metadata.',
+            detail: apiKeyStates.brave.available
+                ? `API key detected (${wsConfig.providers?.brave?.max_results ?? 5} results)`
+                : apiKeyStates.brave.configured
+                    ? 'Stored in dashboard, but Global Env is disabled'
+                    : 'Set BRAVE_API_KEY',
+        },
+    ];
+    return [...providers, ...getLegacyProviderStatuses()].map((provider) => applyCooldownStatus(provider, cooldowns));
+}
+exports.getWebSearchCliProviders = getWebSearchCliProviders;
+/**
+ * Check if any WebSearch provider is currently ready.
+ */
+function hasAnyWebSearchCli() {
+    return getWebSearchCliProviders().some((provider) => provider.enabled && provider.available);
+}
+exports.hasAnyWebSearchCli = hasAnyWebSearchCli;
+/**
+ * Get setup hints when no providers are ready.
+ */
+function getCliInstallHints() {
+    if (hasAnyWebSearchCli()) {
+        return [];
+    }
+    return [
+        'WebSearch: no ready providers',
+        '    Enable DuckDuckGo in Settings > WebSearch for zero-setup search',
+        '    Or export EXA_API_KEY, TAVILY_API_KEY, or BRAVE_API_KEY for API-backed search',
+        '    Optional legacy fallback: npm i -g @google/gemini-cli',
+    ];
+}
+exports.getCliInstallHints = getCliInstallHints;
+function buildWebSearchReadiness(enabled, providers) {
+    if (!enabled) {
+        return {
+            readiness: 'unavailable',
+            message: 'Disabled in config',
+            providers,
+        };
+    }
+    const enabledProviders = providers.filter((provider) => provider.enabled);
+    const readyProviders = enabledProviders.filter((provider) => provider.available);
+    if (readyProviders.length > 0) {
+        return {
+            readiness: 'ready',
+            message: `Ready (${readyProviders.map((provider) => provider.name).join(' + ')})`,
+            providers,
+        };
+    }
+    if (enabledProviders.length > 0) {
+        return {
+            readiness: 'needs_setup',
+            message: enabledProviders
+                .map((provider) => `${provider.name}: ${provider.detail}`)
+                .join(' | '),
+            providers,
+        };
+    }
+    return {
+        readiness: 'unavailable',
+        message: 'Enable at least one provider in Settings > WebSearch',
+        providers,
+    };
+}
+exports.buildWebSearchReadiness = buildWebSearchReadiness;
+/**
+ * Get WebSearch readiness status for display.
+ */
+function getWebSearchReadiness() {
+    const wsConfig = (0, unified_config_loader_1.getWebSearchConfig)();
+    const providers = getWebSearchCliProviders();
+    return buildWebSearchReadiness(wsConfig.enabled, providers);
+}
+exports.getWebSearchReadiness = getWebSearchReadiness;
+/**
+ * Display WebSearch status (single line, equilibrium UX).
+ */
+function displayWebSearchStatus() {
+    const status = getWebSearchReadiness();
+    switch (status.readiness) {
+        case 'ready':
+            console.error((0, ui_1.ok)(`WebSearch: ${status.message}`));
+            break;
+        case 'needs_setup':
+            console.error((0, ui_1.warn)(`WebSearch: ${status.message}`));
+            break;
+        case 'unavailable':
+            console.error((0, ui_1.fail)(`WebSearch: ${status.message}`));
+            for (const [index, hint] of getCliInstallHints().entries()) {
+                console.error(index === 0 ? (0, ui_1.info)(hint) : hint);
+            }
+            break;
+    }
+}
+exports.displayWebSearchStatus = displayWebSearchStatus;
+//# sourceMappingURL=status.js.map

package/dist/utils/websearch/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/utils/websearch/status.ts"],"names":[],"mappings":"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"}

package/dist/utils/websearch/trace.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Best-effort WebSearch trace helpers.
+ *
+ * Writes opt-in JSONL trace records to ~/.ccs/logs/websearch-trace.jsonl so
+ * CCS can explain launch intent, MCP exposure, provider selection, and likely
+ * bypass scenarios without polluting Claude/MCP stdout.
+ */
+/// <reference types="node" />
+export declare function resolveAllowedWebSearchTraceFile(env?: NodeJS.ProcessEnv): string | null;
+export declare function isWebSearchTraceEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function appendWebSearchTrace(event: string, payload?: Record<string, unknown>, env?: NodeJS.ProcessEnv): void;
+export declare function readWebSearchTraceRecords(launchId: string, env?: NodeJS.ProcessEnv): Array<Record<string, unknown>>;
+export declare function createWebSearchTraceContext(params: {
+    launcher: string;
+    args: string[];
+    cwd?: string;
+    profile?: string;
+    profileType?: string;
+    settingsPath?: string;
+    claudeConfigDir?: string;
+    env?: NodeJS.ProcessEnv;
+}): Record<string, string>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/utils/websearch/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/utils/websearch/trace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;AAmFH,wBAAgB,gCAAgC,CAC9C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,IAAI,CAYf;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAErF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CAwBN;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBhC;AAoBD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqCzB"}

package/dist/utils/websearch/trace.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Best-effort WebSearch trace helpers.
+ *
+ * Writes opt-in JSONL trace records to ~/.ccs/logs/websearch-trace.jsonl so
+ * CCS can explain launch intent, MCP exposure, provider selection, and likely
+ * bypass scenarios without polluting Claude/MCP stdout.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSearchTraceContext = exports.readWebSearchTraceRecords = exports.appendWebSearchTrace = exports.isWebSearchTraceEnabled = exports.resolveAllowedWebSearchTraceFile = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const config_manager_1 = require("../config-manager");
+const TRACE_FILE_NAME = 'websearch-trace.jsonl';
+const NATIVE_WEBSEARCH_TOOL = 'WebSearch';
+const DISALLOWED_TOOLS_FLAG = '--disallowedTools';
+const APPEND_SYSTEM_PROMPT_FLAG = '--append-system-prompt';
+const THIRD_PARTY_WEBSEARCH_STEERING_PROMPT = 'For web lookup or current-information requests, prefer the CCS MCP tool WebSearch instead of Bash/curl/http fetches. If the user explicitly wants shell commands, or WebSearch is unavailable or fails, you may fall back to Bash/network tools.';
+function parseToolValue(rawValue) {
+    return rawValue
+        .split(',')
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+}
+function getImmediateFlagValue(args, index) {
+    const value = args[index + 1];
+    if (value === undefined || value === '--' || value.startsWith('--')) {
+        return null;
+    }
+    return value;
+}
+function hasToolInFlag(args, flag, toolName) {
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === flag) {
+            const value = getImmediateFlagValue(args, index);
+            if (value && parseToolValue(value).includes(toolName)) {
+                return true;
+            }
+            continue;
+        }
+        if (arg.startsWith(`${flag}=`)) {
+            const rawValue = arg.slice(flag.length + 1);
+            if (parseToolValue(rawValue).includes(toolName)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function hasExactFlagValue(args, flag, expectedValue) {
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === flag) {
+            if (getImmediateFlagValue(args, index) === expectedValue) {
+                return true;
+            }
+            continue;
+        }
+        if (arg === `${flag}=${expectedValue}`) {
+            return true;
+        }
+    }
+    return false;
+}
+function normalizeSafePrefix(inputPath) {
+    return `${path.resolve(inputPath)}${path.sep}`;
+}
+function getSafeTracePrefixes() {
+    return [
+        normalizeSafePrefix(path.join((0, config_manager_1.getCcsDir)(), 'logs')),
+        normalizeSafePrefix(os.tmpdir()),
+        normalizeSafePrefix('/var/log'),
+    ];
+}
+function resolveAllowedWebSearchTraceFile(env = process.env) {
+    const configured = env.CCS_WEBSEARCH_TRACE_FILE?.trim();
+    if (!configured) {
+        return null;
+    }
+    const resolved = path.resolve(configured);
+    if (getSafeTracePrefixes().some((prefix) => resolved.startsWith(prefix))) {
+        return resolved;
+    }
+    return null;
+}
+exports.resolveAllowedWebSearchTraceFile = resolveAllowedWebSearchTraceFile;
+function getTraceFilePath(env) {
+    return resolveAllowedWebSearchTraceFile(env) ?? path.join((0, config_manager_1.getCcsDir)(), 'logs', TRACE_FILE_NAME);
+}
+function isWebSearchTraceEnabled(env = process.env) {
+    return env.CCS_WEBSEARCH_TRACE === '1' || env.CCS_DEBUG === '1';
+}
+exports.isWebSearchTraceEnabled = isWebSearchTraceEnabled;
+function appendWebSearchTrace(event, payload = {}, env = process.env) {
+    if (!isWebSearchTraceEnabled(env)) {
+        return;
+    }
+    try {
+        const traceFilePath = getTraceFilePath(env);
+        fs.mkdirSync(path.dirname(traceFilePath), { recursive: true });
+        fs.appendFileSync(traceFilePath, JSON.stringify({
+            at: new Date().toISOString(),
+            event,
+            launchId: env.CCS_WEBSEARCH_TRACE_LAUNCH_ID || null,
+            launcher: env.CCS_WEBSEARCH_TRACE_LAUNCHER || null,
+            profileType: env.CCS_PROFILE_TYPE || null,
+            pid: process.pid,
+            ...payload,
+        }) + '\n', 'utf8');
+    }
+    catch {
+        // Tracing must never affect launch behavior.
+    }
+}
+exports.appendWebSearchTrace = appendWebSearchTrace;
+function readWebSearchTraceRecords(launchId, env = process.env) {
+    if (!launchId) {
+        return [];
+    }
+    try {
+        const traceFilePath = getTraceFilePath(env);
+        if (!fs.existsSync(traceFilePath)) {
+            return [];
+        }
+        return fs
+            .readFileSync(traceFilePath, 'utf8')
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0)
+            .map((line) => JSON.parse(line))
+            .filter((record) => record.launchId === launchId);
+    }
+    catch {
+        return [];
+    }
+}
+exports.readWebSearchTraceRecords = readWebSearchTraceRecords;
+function buildLaunchId() {
+    const random = Math.random().toString(36).slice(2, 10);
+    return `websearch-${Date.now()}-${process.pid}-${random}`;
+}
+function summarizeLaunchArgs(args) {
+    return {
+        argCount: args.length,
+        hasSettingsFlag: args.includes('--settings'),
+        nativeWebSearchDisallowed: hasToolInFlag(args, DISALLOWED_TOOLS_FLAG, NATIVE_WEBSEARCH_TOOL),
+        steeringPromptApplied: hasExactFlagValue(args, APPEND_SYSTEM_PROMPT_FLAG, THIRD_PARTY_WEBSEARCH_STEERING_PROMPT),
+    };
+}
+function createWebSearchTraceContext(params) {
+    const env = params.env ?? process.env;
+    if (!isWebSearchTraceEnabled(env)) {
+        return {};
+    }
+    const launchId = buildLaunchId();
+    const traceEnv = {
+        CCS_WEBSEARCH_TRACE: '1',
+        CCS_WEBSEARCH_TRACE_LAUNCH_ID: launchId,
+        CCS_WEBSEARCH_TRACE_LAUNCHER: params.launcher,
+    };
+    const traceFileOverride = resolveAllowedWebSearchTraceFile(env);
+    if (traceFileOverride) {
+        traceEnv.CCS_WEBSEARCH_TRACE_FILE = traceFileOverride;
+    }
+    appendWebSearchTrace('ccs_websearch_launch', {
+        launcher: params.launcher,
+        profile: params.profile || null,
+        profileType: params.profileType || null,
+        cwd: params.cwd || null,
+        settingsPath: params.settingsPath || null,
+        claudeConfigDir: params.claudeConfigDir || null,
+        ...summarizeLaunchArgs(params.args),
+    }, {
+        ...env,
+        ...traceEnv,
+        CCS_PROFILE_TYPE: params.profileType || env.CCS_PROFILE_TYPE || '',
+    });
+    return traceEnv;
+}
+exports.createWebSearchTraceContext = createWebSearchTraceContext;
+//# sourceMappingURL=trace.js.map

package/dist/utils/websearch/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/utils/websearch/trace.ts"],"names":[],"mappings":"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"}

package/dist/utils/websearch/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * WebSearch Type Definitions
+ *
+ * Contains all type definitions for WebSearch providers and status.
+ *
+ * @module utils/websearch/types
+ */
+import type { ComponentStatus } from '../../types/utils';
+/**
+ * Gemini CLI installation status
+ * @deprecated Use ComponentStatus directly
+ */
+export type GeminiCliStatus = ComponentStatus;
+/**
+ * Grok CLI installation status
+ * @deprecated Use ComponentStatus directly
+ */
+export type GrokCliStatus = ComponentStatus;
+/**
+ * OpenCode CLI installation status
+ * @deprecated Use ComponentStatus directly
+ */
+export type OpenCodeCliStatus = ComponentStatus;
+/**
+ * WebSearch availability status for third-party profiles
+ */
+export type WebSearchReadiness = 'ready' | 'needs_setup' | 'unavailable';
+/**
+ * WebSearch provider identifier
+ */
+export type WebSearchProviderId = 'exa' | 'tavily' | 'duckduckgo' | 'brave' | 'gemini' | 'grok' | 'opencode';
+/**
+ * Provider execution class.
+ */
+export type WebSearchProviderKind = 'backend' | 'legacy-cli';
+/**
+ * WebSearch provider information for health checks and UI
+ */
+export interface WebSearchCliInfo {
+    /** Provider ID */
+    id: WebSearchProviderId;
+    /** Backend vs legacy CLI */
+    kind: WebSearchProviderKind;
+    /** Display name */
+    name: string;
+    /** Command name for legacy providers */
+    command?: string;
+    /** Whether the provider is enabled in config */
+    enabled: boolean;
+    /** Whether the provider is ready right now */
+    available: boolean;
+    /** CLI version if applicable */
+    version: string | null;
+    /** Install or setup command when applicable */
+    installCommand?: string;
+    /** Docs URL */
+    docsUrl?: string;
+    /** Whether this provider requires an API key */
+    requiresApiKey: boolean;
+    /** API key environment variable name */
+    apiKeyEnvVar?: string;
+    /** Brief description */
+    description: string;
+    /** Summary detail shown in status UIs */
+    detail: string;
+}
+/**
+ * WebSearch status for display
+ */
+export interface WebSearchStatus {
+    readiness: WebSearchReadiness;
+    message: string;
+    providers: WebSearchCliInfo[];
+}
+/**
+ * WebSearch provider configuration from config.yaml
+ */
+export interface WebSearchProviderConfig {
+    enabled?: boolean;
+    model?: string;
+    timeout?: number;
+    max_results?: number;
+}
+/**
+ * WebSearch configuration from config.yaml
+ */
+export interface WebSearchConfig {
+    enabled: boolean;
+    providers?: {
+        exa?: WebSearchProviderConfig;
+        tavily?: WebSearchProviderConfig;
+        duckduckgo?: WebSearchProviderConfig;
+        brave?: WebSearchProviderConfig;
+        gemini?: WebSearchProviderConfig;
+        opencode?: WebSearchProviderConfig;
+        grok?: WebSearchProviderConfig;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/websearch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/websearch/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,MAAM,GACN,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,EAAE,EAAE,mBAAmB,CAAC;IACxB,4BAA4B;IAC5B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,uBAAuB,CAAC;QAC9B,MAAM,CAAC,EAAE,uBAAuB,CAAC;QACjC,UAAU,CAAC,EAAE,uBAAuB,CAAC;QACrC,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,MAAM,CAAC,EAAE,uBAAuB,CAAC;QACjC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;QACnC,IAAI,CAAC,EAAE,uBAAuB,CAAC;KAChC,CAAC;CACH"}