@kaitranntt/ccs 5.20.0-dev.1 → 5.20.0-dev.3

package/dist/utils/shell-executor.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.execClaude = exports.escapeShellArg = void 0;
 const child_process_1 = require("child_process");
 const error_manager_1 = require("./error-manager");
+const websearch_manager_1 = require("./websearch-manager");
 /**
  * Escape arguments for shell execution (Windows compatibility)
  */
@@ -21,8 +22,12 @@ exports.escapeShellArg = escapeShellArg;
 function execClaude(claudeCli, args, envVars = null) {
     const isWindows = process.platform === 'win32';
     const needsShell = isWindows && /\.(cmd|bat|ps1)$/i.test(claudeCli);
+    // Get WebSearch hook config env vars
+    const webSearchEnv = (0, websearch_manager_1.getWebSearchHookEnv)();
     // Prepare environment (merge with process.env if envVars provided)
-    const env = envVars ? { ...process.env, ...envVars } : process.env;
+    const env = envVars
+        ? { ...process.env, ...envVars, ...webSearchEnv }
+        : { ...process.env, ...webSearchEnv };
     let child;
     if (needsShell) {
         // When shell needed: concatenate into string to avoid DEP0190 warning

package/dist/utils/shell-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-executor.js","sourceRoot":"","sources":["../../src/utils/shell-executor.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iDAAoD;AACpD,mDAA+C;AAE/C;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC;AACrD,CAAC;AAFD,wCAEC;AAED;;GAEG;AACH,SAAgB,UAAU,CACxB,SAAiB,EACjB,IAAc,EACd,UAAoC,IAAI;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC/C,MAAM,UAAU,GAAG,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpE,mEAAmE;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAEnE,IAAI,KAAmB,CAAC;IACxB,IAAI,UAAU,EAAE,CAAC;QACf,sEAAsE;QACtE,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,KAAK,GAAG,IAAA,qBAAK,EAAC,SAAS,EAAE;YACvB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,IAAI;YACX,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,mEAAmE;QACnE,KAAK,GAAG,IAAA,qBAAK,EAAC,SAAS,EAAE,IAAI,EAAE;YAC7B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,IAAI;YACjB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAwB,CAAC,CAAC;;YAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC3B,MAAM,4BAAY,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAvCD,gCAuCC"}
+{"version":3,"file":"shell-executor.js","sourceRoot":"","sources":["../../src/utils/shell-executor.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iDAAoD;AACpD,mDAA+C;AAC/C,2DAA0D;AAE1D;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC;AACrD,CAAC;AAFD,wCAEC;AAED;;GAEG;AACH,SAAgB,UAAU,CACxB,SAAiB,EACjB,IAAc,EACd,UAAoC,IAAI;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC/C,MAAM,UAAU,GAAG,SAAS,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpE,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAA,uCAAmB,GAAE,CAAC;IAE3C,mEAAmE;IACnE,MAAM,GAAG,GAAG,OAAO;QACjB,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,YAAY,EAAE;QACjD,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;IAExC,IAAI,KAAmB,CAAC;IACxB,IAAI,UAAU,EAAE,CAAC;QACf,sEAAsE;QACtE,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,KAAK,GAAG,IAAA,qBAAK,EAAC,SAAS,EAAE;YACvB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,IAAI;YACX,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,mEAAmE;QACnE,KAAK,GAAG,IAAA,qBAAK,EAAC,SAAS,EAAE,IAAI,EAAE;YAC7B,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,IAAI;YACjB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAChC,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAwB,CAAC,CAAC;;YAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC3B,MAAM,4BAAY,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AA5CD,gCA4CC"}

package/dist/utils/websearch-manager.d.ts

@@ -0,0 +1,197 @@
+/**
+ * WebSearch Manager - Manages WebSearch hook for CCS
+ *
+ * WebSearch is a server-side tool executed by Anthropic's API.
+ * Third-party providers (gemini, agy, codex, qwen) don't have access.
+ * This manager installs a hook that uses CLI tools (Gemini CLI) as fallback.
+ *
+ * Simplified Architecture:
+ *   - No MCP complexity
+ *   - Uses CLI tools (currently Gemini CLI)
+ *   - Easy to extend for future CLI tools (opencode, etc.)
+ *
+ * @module utils/websearch-manager
+ */
+/**
+ * Gemini CLI installation status
+ */
+export interface GeminiCliStatus {
+    installed: boolean;
+    path: string | null;
+    version: string | null;
+}
+/**
+ * Check if Gemini CLI is installed globally
+ *
+ * Requires global install: `npm install -g @google/gemini-cli`
+ * No npx fallback - must be in PATH
+ *
+ * @returns Gemini CLI status with path and version
+ */
+export declare function getGeminiCliStatus(): GeminiCliStatus;
+/**
+ * Check if Gemini CLI is available (quick boolean check)
+ */
+export declare function hasGeminiCli(): boolean;
+/**
+ * Clear Gemini CLI cache (for testing or after installation)
+ */
+export declare function clearGeminiCliCache(): void;
+/**
+ * Grok CLI installation status
+ */
+export interface GrokCliStatus {
+    installed: boolean;
+    path: string | null;
+    version: string | null;
+}
+/**
+ * Check if Grok CLI is installed globally
+ *
+ * Grok CLI (grok-4-cli by lalomorales22) provides web search + X search.
+ * Requires: `npm install -g grok-cli` and XAI_API_KEY env var.
+ *
+ * @returns Grok CLI status with path and version
+ */
+export declare function getGrokCliStatus(): GrokCliStatus;
+/**
+ * Check if Grok CLI is available (quick boolean check)
+ */
+export declare function hasGrokCli(): boolean;
+/**
+ * Clear Grok CLI cache (for testing or after installation)
+ */
+export declare function clearGrokCliCache(): void;
+/**
+ * OpenCode CLI installation status
+ */
+export interface OpenCodeCliStatus {
+    installed: boolean;
+    path: string | null;
+    version: string | null;
+}
+/**
+ * Check if OpenCode CLI is installed globally
+ *
+ * OpenCode provides built-in web search via opencode/grok-code model.
+ * Install: curl -fsSL https://opencode.ai/install | bash
+ *
+ * @returns OpenCode CLI status with path and version
+ */
+export declare function getOpenCodeCliStatus(): OpenCodeCliStatus;
+/**
+ * Check if OpenCode CLI is available (quick boolean check)
+ */
+export declare function hasOpenCodeCli(): boolean;
+/**
+ * Clear OpenCode CLI cache (for testing or after installation)
+ */
+export declare function clearOpenCodeCliCache(): void;
+/**
+ * Clear all CLI caches
+ */
+export declare function clearAllCliCaches(): void;
+/**
+ * WebSearch CLI provider information for health checks and UI
+ */
+export interface WebSearchCliInfo {
+    /** Provider ID */
+    id: 'gemini' | 'grok' | 'opencode';
+    /** Display name */
+    name: string;
+    /** CLI command name */
+    command: string;
+    /** Whether CLI is installed */
+    installed: boolean;
+    /** CLI version if installed */
+    version: string | null;
+    /** Install command */
+    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;
+    /** Free tier available? */
+    freeTier: boolean;
+}
+/**
+ * Get all WebSearch CLI providers with their status
+ */
+export declare function getWebSearchCliProviders(): WebSearchCliInfo[];
+/**
+ * Check if any WebSearch CLI is available
+ */
+export declare function hasAnyWebSearchCli(): boolean;
+/**
+ * Get install hints for CLI-only users when no WebSearch CLI is installed
+ */
+export declare function getCliInstallHints(): string[];
+/**
+ * Install WebSearch hook to ~/.ccs/hooks/
+ *
+ * This hook intercepts WebSearch and executes via Gemini CLI.
+ *
+ * @returns true if hook installed successfully
+ */
+export declare function installWebSearchHook(): boolean;
+/**
+ * Check if WebSearch hook is installed
+ */
+export declare function hasWebSearchHook(): boolean;
+/**
+ * Get WebSearch hook configuration for settings.json
+ * Timeout is computed from max provider timeout in config.yaml + buffer
+ */
+export declare function getWebSearchHookConfig(): Record<string, unknown>;
+/**
+ * Get environment variables for WebSearch hook configuration.
+ *
+ * Simple env vars - hook reads these to control behavior.
+ *
+ * @returns Record of environment variables to set before spawning Claude
+ */
+export declare function getWebSearchHookEnv(): Record<string, string>;
+/**
+ * WebSearch availability status for third-party profiles
+ */
+export type WebSearchReadiness = 'ready' | 'unavailable';
+/**
+ * WebSearch status for display
+ */
+export interface WebSearchStatus {
+    readiness: WebSearchReadiness;
+    geminiCli: boolean;
+    grokCli: boolean;
+    opencodeCli: boolean;
+    message: string;
+}
+/**
+ * Get WebSearch readiness status for display
+ *
+ * Called on third-party profile startup to inform user.
+ */
+export declare function getWebSearchReadiness(): WebSearchStatus;
+/**
+ * Display WebSearch status (single line, equilibrium UX)
+ *
+ * Only call for third-party profiles.
+ * Shows detailed install hints when no CLI is installed.
+ */
+export declare function displayWebSearchStatus(): void;
+/**
+ * @deprecated Use installWebSearchHook instead - MCP is no longer used
+ */
+export declare function ensureMcpWebSearch(): boolean;
+/**
+ * @deprecated MCP is no longer used
+ */
+export declare function hasMcpWebSearch(): boolean;
+/**
+ * @deprecated MCP is no longer used
+ */
+export declare function getMcpConfigPath(): string;
+//# sourceMappingURL=websearch-manager.d.ts.map

package/dist/utils/websearch-manager.d.ts.map

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