cbrowser 18.42.4 → 18.42.6

package/dist/mcp-tools/tool-categories.js

@@ -0,0 +1,284 @@
+/**
+ * CBrowser Tool Categories — for lazy loading and context efficiency.
+ *
+ * Tier 1: Always loaded — core tools used in most conversations (~15 tools)
+ * Tier 2: Loaded on demand by category — specialist tools loaded when needed (~45 tools)
+ * Tier 3: Rarely needed — loaded only on explicit request (~26 tools)
+ *
+ * This reduces token cost from ~105 tool descriptions to ~15 in the default context,
+ * with category summaries for the rest that let the LLM request specific groups.
+ *
+ * @since v18.39.0
+ */
+export const TOOL_CATEGORIES = [
+    // ── Tier 1: Always loaded (~15 tools) ──
+    // These are used in 80%+ of conversations
+    {
+        name: "core_browser",
+        description: "Navigate, interact with, and capture web pages",
+        tier: 1,
+        tools: [
+            "navigate",
+            "click",
+            "fill",
+            "scroll",
+            "screenshot",
+            "extract",
+        ],
+    },
+    {
+        name: "core_analysis",
+        description: "Assess sites for AI-friendliness, accessibility, and cognitive effort",
+        tier: 1,
+        tools: [
+            "agent_ready_audit",
+            "empathy_audit",
+            "cognitive_effort",
+            "site_cognitive_assessment",
+            "page_understand",
+            "cognitive_journey_init",
+            "cognitive_journey_update_state",
+            "list_cognitive_personas",
+            "security_audit",
+        ],
+    },
+    // ── Tier 2: Loaded on demand (~45 tools) ──
+    // Loaded when the user asks about a specific capability
+    {
+        name: "visual_testing",
+        description: "Visual regression, baselines, cross-browser, responsive, and A/B comparison",
+        tier: 2,
+        tools: [
+            "visual_baseline",
+            "visual_regression",
+            "cross_browser_test",
+            "cross_browser_diff",
+            "responsive_test",
+            "ab_comparison",
+            "transport_map",
+            "attention_analysis",
+            "attention_compare",
+        ],
+    },
+    {
+        name: "cognitive_transport",
+        description: "Wasserstein persona distance, interpolation, coverage, load estimation, and comparison",
+        tier: 2,
+        tools: [
+            "cognitive_distance",
+            "cognitive_coverage",
+            "cognitive_interpolate",
+            "cognitive_load_estimate",
+            "compare_personas",
+            "compare_personas_init",
+            "compare_personas_complete",
+        ],
+    },
+    {
+        name: "testing",
+        description: "Natural language tests, flaky detection, test repair, and coverage mapping",
+        tier: 2,
+        tools: [
+            "nl_test_inline",
+            "nl_test_file",
+            "repair_test",
+            "detect_flaky_tests",
+            "coverage_map",
+        ],
+    },
+    {
+        name: "site_knowledge",
+        description: "Persistent site models, profiles, and navigation knowledge",
+        tier: 2,
+        tools: [
+            "site_model_status",
+            "site_model_query",
+            "site_profile_list",
+            "site_profile_delete",
+            "site_profile_status",
+        ],
+    },
+    {
+        name: "performance",
+        description: "Performance baselines and regression detection",
+        tier: 2,
+        tools: [
+            "perf_baseline",
+            "perf_regression",
+            "list_baselines",
+        ],
+    },
+    {
+        name: "bug_hunting",
+        description: "Autonomous bug hunting and chaos engineering",
+        tier: 2,
+        tools: [
+            "hunt_bugs",
+            "chaos_test",
+            "competitive_benchmark",
+        ],
+    },
+    {
+        name: "marketing",
+        description: "Marketing campaigns, persona-based A/B testing, influence analysis",
+        tier: 2,
+        tools: [
+            "marketing_personas_list",
+            "marketing_campaign_create",
+            "marketing_campaign_run",
+            "marketing_campaign_report_result",
+        ],
+    },
+    {
+        name: "sessions",
+        description: "Save, load, list, and delete browser sessions",
+        tier: 2,
+        tools: [
+            "save_session",
+            "load_session",
+            "list_sessions",
+            "delete_session",
+        ],
+    },
+    // ── Tier 3: Specialist tools (~26 tools) ──
+    // Rarely needed, loaded only on explicit request
+    {
+        name: "persona_creation",
+        description: "Create custom personas via questionnaire or description",
+        tier: 3,
+        tools: [
+            "persona_create_start",
+            "persona_create_questionnaire_start",
+            "persona_create_questionnaire_answer",
+            "persona_create_from_description",
+            "persona_create_submit_traits",
+            "persona_create_cancel",
+        ],
+    },
+    {
+        name: "persona_values",
+        description: "Persona value systems, traits, influence patterns, and questionnaires",
+        tier: 3,
+        tools: [
+            "persona_values_list",
+            "persona_values_lookup",
+            "list_influence_patterns",
+            "persona_questionnaire_get",
+            "persona_questionnaire_build",
+            "persona_trait_lookup",
+            "persona_traits_list",
+            "persona_category_guidance",
+        ],
+    },
+    {
+        name: "browser_management",
+        description: "Browser health, recovery, reset, and status",
+        tier: 3,
+        tools: [
+            "status",
+            "browser_health",
+            "browser_recover",
+            "reset_browser",
+        ],
+    },
+    {
+        name: "advanced_interaction",
+        description: "Smart click with self-healing, dismiss overlays, find by intent, AI benchmark",
+        tier: 3,
+        tools: [
+            "smart_click",
+            "dismiss_overlay",
+            "find_element_by_intent",
+            "analyze_page",
+            "generate_tests",
+            "assert",
+            "ai_benchmark",
+        ],
+    },
+    {
+        name: "remediation",
+        description: "Generate remediation patches, llms.txt, structured data, and WebMCP audit",
+        tier: 3,
+        tools: [
+            "remediation_patches",
+            "llms_txt_generate",
+            "llms_txt_validate",
+            "llms_txt_diff",
+            "structured_data_suggest",
+            "webmcp_ready_audit",
+            "heal_stats",
+            "ask_user",
+        ],
+    },
+    // ── Enterprise Tools ──
+    {
+        name: "enterprise_security",
+        description: "Web security scanning and stealth mode for authorized domains",
+        tier: 2,
+        tools: [
+            "web_security_scan",
+            "stealth_status",
+            "stealth_enable",
+            "stealth_disable",
+            "stealth_check",
+            "stealth_diagnose",
+            "cloudflare_detect",
+            "cloudflare_wait",
+        ],
+    },
+    {
+        name: "enterprise_autonomous",
+        description: "Autonomous cognitive journeys and API key management",
+        tier: 2,
+        tools: [
+            "cognitive_journey_autonomous",
+            "set_api_key",
+            "clear_api_key",
+            "api_key_status",
+            "get_api_key_prompt",
+        ],
+    },
+    {
+        name: "enterprise_marketing",
+        description: "Advanced marketing: influence matrix, lever analysis, funnel analysis, competitive, audience discovery",
+        tier: 3,
+        tools: [
+            "marketing_influence_matrix",
+            "marketing_lever_analysis",
+            "marketing_funnel_analyze",
+            "marketing_compete",
+            "marketing_audience_discover",
+            "marketing_discover_status",
+        ],
+    },
+];
+/** Get tier for a tool name */
+export function getToolTier(toolName) {
+    for (const cat of TOOL_CATEGORIES) {
+        if (cat.tools.includes(toolName))
+            return cat.tier;
+    }
+    return 3; // default to tier 3 for unknown tools
+}
+/** Get category for a tool name */
+export function getToolCategory(toolName) {
+    for (const cat of TOOL_CATEGORIES) {
+        if (cat.tools.includes(toolName))
+            return cat.name;
+    }
+    return undefined;
+}
+/** Get all tools in a tier */
+export function getToolsByTier(tier) {
+    return TOOL_CATEGORIES
+        .filter(cat => cat.tier === tier)
+        .flatMap(cat => cat.tools);
+}
+/** Get category summary for LLM context (one line per category) */
+export function getCategorySummary() {
+    return TOOL_CATEGORIES
+        .filter(cat => cat.tier > 1)
+        .map(cat => `[${cat.name}] ${cat.description} (${cat.tools.length} tools: ${cat.tools.slice(0, 3).join(', ')}${cat.tools.length > 3 ? '...' : ''})`)
+        .join('\n');
+}
+//# sourceMappingURL=tool-categories.js.map

package/dist/mcp-tools/tool-categories.js.map

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

package/dist/types.d.ts

@@ -3347,6 +3347,14 @@ export interface AgentReadyAuditOptions {
      * @since v18.22.0
      */
     useRandomUserAgent?: boolean;
+    /** Proxy server for geo-accurate testing (e.g., { server: "socks5://host:port" }) @since v18.39.0 */
+    proxy?: {
+        server: string;
+        username?: string;
+        password?: string;
+    };
+    /** Browser locale for language-accurate testing (e.g., "en-US") @since v18.39.0 */
+    locale?: string;
 }
 /** Result for a single site in competitive benchmark */
 export interface SiteBenchmarkResult {