@georgedong32/ccs 7.66.0

package/dist/utils/websearch/profile-hook-injector.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Profile Hook Injector
+ *
+ * Injects the legacy WebSearch compatibility hook into per-profile settings files.
+ * The first-class runtime now uses the CCS-managed MCP server; these hooks remain
+ * for compatibility and migration safety only.
+ *
+ * @module utils/websearch/profile-hook-injector
+ */
+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.ensureProfileHooksOrThrow = exports.ensureProfileHooks = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("../ui");
+const hook_config_1 = require("./hook-config");
+const unified_config_loader_1 = require("../../config/unified-config-loader");
+const hook_config_2 = require("./hook-config");
+const config_manager_1 = require("../config-manager");
+const hook_utils_1 = require("./hook-utils");
+const hook_installer_1 = require("./hook-installer");
+// Valid profile name pattern (alphanumeric, dash, underscore only)
+const VALID_PROFILE_NAME = /^[a-zA-Z0-9_-]+$/;
+function hasUsableHookBinary() {
+    try {
+        const hookPath = (0, hook_config_1.getHookPath)();
+        const stat = fs.statSync(hookPath);
+        if (!stat.isFile()) {
+            return false;
+        }
+        fs.accessSync(hookPath, fs.constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if CCS WebSearch hook exists in settings
+ */
+function hasCcsHook(settings) {
+    const hooks = settings.hooks;
+    if (!hooks?.PreToolUse)
+        return false;
+    return hooks.PreToolUse.some((h) => {
+        return (0, hook_utils_1.isCcsWebSearchHook)(h);
+    });
+}
+/**
+ * Migrate CCS hook from global settings to profile settings (one-time)
+ */
+function migrateGlobalHook() {
+    const markerPath = (0, hook_installer_1.getMigrationMarkerPath)();
+    if (fs.existsSync(markerPath)) {
+        return; // Already migrated
+    }
+    try {
+        const removed = (0, hook_config_2.removeHookConfig)();
+        if (removed && process.env.CCS_DEBUG) {
+            console.error((0, ui_1.info)('Migrated WebSearch hook from global settings'));
+        }
+        // Ensure CCS dir exists before creating marker
+        const ccsDir = (0, config_manager_1.getCcsDir)();
+        if (!fs.existsSync(ccsDir)) {
+            fs.mkdirSync(ccsDir, { recursive: true, mode: 0o700 });
+        }
+        // Create marker file atomically (wx = fail if exists, prevents race condition)
+        fs.writeFileSync(markerPath, new Date().toISOString(), { encoding: 'utf8', flag: 'wx' });
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Migration failed: ${error.message}`));
+        }
+    }
+}
+/**
+ * Ensure the legacy WebSearch compatibility hook is configured in a profile's
+ * settings file when that path is still needed.
+ *
+ * @param profileName - Name of the profile (e.g., 'agy', 'gemini', 'glm')
+ * @returns true if hook is configured (existing or newly added)
+ */
+function ensureProfileHooks(profileName) {
+    try {
+        // Validate profile name to prevent path traversal
+        if (!VALID_PROFILE_NAME.test(profileName)) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)(`Invalid profile name: ${profileName}`));
+            }
+            return false;
+        }
+        const wsConfig = (0, unified_config_loader_1.getWebSearchConfig)();
+        // Skip if WebSearch is disabled
+        if (!wsConfig.enabled) {
+            return false;
+        }
+        // Get CCS directory (respects CCS_HOME for test isolation)
+        const ccsDir = (0, config_manager_1.getCcsDir)();
+        const settingsPath = path.join(ccsDir, `${profileName}.settings.json`);
+        // Read existing settings or create empty
+        let settings = {};
+        if (fs.existsSync(settingsPath)) {
+            try {
+                const content = fs.readFileSync(settingsPath, 'utf8');
+                settings = JSON.parse(content);
+            }
+            catch (parseError) {
+                if (process.env.CCS_DEBUG) {
+                    console.error((0, ui_1.warn)(`Malformed ${profileName}.settings.json: ${parseError.message}`));
+                }
+                // Never overwrite malformed settings files; avoid destructive data loss.
+                return false;
+            }
+        }
+        // Keep the injected command target valid for all profile types, not just CLIProxy.
+        // The installer already skips byte-identical copies, so we can always attempt a refresh
+        // without rewriting unchanged hooks. Re-check existence after a failed install to tolerate
+        // concurrent first-run installs that may have completed in another process.
+        if (!(0, hook_installer_1.installWebSearchHook)() && !hasUsableHookBinary()) {
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.warn)('WebSearch hook binary is missing and could not be installed'));
+            }
+            return false;
+        }
+        // One-time migration from global settings
+        migrateGlobalHook();
+        // Ensure CCS dir exists before writing settings updates.
+        if (!fs.existsSync(ccsDir)) {
+            fs.mkdirSync(ccsDir, { recursive: true, mode: 0o700 });
+        }
+        // Check if CCS hook already present
+        if (hasCcsHook(settings)) {
+            // Clean up any duplicates that may have accumulated (Windows path bug fix)
+            const hadDuplicates = (0, hook_utils_1.deduplicateCcsHooks)(settings);
+            if (hadDuplicates) {
+                // Re-read file to compare with modified settings (deduplicateCcsHooks mutates in-place)
+                const newContent = JSON.stringify(settings, null, 2);
+                const existingContent = fs.readFileSync(settingsPath, 'utf8');
+                // Only write if content actually changed
+                if (newContent !== existingContent) {
+                    fs.writeFileSync(settingsPath, newContent, 'utf8');
+                    if (process.env.CCS_DEBUG) {
+                        console.error((0, ui_1.info)(`Removed duplicate WebSearch hooks from ${profileName}.settings.json`));
+                    }
+                }
+            }
+            // Update timeout if needed
+            return updateHookTimeoutIfNeeded(settings, settingsPath);
+        }
+        // Get hook config
+        const hookConfig = (0, hook_config_1.getWebSearchHookConfig)();
+        // Ensure hooks structure exists
+        if (!settings.hooks) {
+            settings.hooks = {};
+        }
+        const settingsHooks = settings.hooks;
+        if (!settingsHooks.PreToolUse) {
+            settingsHooks.PreToolUse = [];
+        }
+        // Add CCS hook
+        const preToolUseHooks = hookConfig.PreToolUse;
+        settingsHooks.PreToolUse.push(...preToolUseHooks);
+        // Write updated settings
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.info)(`Added WebSearch hook to ${profileName}.settings.json`));
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`Failed to inject hook: ${error.message}`));
+        }
+        return false;
+    }
+}
+exports.ensureProfileHooks = ensureProfileHooks;
+function ensureProfileHooksOrThrow(profileName) {
+    const wsConfig = (0, unified_config_loader_1.getWebSearchConfig)();
+    if (!wsConfig.enabled) {
+        return;
+    }
+    if (!ensureProfileHooks(profileName)) {
+        throw new Error(`WebSearch is enabled, but CCS could not prepare the profile hook for "${profileName}".`);
+    }
+}
+exports.ensureProfileHooksOrThrow = ensureProfileHooksOrThrow;
+/**
+ * Update hook timeout if it differs from current config
+ */
+function updateHookTimeoutIfNeeded(settings, settingsPath) {
+    try {
+        const hooks = settings.hooks;
+        const hookConfig = (0, hook_config_1.getWebSearchHookConfig)();
+        const expectedHookPath = (0, hook_config_1.getHookPath)();
+        const expectedCommand = `node "${expectedHookPath}"`;
+        const expectedHooks = hookConfig.PreToolUse[0]
+            .hooks;
+        const expectedTimeout = expectedHooks[0].timeout;
+        let needsUpdate = false;
+        for (const h of hooks.PreToolUse) {
+            const hook = h;
+            if (hook.matcher !== 'WebSearch')
+                continue;
+            const hookArray = hook.hooks;
+            if (!hookArray?.[0]?.command)
+                continue;
+            const command = hookArray[0].command;
+            if (typeof command !== 'string')
+                continue;
+            // Normalize path separators for cross-platform matching (Windows uses backslashes)
+            const normalizedCommand = command
+                .replace(/\\/g, '/') // Windows backslashes
+                .replace(/\/+/g, '/'); // Collapse multiple slashes
+            if (!normalizedCommand.includes('.ccs/hooks/websearch-transformer'))
+                continue;
+            // Found CCS hook - check if needs update
+            if (hookArray[0].command !== expectedCommand) {
+                hookArray[0].command = expectedCommand;
+                needsUpdate = true;
+            }
+            if (hookArray[0].timeout !== expectedTimeout) {
+                hookArray[0].timeout = expectedTimeout;
+                needsUpdate = true;
+            }
+        }
+        if (needsUpdate) {
+            fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+            if (process.env.CCS_DEBUG) {
+                console.error((0, ui_1.info)('Updated WebSearch hook timeout in profile settings'));
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (process.env.CCS_DEBUG) {
+            console.error((0, ui_1.warn)(`updateHookTimeoutIfNeeded failed: ${error.message}`));
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=profile-hook-injector.js.map

package/dist/utils/websearch/profile-hook-injector.js.map

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

package/dist/utils/websearch/provider-secrets.d.ts

@@ -0,0 +1,18 @@
+export type WebSearchApiKeyProviderId = 'exa' | 'tavily' | 'brave';
+export type WebSearchApiKeySource = 'global_env' | 'process_env' | 'both' | 'none';
+export interface WebSearchApiKeyState {
+    envVar: string;
+    configured: boolean;
+    available: boolean;
+    source: WebSearchApiKeySource;
+    maskedValue?: string;
+}
+interface WebSearchApiKeyDescriptor {
+    envVar: string;
+    alternateEnvVar: string;
+}
+export declare const WEBSEARCH_API_KEY_PROVIDERS: Record<WebSearchApiKeyProviderId, WebSearchApiKeyDescriptor>;
+export declare function getWebSearchApiKeyStates(): Record<WebSearchApiKeyProviderId, WebSearchApiKeyState>;
+export declare function applyWebSearchApiKeyUpdates(env: Record<string, string>, apiKeys: Partial<Record<WebSearchApiKeyProviderId, string | null>> | undefined): Record<string, string>;
+export {};
+//# sourceMappingURL=provider-secrets.d.ts.map

package/dist/utils/websearch/provider-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-secrets.d.ts","sourceRoot":"","sources":["../../../src/utils/websearch/provider-secrets.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,yBAAyB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,yBAAyB,EACzB,yBAAyB,CAc1B,CAAC;AAgCF,wBAAgB,wBAAwB,IAAI,MAAM,CAChD,yBAAyB,EACzB,oBAAoB,CACrB,CA6BA;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,GAC7E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BxB"}

package/dist/utils/websearch/provider-secrets.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyWebSearchApiKeyUpdates = exports.getWebSearchApiKeyStates = exports.WEBSEARCH_API_KEY_PROVIDERS = void 0;
+const unified_config_loader_1 = require("../../config/unified-config-loader");
+const sensitive_keys_1 = require("../sensitive-keys");
+exports.WEBSEARCH_API_KEY_PROVIDERS = {
+    exa: {
+        envVar: 'EXA_API_KEY',
+        alternateEnvVar: 'CCS_WEBSEARCH_EXA_API_KEY',
+    },
+    tavily: {
+        envVar: 'TAVILY_API_KEY',
+        alternateEnvVar: 'CCS_WEBSEARCH_TAVILY_API_KEY',
+    },
+    brave: {
+        envVar: 'BRAVE_API_KEY',
+        alternateEnvVar: 'CCS_WEBSEARCH_BRAVE_API_KEY',
+    },
+};
+function getTrimmedEnvValue(env, names) {
+    for (const name of names) {
+        const value = env[name]?.trim();
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function resolveSource(hasGlobalEnvValue, hasProcessEnvValue) {
+    if (hasGlobalEnvValue && hasProcessEnvValue) {
+        return 'both';
+    }
+    if (hasGlobalEnvValue) {
+        return 'global_env';
+    }
+    if (hasProcessEnvValue) {
+        return 'process_env';
+    }
+    return 'none';
+}
+function getWebSearchApiKeyStates() {
+    const globalEnvConfig = (0, unified_config_loader_1.getGlobalEnvConfig)();
+    const storedEnv = globalEnvConfig.env ?? {};
+    return Object.entries(exports.WEBSEARCH_API_KEY_PROVIDERS).reduce((acc, [providerId, descriptor]) => {
+        const names = [descriptor.envVar, descriptor.alternateEnvVar];
+        const globalEnvValue = getTrimmedEnvValue(storedEnv, names);
+        const processEnvValue = getTrimmedEnvValue(process.env, names);
+        const configured = Boolean(globalEnvValue || processEnvValue);
+        const available = Boolean(processEnvValue || (globalEnvConfig.enabled && globalEnvValue));
+        const visibleValue = globalEnvValue || processEnvValue;
+        acc[providerId] = {
+            envVar: descriptor.envVar,
+            configured,
+            available,
+            source: resolveSource(Boolean(globalEnvValue), Boolean(processEnvValue)),
+            maskedValue: visibleValue ? (0, sensitive_keys_1.maskSensitiveValue)(visibleValue) : undefined,
+        };
+        return acc;
+    }, {});
+}
+exports.getWebSearchApiKeyStates = getWebSearchApiKeyStates;
+function applyWebSearchApiKeyUpdates(env, apiKeys) {
+    if (!apiKeys) {
+        return env;
+    }
+    const nextEnv = { ...env };
+    for (const [providerId, rawValue] of Object.entries(apiKeys)) {
+        if (rawValue === undefined) {
+            continue;
+        }
+        const descriptor = exports.WEBSEARCH_API_KEY_PROVIDERS[providerId];
+        delete nextEnv[descriptor.alternateEnvVar];
+        const normalizedValue = typeof rawValue === 'string' ? rawValue.trim() : '';
+        if (!normalizedValue) {
+            delete nextEnv[descriptor.envVar];
+            continue;
+        }
+        nextEnv[descriptor.envVar] = normalizedValue;
+    }
+    return nextEnv;
+}
+exports.applyWebSearchApiKeyUpdates = applyWebSearchApiKeyUpdates;
+//# sourceMappingURL=provider-secrets.js.map

package/dist/utils/websearch/provider-secrets.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * WebSearch Status and Readiness
+ *
+ * Provides status checking and display functions for WebSearch.
+ *
+ * @module utils/websearch/status
+ */
+import type { WebSearchCliInfo, WebSearchStatus } from './types';
+/**
+ * Get all WebSearch providers with their current status.
+ */
+export declare function getWebSearchCliProviders(): WebSearchCliInfo[];
+/**
+ * Check if any WebSearch provider is currently ready.
+ */
+export declare function hasAnyWebSearchCli(): boolean;
+/**
+ * Get setup hints when no providers are ready.
+ */
+export declare function getCliInstallHints(): string[];
+export declare function buildWebSearchReadiness(enabled: boolean, providers: WebSearchCliInfo[]): WebSearchStatus;
+/**
+ * Get WebSearch readiness status for display.
+ */
+export declare function getWebSearchReadiness(): WebSearchStatus;
+/**
+ * Display WebSearch status (single line, equilibrium UX).
+ */
+export declare function displayWebSearchStatus(): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/utils/websearch/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAwJjE;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAyE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAW7C;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,gBAAgB,EAAE,GAC5B,eAAe,CAmCjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAIvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAiB7C"}