@helmisatria/mcp-chrome-bridge 1.0.30

package/dist/agent/ccr-detector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Result of CCR detection.
+ */
+export interface CcrDetectionResult {
+    detected: boolean;
+    baseUrl?: string;
+    authToken?: string;
+    source?: 'env' | 'config';
+    error?: string;
+}
+/**
+ * Result of validating CCR configuration.
+ */
+export interface CcrValidationResult {
+    /** Whether a CCR config file was found and inspected */
+    checked: boolean;
+    /** Whether the configuration is valid */
+    valid: boolean;
+    /** Path to the CCR config file */
+    configPath: string;
+    /** Current Router.default value if available */
+    routerDefault?: string;
+    /** Human-readable issue description when valid is false */
+    issue?: string;
+    /** Suggested Router.default value in "provider,model" format */
+    suggestedFix?: string;
+    /** Full suggestion message for the user */
+    suggestion?: string;
+}
+/**
+ * Detect CCR configuration and verify it's running.
+ *
+ * This function:
+ * 1. Returns cached result if still valid
+ * 2. Checks if CCR env vars are already set in process.env
+ * 3. If not, reads and parses CCR config file
+ * 4. Verifies CCR is running via health check
+ *
+ * @returns Detection result with baseUrl and authToken if CCR is available
+ */
+export declare function detectCcr(): Promise<CcrDetectionResult>;
+/**
+ * Clear the CCR detection cache.
+ * Useful for testing or when user wants to re-detect.
+ */
+export declare function clearCcrCache(): void;
+/**
+ * Validate CCR configuration for common misconfigurations.
+ *
+ * This function checks for issues that would cause runtime errors in CCR,
+ * particularly the "Router.default must be provider,model" requirement.
+ *
+ * The most common misconfiguration is setting Router.default to just a provider
+ * name (e.g., "venus") instead of the required "provider,model" format
+ * (e.g., "venus,claude-4-5-sonnet-20250929"). This causes CCR to crash with
+ * "Cannot read properties of undefined (reading 'includes')" when it tries
+ * to split the model name.
+ */
+export declare function validateCcrConfig(): Promise<CcrValidationResult>;

package/dist/agent/ccr-detector.js

@@ -0,0 +1,311 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCcr = detectCcr;
+exports.clearCcrCache = clearCcrCache;
+exports.validateCcrConfig = validateCcrConfig;
+/**
+ * Claude Code Router (CCR) Auto-Detection Module.
+ *
+ * This module provides automatic detection of CCR configuration
+ * for users who have already set up CCR on their system.
+ *
+ * CCR config location: ~/.claude-code-router/config.json
+ * CCR uses env vars: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN
+ *
+ * The detection flow:
+ * 1. Check if CCR env vars are already set (skip if yes)
+ * 2. Read CCR config file
+ * 3. Parse JSON5 config with env var interpolation
+ * 4. Verify CCR is running via health check
+ * 5. Return derived env vars if healthy
+ */
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+/**
+ * Default CCR port.
+ */
+const DEFAULT_CCR_PORT = 9898;
+/**
+ * CCR config file path.
+ */
+const CCR_CONFIG_PATH = node_path_1.default.join(node_os_1.default.homedir(), '.claude-code-router', 'config.json');
+/**
+ * Health check timeout in milliseconds.
+ */
+const HEALTH_CHECK_TIMEOUT = 2000;
+/**
+ * Cache for CCR detection result (to avoid repeated file reads and health checks).
+ * Cached for the lifetime of the process.
+ */
+let cachedResult = null;
+let cacheTimestamp = 0;
+const CACHE_TTL = 60000; // 1 minute
+/**
+ * Detect CCR configuration and verify it's running.
+ *
+ * This function:
+ * 1. Returns cached result if still valid
+ * 2. Checks if CCR env vars are already set in process.env
+ * 3. If not, reads and parses CCR config file
+ * 4. Verifies CCR is running via health check
+ *
+ * @returns Detection result with baseUrl and authToken if CCR is available
+ */
+async function detectCcr() {
+    var _a, _b, _c, _d, _e;
+    // Check cache
+    const now = Date.now();
+    if (cachedResult && now - cacheTimestamp < CACHE_TTL) {
+        return cachedResult;
+    }
+    try {
+        // First, check if env vars are already set (user ran `eval "$(ccr activate)"`)
+        const envBaseUrl = process.env.ANTHROPIC_BASE_URL;
+        const envAuthToken = process.env.ANTHROPIC_AUTH_TOKEN;
+        if (envBaseUrl && envAuthToken) {
+            // Verify CCR is running
+            const healthy = await checkCcrHealth(envBaseUrl);
+            if (healthy) {
+                cachedResult = {
+                    detected: true,
+                    baseUrl: envBaseUrl,
+                    authToken: envAuthToken,
+                    source: 'env',
+                };
+                cacheTimestamp = now;
+                return cachedResult;
+            }
+            // Env vars set but CCR not healthy - fall through to config detection
+        }
+        // Try to read CCR config file
+        const configResult = await readCcrConfig();
+        if (!configResult.config) {
+            cachedResult = {
+                detected: false,
+                error: configResult.error || 'CCR config not found or invalid',
+            };
+            cacheTimestamp = now;
+            return cachedResult;
+        }
+        const config = configResult.config;
+        // Derive env vars from config (support both uppercase and lowercase field names)
+        const port = (_b = (_a = config.PORT) !== null && _a !== void 0 ? _a : config.port) !== null && _b !== void 0 ? _b : DEFAULT_CCR_PORT;
+        const host = (_d = (_c = config.HOST) !== null && _c !== void 0 ? _c : config.host) !== null && _d !== void 0 ? _d : '127.0.0.1';
+        const baseUrl = `http://${host}:${port}`;
+        // APIKEY can be empty string in config, use 'APIKEY' as fallback (CCR accepts this)
+        const apiKey = (_e = config.APIKEY) !== null && _e !== void 0 ? _e : config.apiKey;
+        const authToken = apiKey && apiKey.length > 0 ? apiKey : 'APIKEY';
+        // Verify CCR is running
+        const healthy = await checkCcrHealth(baseUrl);
+        if (!healthy) {
+            cachedResult = {
+                detected: false,
+                error: 'CCR config found but service not running',
+            };
+            cacheTimestamp = now;
+            return cachedResult;
+        }
+        cachedResult = {
+            detected: true,
+            baseUrl,
+            authToken,
+            source: 'config',
+        };
+        cacheTimestamp = now;
+        return cachedResult;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        cachedResult = { detected: false, error: message };
+        cacheTimestamp = now;
+        return cachedResult;
+    }
+}
+/**
+ * Read and parse CCR config file.
+ */
+async function readCcrConfig() {
+    try {
+        const content = await (0, promises_1.readFile)(CCR_CONFIG_PATH, 'utf-8');
+        const config = parseJson5Config(content);
+        if (!config) {
+            return { config: null, error: 'Failed to parse CCR config file' };
+        }
+        return { config };
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            // Config file doesn't exist - CCR not installed
+            return { config: null, error: 'CCR config file not found' };
+        }
+        return { config: null, error: `Failed to read CCR config: ${err.message}` };
+    }
+}
+/**
+ * Parse CCR config file.
+ *
+ * CCR config is standard JSON (not JSON5), so we can use JSON.parse directly.
+ * We only need to handle env var interpolation: ${VAR_NAME}
+ *
+ * Note: Previous implementation tried to strip comments using regex which
+ * incorrectly matched "http://" URLs inside strings.
+ */
+function parseJson5Config(content) {
+    try {
+        // First try standard JSON parse (CCR config is usually valid JSON)
+        // Only interpolate env vars if needed
+        let processed = content;
+        // Interpolate env vars: ${VAR_NAME} -> value
+        // Only do this outside of the JSON parsing to avoid breaking strings
+        if (content.includes('${')) {
+            processed = content.replace(/\$\{([^}]+)\}/g, (_, varName) => {
+                const value = process.env[varName.trim()];
+                return value || '';
+            });
+        }
+        const parsed = JSON.parse(processed);
+        return parsed;
+    }
+    catch (parseError) {
+        // Log parse error for debugging
+        console.error('[CCR] Failed to parse config:', parseError);
+        return null;
+    }
+}
+/**
+ * Check if CCR is running by hitting its health endpoint.
+ */
+async function checkCcrHealth(baseUrl) {
+    try {
+        const healthUrl = `${baseUrl}/health`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), HEALTH_CHECK_TIMEOUT);
+        try {
+            const response = await fetch(healthUrl, {
+                method: 'GET',
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response.ok;
+        }
+        catch (_a) {
+            clearTimeout(timeoutId);
+            return false;
+        }
+    }
+    catch (_b) {
+        return false;
+    }
+}
+/**
+ * Clear the CCR detection cache.
+ * Useful for testing or when user wants to re-detect.
+ */
+function clearCcrCache() {
+    cachedResult = null;
+    cacheTimestamp = 0;
+}
+/**
+ * Validate CCR configuration for common misconfigurations.
+ *
+ * This function checks for issues that would cause runtime errors in CCR,
+ * particularly the "Router.default must be provider,model" requirement.
+ *
+ * The most common misconfiguration is setting Router.default to just a provider
+ * name (e.g., "venus") instead of the required "provider,model" format
+ * (e.g., "venus,claude-4-5-sonnet-20250929"). This causes CCR to crash with
+ * "Cannot read properties of undefined (reading 'includes')" when it tries
+ * to split the model name.
+ */
+async function validateCcrConfig() {
+    var _a, _b, _c;
+    const configResult = await readCcrConfig();
+    // If we can't read the config, return early (not our problem to report)
+    if (!configResult.config) {
+        return {
+            checked: false,
+            valid: true,
+            configPath: CCR_CONFIG_PATH,
+            issue: configResult.error,
+        };
+    }
+    const config = configResult.config;
+    const router = (_a = config.Router) !== null && _a !== void 0 ? _a : config.router;
+    const routerDefault = (_b = router === null || router === void 0 ? void 0 : router.default) === null || _b === void 0 ? void 0 : _b.trim();
+    // No Router.default configured
+    if (!routerDefault) {
+        return {
+            checked: true,
+            valid: false,
+            configPath: CCR_CONFIG_PATH,
+            issue: 'CCR Router.default is not configured.',
+            suggestion: `Edit ${CCR_CONFIG_PATH} and set Router.default to "provider,model" format, then restart CCR.`,
+        };
+    }
+    // Check if Router.default contains a comma (required format: provider,model)
+    if (!routerDefault.includes(',')) {
+        const suggestedFix = inferSuggestedRouterDefault(routerDefault, config, router);
+        const example = suggestedFix !== null && suggestedFix !== void 0 ? suggestedFix : `${routerDefault},<model>`;
+        return {
+            checked: true,
+            valid: false,
+            configPath: CCR_CONFIG_PATH,
+            routerDefault,
+            issue: `CCR Router.default must be "provider,model" format, but got "${routerDefault}" (missing model).`,
+            suggestedFix,
+            suggestion: `Edit ${CCR_CONFIG_PATH} and change Router.default from "${routerDefault}" to "${example}", then restart CCR.`,
+        };
+    }
+    // Validate the model part is not empty after splitting
+    const [providerPart, modelPart] = routerDefault.split(',', 2);
+    if (!(providerPart === null || providerPart === void 0 ? void 0 : providerPart.trim()) || !(modelPart === null || modelPart === void 0 ? void 0 : modelPart.trim())) {
+        const suggestedFix = inferSuggestedRouterDefault((_c = providerPart === null || providerPart === void 0 ? void 0 : providerPart.trim()) !== null && _c !== void 0 ? _c : '', config, router);
+        return {
+            checked: true,
+            valid: false,
+            configPath: CCR_CONFIG_PATH,
+            routerDefault,
+            issue: `CCR Router.default "${routerDefault}" has empty provider or model part.`,
+            suggestedFix,
+            suggestion: `Edit ${CCR_CONFIG_PATH} and set Router.default to a valid "provider,model" format, then restart CCR.`,
+        };
+    }
+    return {
+        checked: true,
+        valid: true,
+        configPath: CCR_CONFIG_PATH,
+        routerDefault,
+    };
+}
+/**
+ * Try to infer a suggested Router.default value based on available providers and models.
+ */
+function inferSuggestedRouterDefault(providerName, config, router) {
+    var _a, _b, _c;
+    const normalizedProvider = providerName.toLowerCase();
+    if (!normalizedProvider)
+        return undefined;
+    // Try to find the provider in Providers array and get its first model
+    const providers = (_b = (_a = config.Providers) !== null && _a !== void 0 ? _a : config.providers) !== null && _b !== void 0 ? _b : [];
+    const matchedProvider = providers.find((p) => { var _a; return ((_a = p.name) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === normalizedProvider; });
+    if ((matchedProvider === null || matchedProvider === void 0 ? void 0 : matchedProvider.name) && ((_c = matchedProvider.models) === null || _c === void 0 ? void 0 : _c[0])) {
+        return `${matchedProvider.name},${matchedProvider.models[0]}`;
+    }
+    // Fallback: look at other Router entries that have valid "provider,model" format
+    const routerEntries = [router === null || router === void 0 ? void 0 : router.background, router === null || router === void 0 ? void 0 : router.think, router === null || router === void 0 ? void 0 : router.longContext];
+    for (const entry of routerEntries) {
+        if (!entry || !entry.includes(','))
+            continue;
+        const [p, m] = entry.split(',', 2);
+        if ((p === null || p === void 0 ? void 0 : p.trim().toLowerCase()) === normalizedProvider && (m === null || m === void 0 ? void 0 : m.trim())) {
+            return `${providerName},${m.trim()}`;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=ccr-detector.js.map

package/dist/agent/ccr-detector.js.map

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

package/dist/agent/chat-service.d.ts

@@ -0,0 +1,50 @@
+import type { AgentActRequest } from './types';
+import type { AgentEngine, EngineName, RunningExecution } from './engines/types';
+import { AgentStreamManager } from './stream-manager';
+export interface AgentChatServiceOptions {
+    engines: AgentEngine[];
+    streamManager: AgentStreamManager;
+    defaultEngineName?: EngineName;
+}
+/**
+ * AgentChatService coordinates incoming /agent/chat requests and delegates to engines.
+ *
+ * 中文说明：该服务负责会话级调度，不关心具体 CLI/SDK 实现细节。
+ * 通过 Engine 接口实现依赖倒置，后续替换或新增引擎时无需修改 HTTP 路由层。
+ */
+export declare class AgentChatService {
+    private readonly engines;
+    private readonly streamManager;
+    private readonly defaultEngineName;
+    /**
+     * Registry of currently running executions, keyed by requestId.
+     */
+    private readonly runningExecutions;
+    constructor(options: AgentChatServiceOptions);
+    handleAct(sessionId: string, payload: AgentActRequest): Promise<{
+        requestId: string;
+    }>;
+    /**
+     * Cancel a running execution by requestId.
+     * Returns true if the execution was found and cancelled, false otherwise.
+     */
+    cancelExecution(requestId: string): boolean;
+    /**
+     * Cancel all running executions for a session.
+     * Returns the number of executions cancelled.
+     */
+    cancelSessionExecutions(sessionId: string): number;
+    /**
+     * Get list of running executions for diagnostics.
+     */
+    getRunningExecutions(): RunningExecution[];
+    private resolveEngineName;
+    private runEngine;
+    /**
+     * Expose registered engines for UI and diagnostics.
+     */
+    getEngineInfos(): Array<{
+        name: EngineName;
+        supportsMcp?: boolean;
+    }>;
+}