cbrowser 19.2.1 → 19.2.3

package/dist/mcp-tools/security-layer.d.ts

@@ -14,6 +14,39 @@ export interface DescriptionScanSummary {
 }
 /** What the most recent registration pass found. Read-only. */
 export declare function getDescriptionScanSummary(): DescriptionScanSummary;
+/** True when a tool's result is cbrowser's own computed analysis and may have its float residue removed. */
+export declare function isComputedAnalysisTool(name: string): boolean;
+/**
+ * Rewrite the residue-carrying number tokens of a JSON text, and nothing
+ * else. A scanner, not a parse-and-stringify: it tracks string state and
+ * escapes, and replaces only number tokens OUTSIDE strings whose value
+ * carries residue and changes when cleaned. Every other byte -- big integer
+ * literals, other numbers, whitespace, key order, string contents -- is
+ * returned as it came. The caller decides the text is JSON.
+ */
+export declare function cleanResidueInJsonText(text: string): string;
+/**
+ * Remove binary floating-point residue from a computed-analysis tool's
+ * result. The secured wrapper calls it only for isComputedAnalysisTool names.
+ *
+ * Customers read `totalBarrierDeduction: 29.299999999999997`,
+ * `cognitiveLoad: 0.43019999999999997` and `0.30000000000000004` in JSON that
+ * was otherwise rounded. There are ~117 hand-written Math.round sites in src/
+ * and two private round3 copies, which is how a field gets missed: rounding at
+ * each producer depends on every producer remembering. (2026-10-09)
+ *
+ * - A "text" block is touched only if it contains residue AND parses as JSON,
+ *   and then only its residue-carrying number tokens are rewritten
+ *   (cleanResidueInJsonText); every other byte is kept. Non-JSON text and
+ *   image blocks are untouched.
+ * - `structuredContent` (already an object, so no bytes to keep) has each
+ *   residue-carrying number cleaned.
+ * - Strings are never edited: "0.30000000000000004" stays a string.
+ *
+ * 12 significant digits removes residue (it lives at the 16th-17th) without
+ * moving a real value; 1e-9 and integers pass through unchanged.
+ */
+export declare function cleanFloatResidue(result: unknown): unknown;
 /**
  * Wrap a server so every tool registered through it is audited and zone-checked.
  *

package/dist/mcp-tools/security-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-layer.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/security-layer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAID,+DAA+D;AAC/D,wBAAgB,yBAAyB,IAAI,sBAAsB,CAElE;AAOD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAoG5F"}
+{"version":3,"file":"security-layer.d.ts","sourceRoot":"","sources":["../../src/mcp-tools/security-layer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAID,+DAA+D;AAC/D,wBAAgB,yBAAyB,IAAI,sBAAsB,CAElE;AAgED,4GAA4G;AAC5G,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAKD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsC3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAgC1D;AAOD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAuG5F"}

package/dist/mcp-tools/security-layer.js

@@ -42,6 +42,193 @@ let lastScan = { scanned: 0, flagged: [] };
 export function getDescriptionScanSummary() {
     return { scanned: lastScan.scanned, flagged: [...lastScan.flagged] };
 }
+/**
+ * Binary floating-point residue: a run of six or more 0s or 9s after the
+ * decimal point, followed by one more digit. `0.30000000000000004`,
+ * `29.299999999999997` and `0.43019999999999997` all match; `0.3`, `29.3`,
+ * `1e-9` and integers do not. A cheap gate so a clean payload is never parsed,
+ * and the per-number test: only a number that carries residue is rewritten.
+ */
+const FLOAT_RESIDUE = /\d\.\d*(?:0{6,}|9{6,})\d/;
+/** Twelve significant digits: below every measurement this package makes, above the residue. */
+function cleanNumber(v) {
+    return Number.isFinite(v) && !Number.isInteger(v) ? Number(v.toPrecision(12)) : v;
+}
+/** A number cleaned only when its shortest form carries residue; every other number is returned as is. */
+function cleanIfResidue(v) {
+    return FLOAT_RESIDUE.test(String(v)) ? cleanNumber(v) : v;
+}
+/** Deep copy of plain objects and arrays with residue cleaned; anything else is passed through. */
+function cleanDeep(v) {
+    if (typeof v === "number")
+        return cleanIfResidue(v);
+    if (Array.isArray(v))
+        return v.map(cleanDeep);
+    if (v && typeof v === "object" && Object.getPrototypeOf(v) === Object.prototype) {
+        const out = {};
+        for (const [k, x] of Object.entries(v))
+            out[k] = cleanDeep(x);
+        return out;
+    }
+    return v;
+}
+/**
+ * The tools whose results are cbrowser's OWN computed analysis -- scores,
+ * deductions, weights, distances, persona state -- and so the only ones whose
+ * float residue is ours to remove. An explicit opt-in, never a default.
+ *
+ * Applied to every tool, the clean-up rewrote page data: evaluate_script
+ * returned a customer's `{cartTotal: 29.299999999999997}` as 29.3, masking the
+ * very float bug they were inspecting, and the whole-block re-serialization
+ * moved values with more than 12 significant digits and corrupted integer
+ * literals above 2^53. Page-data tools (evaluate_script, extract, get_*,
+ * cookies, storage, console and network logs, nl_test results, screenshots,
+ * navigation) are deliberately absent. (Round 2, 2026-10-09)
+ */
+const COMPUTED_ANALYSIS_PREFIX = /^(?:(?:empathy|attention|cognitive|persona|marketing)_|compare_personas(?:_|$))/;
+const COMPUTED_ANALYSIS_TOOLS = new Set([
+    "list_cognitive_personas",
+    "list_emotional_personas",
+    "get_emotional_state",
+    "trigger_emotional_event",
+    "list_influence_patterns",
+    "agent_ready_audit",
+    "hunt_bugs",
+    "site_cognitive_assessment",
+    "visual_cognitive_story",
+    "competitive_benchmark",
+    "journey_heatmap_gif",
+    "webmcp_ready_audit",
+    "ai_benchmark",
+    "transport_map",
+]);
+/** True when a tool's result is cbrowser's own computed analysis and may have its float residue removed. */
+export function isComputedAnalysisTool(name) {
+    return COMPUTED_ANALYSIS_TOOLS.has(name) || COMPUTED_ANALYSIS_PREFIX.test(name);
+}
+/** One JSON number token, per RFC 8259, anchored where the scanner stands. */
+const NUMBER_TOKEN = /-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?/y;
+/**
+ * Rewrite the residue-carrying number tokens of a JSON text, and nothing
+ * else. A scanner, not a parse-and-stringify: it tracks string state and
+ * escapes, and replaces only number tokens OUTSIDE strings whose value
+ * carries residue and changes when cleaned. Every other byte -- big integer
+ * literals, other numbers, whitespace, key order, string contents -- is
+ * returned as it came. The caller decides the text is JSON.
+ */
+export function cleanResidueInJsonText(text) {
+    const chunks = [];
+    let last = 0;
+    let i = 0;
+    const n = text.length;
+    while (i < n) {
+        const ch = text.charCodeAt(i);
+        if (ch === 34 /* " */) {
+            i++;
+            while (i < n) {
+                const c = text.charCodeAt(i);
+                if (c === 92 /* backslash */) {
+                    i += 2;
+                    continue;
+                }
+                i++;
+                if (c === 34)
+                    break;
+            }
+            continue;
+        }
+        if (ch === 45 /* - */ || (ch >= 48 && ch <= 57)) {
+            NUMBER_TOKEN.lastIndex = i;
+            const m = NUMBER_TOKEN.exec(text);
+            if (!m) {
+                i++;
+                continue;
+            }
+            const start = i;
+            i += m[0].length;
+            if (FLOAT_RESIDUE.test(m[0])) {
+                const v = Number(m[0]);
+                const c = cleanNumber(v);
+                if (c !== v) {
+                    chunks.push(text.slice(last, start), String(c));
+                    last = i;
+                }
+            }
+            continue;
+        }
+        i++;
+    }
+    if (chunks.length === 0)
+        return text;
+    chunks.push(text.slice(last));
+    return chunks.join("");
+}
+/**
+ * Remove binary floating-point residue from a computed-analysis tool's
+ * result. The secured wrapper calls it only for isComputedAnalysisTool names.
+ *
+ * Customers read `totalBarrierDeduction: 29.299999999999997`,
+ * `cognitiveLoad: 0.43019999999999997` and `0.30000000000000004` in JSON that
+ * was otherwise rounded. There are ~117 hand-written Math.round sites in src/
+ * and two private round3 copies, which is how a field gets missed: rounding at
+ * each producer depends on every producer remembering. (2026-10-09)
+ *
+ * - A "text" block is touched only if it contains residue AND parses as JSON,
+ *   and then only its residue-carrying number tokens are rewritten
+ *   (cleanResidueInJsonText); every other byte is kept. Non-JSON text and
+ *   image blocks are untouched.
+ * - `structuredContent` (already an object, so no bytes to keep) has each
+ *   residue-carrying number cleaned.
+ * - Strings are never edited: "0.30000000000000004" stays a string.
+ *
+ * 12 significant digits removes residue (it lives at the 16th-17th) without
+ * moving a real value; 1e-9 and integers pass through unchanged.
+ */
+export function cleanFloatResidue(result) {
+    if (!result || typeof result !== "object")
+        return result;
+    const r = result;
+    let out = null;
+    const edit = () => (out ??= { ...result });
+    if (Array.isArray(r.content)) {
+        let changedAny = false;
+        const blocks = r.content.map((block) => {
+            const b = block;
+            if (!b || b.type !== "text" || typeof b.text !== "string")
+                return block;
+            const text = b.text;
+            const lead = text.trimStart()[0];
+            if ((lead !== "{" && lead !== "[") || !FLOAT_RESIDUE.test(text))
+                return block;
+            try {
+                JSON.parse(text);
+            }
+            catch {
+                return block;
+            }
+            const next = cleanResidueInJsonText(text);
+            if (next === text)
+                return block;
+            changedAny = true;
+            return { ...block, text: next };
+        });
+        if (changedAny)
+            edit().content = blocks;
+    }
+    if (r.structuredContent && typeof r.structuredContent === "object") {
+        let serialized;
+        try {
+            serialized = JSON.stringify(r.structuredContent);
+        }
+        catch {
+            serialized = undefined;
+        }
+        if (serialized && FLOAT_RESIDUE.test(serialized)) {
+            edit().structuredContent = cleanDeep(r.structuredContent);
+        }
+    }
+    return out ?? result;
+}
 /** Red-zone denial is opt-in; see the module comment for why. */
 function redZoneEnforced() {
     return process.env.CBROWSER_ENFORCE_RED_ZONE === "true" || process.env.CBROWSER_ENFORCE_RED_ZONE === "1";
@@ -107,7 +294,10 @@ export function applySecurityLayer(server, opts) {
                         }],
                 };
             }
-            return handler(...args);
+            const result = await handler(...args);
+            // Residue is removed from cbrowser's own computed analysis only, never
+            // from page data. See isComputedAnalysisTool and cleanFloatResidue.
+            return isComputedAnalysisTool(name) ? cleanFloatResidue(result) : result;
         };
         // Audit wraps the outermost call so a zone refusal is recorded too.
         // wrapToolHandler calls handler(params) with one argument; MCP passes

package/dist/mcp-tools/security-layer.js.map

@@ -1 +1 @@
-{"version":3,"file":"security-layer.js","sourceRoot":"","sources":["../../src/mcp-tools/security-layer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"security-layer.js","sourceRoot":"","sources":["../../src/mcp-tools/security-layer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AASzE,IAAI,QAAQ,GAA2B,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB;IACvC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAEjD,gGAAgG;AAChG,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,0GAA0G;AAC1G,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,mGAAmG;AACnG,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,wBAAwB,GAAG,iFAAiF,CAAC;AACnH,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,yBAAyB;IACzB,yBAAyB;IACzB,qBAAqB;IACrB,yBAAyB;IACzB,yBAAyB;IACzB,mBAAmB;IACnB,WAAW;IACX,2BAA2B;IAC3B,wBAAwB;IACxB,uBAAuB;IACvB,qBAAqB;IACrB,oBAAoB;IACpB,cAAc;IACd,eAAe;CAChB,CAAC,CAAC;AAEH,4GAA4G;AAC5G,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC;AAED,8EAA8E;AAC9E,MAAM,YAAY,GAAG,8CAA8C,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC,EAAE,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,CAAC,KAAK,EAAE,CAAC,eAAe,EAAE,CAAC;oBAAC,CAAC,IAAI,CAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBACnD,CAAC,EAAE,CAAC;gBACJ,IAAI,CAAC,KAAK,EAAE;oBAAE,MAAM;YACtB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAChD,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAAC,CAAC,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,CAAC,CAAC;YAChB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACjB,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChD,IAAI,GAAG,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QACD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACzD,MAAM,CAAC,GAAG,MAA4D,CAAC;IACvE,IAAI,GAAG,GAAmC,IAAI,CAAC;IAC/C,MAAM,IAAI,GAAG,GAA4B,EAAE,CAAC,CAAC,GAAG,KAAK,EAAE,GAAI,MAAkC,EAAE,CAAC,CAAC;IAEjG,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACrC,MAAM,CAAC,GAAG,KAA2C,CAAC;YACtD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACxE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9E,IAAI,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;YACjD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAChC,UAAU,GAAG,IAAI,CAAC;YAClB,OAAO,EAAE,GAAI,KAAiC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,IAAI,UAAU;YAAE,IAAI,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,CAAC,iBAAiB,IAAI,OAAO,CAAC,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QACnE,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,UAAU,GAAG,SAAS,CAAC;QAAC,CAAC;QAC3F,IAAI,UAAU,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,IAAI,EAAE,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,GAAG,IAAI,MAAM,CAAC;AACvB,CAAC;AAED,iEAAiE;AACjE,SAAS,eAAe;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe,EAAE,IAA+B;IACjF,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,+EAA+E;IAC/E,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,GAAG,GAAG,MAGX,CAAC;IACF,MAAM,oBAAoB,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzD,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,kBAAkB,EAAE,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,wDAAwD;QACxD,KAAK,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC7H,CAAC;IAED,QAAQ,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAEvC,+EAA+E;IAC/E,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,WAAoB,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;gBACnD,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBACjD,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,4CAA4C,CAAC,CAAC;IAC1D,CAAC,CAAC;IAEF,kDAAkD;IAClD,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,OAAwC,EAAE,EAAE;QACxE,MAAM,OAAO,GAAG,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAC3C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YAC9D,2EAA2E;YAC3E,gEAAgE;YAChE,MAAM,MAAM,GACV,QAAQ,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,IAAI,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACnG,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,sBAAsB;gCAC7B,IAAI,EAAE,IAAI;gCACV,IAAI,EAAE,QAAQ,CAAC,IAAI;gCACnB,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,SAAS,IAAI,kCAAkC;6BAC7E,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ,CAAC;iBACH,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAO,OAAiD,CAAC,GAAG,IAAI,CAAC,CAAC;YACjF,uEAAuE;YACvE,oEAAoE;YACpE,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3E,CAAC,CAAC;QAEF,oEAAoE;QACpE,sEAAsE;QACtE,yEAAyE;QACzE,uDAAuD;QACvD,MAAM,OAAO,GAAG,eAAe,CAC7B,CAAC,CAAC,MAA+B,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAqD,EAC1G,IAAI,EACJ,KAAK,CACwC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,IAAI,oBAAoB,EAAE,CAAC;QACzB,GAAG,CAAC,YAAY,GAAG,CAAC,IAAY,EAAE,MAA+B,EAAE,OAAwC,EAAE,EAAE;YAC7G,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;YAChC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,yEAAyE;IACzE,iCAAiC;IACjC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,YAAY,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;YACjE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,OAAO,OAAO,KAAK,UAAU;gBAAE,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;YAChE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,aAAa,IAAK,CAAY,CAAC,CAAC;YACnG,IAAI,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,WAAyC,EAAE,WAAW,CAAC,CAAC;YAC5G,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,OAAuC,CAAC,CAAC;YACzE,OAAO,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/navigation-errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * A plain-language message for a navigation error, or null when the error is
+ * not one of the known net:: failures (the caller then keeps the original).
+ *
+ * The message names the host, says what to check, says nothing was loaded,
+ * and ends with the net:: code in parentheses for anyone searching it. The
+ * Playwright "Call log" is dropped.
+ */
+export declare function describeNavigationError(message: string, url: string): string | null;
+/**
+ * The error to throw for a failed navigation: a new Error carrying
+ * describeNavigationError's message when the failure is a known net:: code,
+ * otherwise the original error unchanged.
+ */
+export declare function navigationError(error: unknown, url: string): unknown;
+//# sourceMappingURL=navigation-errors.d.ts.map

package/dist/navigation-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-errors.d.ts","sourceRoot":"","sources":["../src/navigation-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkFH;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIpE"}

package/dist/navigation-errors.js

@@ -0,0 +1,119 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * Plain-language messages for navigation failures.
+ *
+ * Reported: navigate("https://cbrowser.ai.invalid/") returned Playwright's raw
+ * error,
+ *
+ *   page.goto: net::ERR_NAME_NOT_RESOLVED at https://cbrowser.ai.invalid/
+ *   Call log:
+ *     - navigating to "https://cbrowser.ai.invalid/", waiting until "load"
+ *
+ * which says what Chromium did, not what the caller should do, and carries a
+ * Call log that is noise to anyone but a Playwright maintainer. navigate()
+ * mapped only the proxy errors (ERR_TUNNEL / ERR_PROXY / ERR_NETWORK_CHANGED)
+ * and rethrew everything else as is.
+ *
+ * Pure: no browser, no Playwright import, so any module that calls page.goto
+ * can use it.
+ */
+/** net:: codes mapped to a sentence about the host. `{host}` is filled in. */
+const NET_ERRORS = [
+    {
+        code: /^ERR_NAME_NOT_RESOLVED$/,
+        describe: (host) => `Could not resolve host ${host}. Check the URL spelling or network access. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_CONNECTION_REFUSED$/,
+        describe: (host) => `Connection to ${host} was refused: nothing is listening there, or a firewall rejected it. Check the address and port. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_(CONNECTION_)?TIMED_OUT$/,
+        describe: (host) => `Connection to ${host} timed out: the host did not answer. Check the address and network access. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_ADDRESS_UNREACHABLE$/,
+        describe: (host) => `Host ${host} is unreachable from this machine (no route to it). Check the address and network access. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_INTERNET_DISCONNECTED$/,
+        describe: (host) => `No network connection: could not reach ${host}. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_(CONNECTION_RESET|CONNECTION_CLOSED|EMPTY_RESPONSE)$/,
+        describe: (host) => `${host} closed the connection without sending a page. The server may be down or rejecting this client. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_CERT_[A-Z_]+$/,
+        describe: (host, code) => `The TLS certificate for ${host} was rejected (${certReason(code)}). Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_SSL_[A-Z_]+$/,
+        describe: (host) => `A secure (TLS) connection to ${host} could not be established. Nothing was loaded.`,
+    },
+    {
+        code: /^ERR_TOO_MANY_REDIRECTS$/,
+        describe: (host) => `${host} redirected too many times (a redirect loop). Nothing was loaded.`,
+    },
+];
+function certReason(code) {
+    if (code === "ERR_CERT_DATE_INVALID")
+        return "expired or not yet valid";
+    if (code === "ERR_CERT_COMMON_NAME_INVALID")
+        return "issued for a different host name";
+    if (code === "ERR_CERT_AUTHORITY_INVALID")
+        return "issued by an untrusted authority, for example self-signed";
+    if (code === "ERR_CERT_REVOKED")
+        return "revoked";
+    return "invalid";
+}
+/** host[:port] of `url`, or the url itself when it does not parse. */
+function hostOf(url, message) {
+    try {
+        return new URL(url).host || url;
+    }
+    catch {
+        const at = message.match(/ at (\S+)/)?.[1];
+        if (at) {
+            try {
+                return new URL(at).host || at;
+            }
+            catch {
+                return at;
+            }
+        }
+        return url;
+    }
+}
+/**
+ * A plain-language message for a navigation error, or null when the error is
+ * not one of the known net:: failures (the caller then keeps the original).
+ *
+ * The message names the host, says what to check, says nothing was loaded,
+ * and ends with the net:: code in parentheses for anyone searching it. The
+ * Playwright "Call log" is dropped.
+ */
+export function describeNavigationError(message, url) {
+    const code = message.match(/net::(ERR_[A-Z_]+)/)?.[1];
+    if (!code)
+        return null;
+    const entry = NET_ERRORS.find((e) => e.code.test(code));
+    if (!entry)
+        return null;
+    return `${entry.describe(hostOf(url, message), code)} (net::${code})`;
+}
+/**
+ * The error to throw for a failed navigation: a new Error carrying
+ * describeNavigationError's message when the failure is a known net:: code,
+ * otherwise the original error unchanged.
+ */
+export function navigationError(error, url) {
+    const message = error instanceof Error ? error.message : String(error ?? "");
+    const described = describeNavigationError(message, url);
+    return described ? new Error(described) : error;
+}
+//# sourceMappingURL=navigation-errors.js.map

package/dist/navigation-errors.js.map

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

package/dist/personas.d.ts

@@ -204,6 +204,11 @@ export declare function suggestPersonaNames(requested: string, limit?: number):
  * known name is not defining a persona, it is a typo. (2026-08-02)
  */
 export declare function resolvePersonaOrThrow(name: string, syntheticTraits?: Record<string, number> | undefined): Persona | AccessibilityPersona | AgentPersona;
+/**
+ * Shorthand -> roster name, shared by every persona-accepting tool.
+ * v14.2.5: Added elderly-user mapping (issue #190 - persona dropout)
+ */
+export declare const PERSONA_ALIASES: Record<string, string>;
 /**
  * Resolve a persona name for a measuring tool, or refuse - the one resolver.
  *
@@ -219,7 +224,7 @@ export declare function resolvePersonaOrThrow(name: string, syntheticTraits?: Re
  * When the name that measured differs from the one asked for, `resolvedFrom`
  * says so; a silent substitution reads as the requested persona's result.
  */
-export declare function resolvePersonaForTool(requested: string, aliases?: Record<string, string>): {
+export declare function resolvePersonaForTool(requested: string, aliases?: Record<string, string>, aliasFirst?: boolean): {
     name: string;
     persona: Persona | AccessibilityPersona | AgentPersona;
     resolvedFrom?: string;

package/dist/personas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../src/personas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../src/personas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpI,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAwD/H,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAIpF;AAiCD,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+D5D;AAED;;GAEG;AACH;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,eAAe,CAAC,EAAE,eAAe,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAMrG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAwBzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAwBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoCxF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAehF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAY7E;AAMD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CA+OT;AAmND;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;IACnD,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACxB,GACL,OAAO,CAkFT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,GAAG,gBAAgB,CAgT7F;AAMD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAwmBpD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAgB5D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAOvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAMD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CA4mCvE,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAEtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,oBAAoB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAwCxH;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAwTtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AA2CD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,oBAAoB,GAAG,YAAY,GAAG,SAAS,CA8CrG;AAED;;;;GAIG;AACH;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAEhC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE;IADtE,QAAQ,CAAC,IAAI,qBAAqB;gBACb,SAAS,EAAE,MAAM,EAAW,WAAW,EAAE,MAAM,EAAE;CAQvE;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CA8B1E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACnD,OAAO,GAAG,oBAAoB,GAAG,YAAY,CAO/C;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoClD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,EACjD,UAAU,UAAQ,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,GAAG,YAAY,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAYjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAOpE;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAI1D;AAOD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/personas.js

@@ -3485,6 +3485,47 @@ export function resolvePersonaOrThrow(name, syntheticTraits) {
     }
     throw new UnknownPersonaError(name, suggestPersonaNames(name));
 }
+/**
+ * Shorthand -> roster name, shared by every persona-accepting tool.
+ * v14.2.5: Added elderly-user mapping (issue #190 - persona dropout)
+ */
+export const PERSONA_ALIASES = {
+    "motor-tremor": "motor-impairment-tremor",
+    "motor": "motor-impairment-tremor",
+    "tremor": "motor-impairment-tremor",
+    "low-vision": "low-vision-magnified",
+    "vision": "low-vision-magnified",
+    "magnified": "low-vision-magnified",
+    "adhd": "cognitive-adhd",
+    "cognitive": "cognitive-adhd",
+    "attention": "cognitive-adhd",
+    "dyslexia": "dyslexic-user",
+    "dyslexic": "dyslexic-user",
+    "reading": "dyslexic-user",
+    "deaf": "deaf-user",
+    "hearing": "deaf-user",
+    "elderly": "elderly-low-vision",
+    "elderly-user": "elderly-low-vision", // v14.2.5: Added missing mapping
+    "elderly-low-vision": "elderly-low-vision",
+    "senior": "elderly-low-vision",
+    "old": "elderly-low-vision", // v14.2.5: Additional synonym
+    "color-blind": "color-blind-deuteranopia",
+    "colorblind": "color-blind-deuteranopia",
+    "deuteranopia": "color-blind-deuteranopia",
+    // v18.35.0: New research-backed cognitive disability personas
+    "autism": "autism-spectrum",
+    "autistic": "autism-spectrum",
+    "asd": "autism-spectrum",
+    "autism-spectrum": "autism-spectrum",
+    "intellectual-disability": "intellectual-disability",
+    "intellectual": "intellectual-disability",
+    "learning-disability": "intellectual-disability",
+    "aphasia": "aphasia-receptive",
+    "aphasia-receptive": "aphasia-receptive",
+    "wernicke": "aphasia-receptive",
+    "dyscalculia": "dyscalculia",
+    "numeracy": "dyscalculia",
+};
 /**
  * Resolve a persona name for a measuring tool, or refuse - the one resolver.
  *
@@ -3500,8 +3541,14 @@ export function resolvePersonaOrThrow(name, syntheticTraits) {
  * When the name that measured differs from the one asked for, `resolvedFrom`
  * says so; a silent substitution reads as the requested persona's result.
  */
-export function resolvePersonaForTool(requested, aliases) {
-    const aliased = aliases?.[requested.toLowerCase()] ?? requested;
+export function resolvePersonaForTool(requested, aliases = PERSONA_ALIASES, aliasFirst = false) {
+    // One alias table for every tool: "motor-tremor" resolved in empathy_audit
+    // and was refused by attention_analysis (report v2). Aliases are a FALLBACK by
+    // default, so an exact roster name always wins; empathy_audit passes
+    // aliasFirst because its table deliberately maps elderly-user to the
+    // elderly-low-vision accessibility persona. (2026-10-09)
+    const alias = aliases[requested.toLowerCase()];
+    const aliased = alias && (aliasFirst || !getAnyPersona(requested)) ? alias : requested;
     const persona = getAnyPersona(aliased);
     if (!persona)
         throw new UnknownPersonaError(requested, suggestPersonaNames(requested));