cbrowser 18.64.0 → 18.65.0

package/dist/ideal-profiles.js

@@ -0,0 +1,404 @@
+/**
+ * Ideal Interface Profiles — Research-backed attention targets per persona
+ *
+ * Defines the ideal attention distribution, structural constraints, and
+ * cognitive thresholds for each persona. Used by the gap score calculator
+ * to measure how well a page serves a specific user type.
+ *
+ * Also defines intent presets that modify attention weights based on
+ * user goals (learn, buy, support, compare, explore, signup).
+ *
+ * @version 1.0.0
+ * @since v18.60.0
+ */
+// ── Ideal Profiles ──
+export const IDEAL_PROFILES = [
+    {
+        persona: 'cognitive-adhd',
+        attentionTargets: {
+            cta: { min: 30, max: 60, ideal: 45 },
+            heading: { min: 15, max: 30, ideal: 20 },
+            navigation: { min: 0, max: 15, ideal: 5 },
+            content: { min: 5, max: 20, ideal: 10 },
+            decorative: { min: 0, max: 5, ideal: 0 },
+            search: { min: 0, max: 10, ideal: 5 },
+        },
+        structure: {
+            maxNavItems: 5,
+            maxCTAsAboveFold: 1,
+            maxContentBlockWords: 40,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 0,
+            requireColorRedundancy: false,
+            minTouchTarget: 44,
+            maxInformationDensity: 0.3,
+        },
+        thresholds: {
+            maxCTC: 0.6,
+            maxAbandonmentRisk: 40,
+            maxDecisionComplexity: 0.3,
+            maxReadabilityCost: 0.4,
+        },
+        research: [
+            'Barkley 1997',
+            'Castellanos & Tannock 2002',
+            'Sonuga-Barke 2005',
+        ],
+    },
+    {
+        persona: 'autism-spectrum',
+        attentionTargets: {
+            cta: { min: 15, max: 35, ideal: 25 },
+            heading: { min: 20, max: 40, ideal: 30 },
+            navigation: { min: 10, max: 25, ideal: 15 },
+            content: { min: 15, max: 30, ideal: 20 },
+            decorative: { min: 0, max: 3, ideal: 0 },
+            search: { min: 5, max: 15, ideal: 10 },
+        },
+        structure: {
+            maxNavItems: 7,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 80,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 0,
+            requireColorRedundancy: true,
+            minTouchTarget: 44,
+            maxInformationDensity: 0.4,
+        },
+        thresholds: {
+            maxCTC: 0.7,
+            maxAbandonmentRisk: 50,
+            maxDecisionComplexity: 0.4,
+            maxReadabilityCost: 0.5,
+        },
+        research: [
+            'Baron-Cohen 2009',
+            'Happ\u00e9 & Frith 2006',
+            'Kandalaft et al. 2013',
+        ],
+    },
+    {
+        persona: 'motor-impairment-tremor',
+        attentionTargets: {
+            cta: { min: 20, max: 40, ideal: 30 },
+            heading: { min: 15, max: 30, ideal: 20 },
+            navigation: { min: 5, max: 20, ideal: 10 },
+            content: { min: 10, max: 25, ideal: 15 },
+            decorative: { min: 0, max: 10, ideal: 5 },
+            search: { min: 5, max: 15, ideal: 10 },
+        },
+        structure: {
+            maxNavItems: 5,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 100,
+            requireVisibleLabels: true,
+            requirePredictableLayout: false,
+            maxAnimations: 5,
+            requireColorRedundancy: false,
+            minTouchTarget: 48,
+            maxInformationDensity: 0.5,
+        },
+        thresholds: {
+            maxCTC: 0.8,
+            maxAbandonmentRisk: 50,
+            maxDecisionComplexity: 0.5,
+            maxReadabilityCost: 0.6,
+        },
+        research: [],
+    },
+    {
+        persona: 'first-timer',
+        attentionTargets: {
+            cta: { min: 25, max: 50, ideal: 35 },
+            heading: { min: 20, max: 35, ideal: 25 },
+            navigation: { min: 10, max: 25, ideal: 15 },
+            content: { min: 10, max: 20, ideal: 15 },
+            decorative: { min: 0, max: 15, ideal: 5 },
+            search: { min: 0, max: 10, ideal: 5 },
+        },
+        structure: {
+            maxNavItems: 7,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 80,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 3,
+            requireColorRedundancy: false,
+            minTouchTarget: 44,
+            maxInformationDensity: 0.5,
+        },
+        thresholds: {
+            maxCTC: 0.8,
+            maxAbandonmentRisk: 50,
+            maxDecisionComplexity: 0.5,
+            maxReadabilityCost: 0.6,
+        },
+        research: [],
+    },
+    {
+        persona: 'impatient-user',
+        attentionTargets: {
+            cta: { min: 40, max: 70, ideal: 55 },
+            heading: { min: 10, max: 20, ideal: 15 },
+            navigation: { min: 0, max: 10, ideal: 5 },
+            content: { min: 0, max: 10, ideal: 5 },
+            decorative: { min: 0, max: 5, ideal: 0 },
+            search: { min: 10, max: 25, ideal: 15 },
+        },
+        structure: {
+            maxNavItems: 3,
+            maxCTAsAboveFold: 1,
+            maxContentBlockWords: 20,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 0,
+            requireColorRedundancy: false,
+            minTouchTarget: 44,
+            maxInformationDensity: 0.2,
+        },
+        thresholds: {
+            maxCTC: 0.5,
+            maxAbandonmentRisk: 30,
+            maxDecisionComplexity: 0.2,
+            maxReadabilityCost: 0.3,
+        },
+        research: [],
+    },
+    {
+        persona: 'elderly-user',
+        attentionTargets: {
+            cta: { min: 20, max: 40, ideal: 30 },
+            heading: { min: 20, max: 35, ideal: 25 },
+            navigation: { min: 10, max: 25, ideal: 20 },
+            content: { min: 10, max: 25, ideal: 15 },
+            decorative: { min: 0, max: 5, ideal: 2 },
+            search: { min: 0, max: 10, ideal: 5 },
+        },
+        structure: {
+            maxNavItems: 5,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 60,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 0,
+            requireColorRedundancy: true,
+            minTouchTarget: 48,
+            maxInformationDensity: 0.3,
+        },
+        thresholds: {
+            maxCTC: 0.7,
+            maxAbandonmentRisk: 45,
+            maxDecisionComplexity: 0.4,
+            maxReadabilityCost: 0.4,
+        },
+        research: [],
+    },
+    {
+        persona: 'low-vision-magnified',
+        attentionTargets: {
+            cta: { min: 20, max: 40, ideal: 30 },
+            heading: { min: 20, max: 40, ideal: 30 },
+            navigation: { min: 5, max: 20, ideal: 10 },
+            content: { min: 5, max: 20, ideal: 10 },
+            decorative: { min: 0, max: 5, ideal: 0 },
+            search: { min: 5, max: 15, ideal: 10 },
+        },
+        structure: {
+            maxNavItems: 5,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 60,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 0,
+            requireColorRedundancy: true,
+            minTouchTarget: 48,
+            maxInformationDensity: 0.3,
+        },
+        thresholds: {
+            maxCTC: 0.8,
+            maxAbandonmentRisk: 50,
+            maxDecisionComplexity: 0.5,
+            maxReadabilityCost: 0.5,
+        },
+        research: [],
+    },
+    {
+        persona: 'dyslexic-user',
+        attentionTargets: {
+            cta: { min: 20, max: 40, ideal: 30 },
+            heading: { min: 25, max: 40, ideal: 30 },
+            navigation: { min: 5, max: 20, ideal: 10 },
+            content: { min: 5, max: 15, ideal: 10 },
+            decorative: { min: 0, max: 10, ideal: 5 },
+            search: { min: 5, max: 15, ideal: 10 },
+        },
+        structure: {
+            maxNavItems: 5,
+            maxCTAsAboveFold: 2,
+            maxContentBlockWords: 40,
+            requireVisibleLabels: true,
+            requirePredictableLayout: true,
+            maxAnimations: 1,
+            requireColorRedundancy: false,
+            minTouchTarget: 44,
+            maxInformationDensity: 0.3,
+        },
+        thresholds: {
+            maxCTC: 0.7,
+            maxAbandonmentRisk: 45,
+            maxDecisionComplexity: 0.4,
+            maxReadabilityCost: 0.3,
+        },
+        research: [],
+    },
+];
+// ── Intent Presets ──
+export const INTENT_PRESETS = [
+    {
+        id: 'learn',
+        name: 'Learn / Research',
+        description: 'User wants to understand a topic, read documentation, or educate themselves',
+        elementModifiers: {
+            cta: 0.3,
+            heading: 1.8,
+            navigation: 1.3,
+            content: 1.5,
+            price: 0.2,
+            search: 1.0,
+            form: 0.3,
+            trust: 0.5,
+        },
+        keywordPatterns: ['how', 'what is', 'learn', 'understand', 'about', 'documentation', 'guide', 'tutorial'],
+    },
+    {
+        id: 'buy',
+        name: 'Purchase / Convert',
+        description: 'User intends to buy a product or complete a transaction',
+        elementModifiers: {
+            cta: 2.0,
+            heading: 0.8,
+            navigation: 0.5,
+            content: 0.3,
+            price: 2.0,
+            search: 0.5,
+            form: 1.5,
+            trust: 1.8,
+        },
+        keywordPatterns: ['buy', 'purchase', 'price', 'pricing', 'order', 'checkout', 'add to cart', 'shop'],
+    },
+    {
+        id: 'support',
+        name: 'Get Help / Support',
+        description: 'User is looking for help, troubleshooting, or customer support',
+        elementModifiers: {
+            cta: 0.5,
+            heading: 1.0,
+            navigation: 1.5,
+            content: 1.2,
+            price: 0.2,
+            search: 2.0,
+            form: 1.3,
+            trust: 0.5,
+        },
+        keywordPatterns: ['help', 'support', 'contact', 'issue', 'problem', 'fix', 'troubleshoot', 'FAQ'],
+    },
+    {
+        id: 'compare',
+        name: 'Compare Options',
+        description: 'User is evaluating alternatives and comparing features or prices',
+        elementModifiers: {
+            cta: 0.5,
+            heading: 1.5,
+            navigation: 0.8,
+            content: 1.2,
+            price: 2.0,
+            search: 0.5,
+            form: 0.3,
+            trust: 1.0,
+        },
+        keywordPatterns: ['compare', 'vs', 'versus', 'difference', 'which', 'best', 'alternative'],
+    },
+    {
+        id: 'explore',
+        name: 'Browse / Explore',
+        description: 'User is casually browsing without a specific goal',
+        elementModifiers: {
+            cta: 0.8,
+            heading: 1.5,
+            navigation: 1.5,
+            content: 1.0,
+            price: 0.5,
+            search: 1.0,
+            form: 0.3,
+            trust: 0.5,
+        },
+        keywordPatterns: ['browse', 'explore', 'see', 'look at', 'check out', 'discover'],
+    },
+    {
+        id: 'signup',
+        name: 'Sign Up / Register',
+        description: 'User wants to create an account or start a free trial',
+        elementModifiers: {
+            cta: 2.0,
+            heading: 1.0,
+            navigation: 0.3,
+            content: 0.3,
+            price: 1.0,
+            search: 0.3,
+            form: 2.0,
+            trust: 1.5,
+        },
+        keywordPatterns: ['sign up', 'register', 'create account', 'get started', 'join', 'start', 'free trial'],
+    },
+];
+// ── Lookup Functions ──
+const profileMap = new Map();
+for (const p of IDEAL_PROFILES) {
+    profileMap.set(p.persona, p);
+}
+const intentMap = new Map();
+for (const i of INTENT_PRESETS) {
+    intentMap.set(i.id, i);
+}
+/**
+ * Get the ideal profile for a persona.
+ * Returns undefined if no profile exists for this persona.
+ */
+export function getIdealProfile(persona) {
+    return profileMap.get(persona);
+}
+/**
+ * Detect user intent from goal text by matching keyword patterns.
+ * Returns the best-matching intent preset ID, or null if no match.
+ */
+export function detectIntent(goalText) {
+    if (!goalText)
+        return null;
+    const lower = goalText.toLowerCase();
+    let bestId = null;
+    let bestScore = 0;
+    for (const preset of INTENT_PRESETS) {
+        let score = 0;
+        for (const pattern of preset.keywordPatterns) {
+            if (lower.includes(pattern.toLowerCase())) {
+                // Longer patterns are more specific, weight them higher
+                score += pattern.length;
+            }
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestId = preset.id;
+        }
+    }
+    return bestId;
+}
+/**
+ * Get an intent preset by ID.
+ * Returns undefined if no preset exists for this ID.
+ */
+export function getIntentPreset(intentId) {
+    return intentMap.get(intentId);
+}
+//# sourceMappingURL=ideal-profiles.js.map

package/dist/ideal-profiles.js.map

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

package/dist/mcp-server-remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server-remote.d.ts","sourceRoot":"","sources":["../src/mcp-server-remote.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAmCH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAexC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAoBpE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCrG;AA6/BD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAq1B1F"}
+{"version":3,"file":"mcp-server-remote.d.ts","sourceRoot":"","sources":["../src/mcp-server-remote.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAmCH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAexC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAoBpE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCrG;AA6/BD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAm2B1F"}

package/dist/mcp-server-remote.js

@@ -1452,13 +1452,28 @@ ${VERSION}
         // OAuth Authorization Server Metadata (RFC 8414)
         // Return 404 when no Auth0 — prevents Claude.ai from initiating OAuth flow
         // Users authenticate via Bearer token (cbk_ API key) instead
-        if (url.pathname === "/.well-known/oauth-authorization-server" && !auth0Enabled) {
-            res.writeHead(404, { "Content-Type": "application/json" });
-            res.end(JSON.stringify({
-                error: "No OAuth server configured",
-                message: "Authenticate with a Bearer token. Get your API key at https://cbrowser.ai/account/register",
-            }));
-            return;
+        if (url.pathname === "/.well-known/oauth-authorization-server") {
+            const serverHost = req.headers.host || `${host}:${port}`;
+            const protocol = req.headers["x-forwarded-proto"] || "http";
+            const baseUrl = `${protocol}://${serverHost}`;
+            if (auth0Enabled) {
+                // Auth0-backed OAuth (existing behavior)
+            }
+            else {
+                // Self-hosted OAuth PKCE (built-in /authorize + /token)
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({
+                    issuer: baseUrl,
+                    authorization_endpoint: `${baseUrl}/authorize`,
+                    token_endpoint: `${baseUrl}/token`,
+                    response_types_supported: ["code"],
+                    grant_types_supported: ["authorization_code", "client_credentials"],
+                    code_challenge_methods_supported: ["S256"],
+                    token_endpoint_auth_methods_supported: ["none"],
+                    scopes_supported: [],
+                }));
+                return;
+            }
         }
         if (url.pathname === "/.well-known/oauth-protected-resource") {
             const metadata = getProtectedResourceMetadata();
@@ -1468,15 +1483,14 @@ ${VERSION}
                 res.end(JSON.stringify(metadata));
             }
             else {
-                // No OAuth provider — advertise API key auth only
-                // Claude.ai will prompt user for Bearer token (their cbk_ API key)
+                // Self-hosted OAuth — advertise built-in auth server
                 const serverHost = req.headers.host || `${host}:${port}`;
                 const protocol = req.headers["x-forwarded-proto"] || "http";
                 const baseUrl = `${protocol}://${serverHost}`;
                 res.writeHead(200, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({
                     resource: baseUrl,
-                    authorization_servers: [],
+                    authorization_servers: [baseUrl],
                     bearer_methods_supported: ["header"],
                     scopes_supported: [],
                     resource_documentation: `${protocol}://${serverHost}/docs`,