@teaflask/assistant 0.0.0 → 0.3.0

package/dist/reader/read-page.js

@@ -0,0 +1,172 @@
+// One builtin.read_page request in, one landable result out: snapshot
+// the page the mount lives in, render it, fit it under the tool-results
+// door's size cap, and — on a repeat read — deliver the unified diff
+// against the previous read when that is the cheaper payload. The
+// baseline lives here at module level, per thread: the handler map's
+// identity churns with its React deps, and a baseline that died on every
+// re-render would never produce a diff. An empty diff (is_diff with ""
+// content) means the page is unchanged since the previous read.
+import { boundedTextOf, doorCostOfText } from "../transport/door-budget.js";
+import { unifiedDiffOf } from "./line-diff.js";
+import { pageHeaderOf, renderedTreeOf } from "./render.js";
+import { DEFAULT_MAX_DEPTH, resolvedSnapshotRootOf, snapshotTreeOf, } from "./snapshot.js";
+// The content budget under the door's 20k serialized cap, measured in
+// the door's own metric (door-budget.ts): 16k leaves headroom for the
+// result's url/title/flag siblings, mirroring the action-response bound.
+const READ_PAGE_CONTENT_MAX_CHARS = 16_000;
+// When the full-depth tree overflows, re-render shallower until it fits.
+const DEPTH_LADDER = [30, 20, 12, 8, 5, 3];
+const TRUNCATION_NOTICE = "… [truncated: the page holds more than fits here]";
+const MAX_TITLE_LENGTH = 300;
+const MAX_URL_LENGTH = 2_000;
+/**
+ * An expected, recoverable read refusal — a stale ref, a selector that
+ * matches nothing, a page with no body yet. Its message is the reader's
+ * own model-actionable sentence (usually "take a fresh full read"), and
+ * the handler delivers it verbatim: wrapping it in give-up prose would
+ * cancel the retry the sentence asks for. A reader crash is anything
+ * else.
+ */
+export class SnapshotUnavailableError extends Error {
+}
+const _baselineByThread = new Map();
+export function readPageResultOf(threadId, action, probe) {
+    const request = _readRequestOf(action, probe);
+    const scope = _scopeKeyOf(request);
+    const fitted = _fittedTreeTextOf(request);
+    const content = _cheaperOfDiffAndFull(threadId, scope, fitted);
+    _baselineByThread.set(threadId, {
+        scope,
+        shape: fitted.shape,
+        text: fitted.text,
+    });
+    return {
+        url: boundedTextOf(document.location.href, MAX_URL_LENGTH),
+        title: boundedTextOf(document.title.replace(/\s+/g, " ").trim(), MAX_TITLE_LENGTH),
+        content: content.text,
+        is_diff: content.isDiff,
+        truncated: fitted.truncated,
+    };
+}
+export function _resetBaselinesForTests() {
+    _baselineByThread.clear();
+}
+function _readRequestOf(action, probe) {
+    // Wire defense only: the knobs are model-supplied and optional, and a
+    // wrong-typed knob degrades to its default rather than failing a read.
+    return {
+        probe,
+        ignoreSelectors: _stringListOf(action?.ignore_selectors),
+        maxDepth: _depthOf(action?.max_depth),
+        interactive: action?.interactive === true,
+        showHidden: action?.show_hidden === true,
+        selector: _nonEmptyStringOf(action?.selector),
+        refId: _nonEmptyStringOf(action?.ref_id),
+        rootElement: null,
+    };
+}
+function _fittedTreeTextOf(request) {
+    // Resolve the root once and pin the element: the ladder below renders
+    // the same read several times, each render rebuilds the ref registry,
+    // and a ref whose element changed identity since minting would resolve
+    // on the first render and be gone by the second — a read must not fail
+    // on payload size where the same request succeeds when small.
+    const rooting = resolvedSnapshotRootOf(request);
+    if (rooting.error !== null) {
+        throw new SnapshotUnavailableError(rooting.error);
+    }
+    const pinned = { ...request, rootElement: rooting.root };
+    const header = pageHeaderOf(document.title, document.location.href);
+    const fullText = `${header}\n${_renderedSnapshotOf(pinned)}`;
+    if (doorCostOfText(fullText) <= READ_PAGE_CONTENT_MAX_CHARS) {
+        return { text: fullText, truncated: false, shape: "full" };
+    }
+    for (const rung of DEPTH_LADDER) {
+        if (rung >= pinned.maxDepth) {
+            continue;
+        }
+        const shallower = `${header}\n${_renderedSnapshotOf({ ...pinned, maxDepth: rung })}`;
+        if (doorCostOfText(shallower) <= READ_PAGE_CONTENT_MAX_CHARS) {
+            return {
+                text: shallower,
+                truncated: true,
+                shape: `depth:${String(rung)}`,
+            };
+        }
+    }
+    // Even the shallowest rung overflows: deliver the full outline cut on
+    // line boundaries. Re-render it first so the ref registry matches the
+    // refs this outline shows — every ladder rung above rebuilt the registry
+    // as it ran, so it currently holds the shallowest rung's refs, not the
+    // deep ones a ref_id follow-up read would look up. Refs are stable, so
+    // this reproduces fullText exactly while restoring the full registry.
+    const fullTextAgain = `${header}\n${_renderedSnapshotOf(pinned)}`;
+    return {
+        text: _lineBoundedTextOf(fullTextAgain),
+        truncated: true,
+        shape: "line-bounded",
+    };
+}
+function _renderedSnapshotOf(request) {
+    const outcome = snapshotTreeOf(request);
+    if (outcome.error !== null) {
+        throw new SnapshotUnavailableError(outcome.error);
+    }
+    return renderedTreeOf(outcome.tree);
+}
+function _cheaperOfDiffAndFull(threadId, scope, fitted) {
+    const baseline = _baselineByThread.get(threadId);
+    if (baseline?.scope !== scope || baseline.shape !== fitted.shape) {
+        return { text: fitted.text, isDiff: false };
+    }
+    // Two line-bounded renders share a shape, but the cut point slides
+    // with any earlier change — tail sections would flap in and out of the
+    // diff as removals that never happened. Those reads deliver in full.
+    if (fitted.shape === "line-bounded") {
+        return { text: fitted.text, isDiff: false };
+    }
+    const diff = unifiedDiffOf(baseline.text, fitted.text);
+    if (doorCostOfText(diff) < doorCostOfText(fitted.text)) {
+        return { text: diff, isDiff: true };
+    }
+    return { text: fitted.text, isDiff: false };
+}
+function _scopeKeyOf(request) {
+    // Everything that shapes the rendered view except the probe — including
+    // the page itself: a client-side navigation keeps this module alive, and
+    // diffing the new page against the old one would read the old page's
+    // unique content as removals.
+    return JSON.stringify({
+        url: document.location.href,
+        interactive: request.interactive,
+        maxDepth: request.maxDepth,
+        showHidden: request.showHidden,
+        selector: request.selector,
+        refId: request.refId,
+        ignoreSelectors: request.ignoreSelectors,
+    });
+}
+function _lineBoundedTextOf(text) {
+    const noticeCost = doorCostOfText(`\n${TRUNCATION_NOTICE}`);
+    const bounded = boundedTextOf(text, READ_PAGE_CONTENT_MAX_CHARS - noticeCost);
+    // Cut on a line boundary so the outline stays parseable to the end.
+    const lastLineBreak = bounded.lastIndexOf("\n");
+    const wholeLines = lastLineBreak > 0 ? bounded.slice(0, lastLineBreak) : bounded;
+    return `${wholeLines}\n${TRUNCATION_NOTICE}`;
+}
+function _depthOf(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        return DEFAULT_MAX_DEPTH;
+    }
+    return Math.min(value, DEFAULT_MAX_DEPTH);
+}
+function _nonEmptyStringOf(value) {
+    return typeof value === "string" && value !== "" ? value : null;
+}
+function _stringListOf(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((member) => typeof member === "string" && member !== "");
+}
+//# sourceMappingURL=read-page.js.map

package/dist/reader/read-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-page.js","sourceRoot":"","sources":["../../src/reader/read-page.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,wEAAwE;AACxE,qEAAqE;AACrE,kEAAkE;AAClE,qEAAqE;AACrE,yEAAyE;AACzE,uEAAuE;AACvE,gEAAgE;AAEhE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,sEAAsE;AACtE,sEAAsE;AACtE,yEAAyE;AACzE,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAC3C,yEAAyE;AACzE,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3C,MAAM,iBAAiB,GAAG,mDAAmD,CAAC;AAC9E,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,cAAc,GAAG,KAAK,CAAC;AAW7B;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;CAAG;AAkBtD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAwB,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,MAAsC,EACtC,KAAkB;IAElB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/D,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE;QAC9B,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CAAC;IACH,OAAO;QACL,GAAG,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;QAC1D,KAAK,EAAE,aAAa,CAClB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAC1C,gBAAgB,CACjB;QACD,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,OAAO,EAAE,OAAO,CAAC,MAAM;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,cAAc,CACrB,MAAsC,EACtC,KAAkB;IAElB,sEAAsE;IACtE,uEAAuE;IACvE,OAAO;QACL,KAAK;QACL,eAAe,EAAE,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC;QACxD,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QACrC,WAAW,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI;QACzC,UAAU,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI;QACxC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC7C,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC;QACxC,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC;AASD,SAAS,iBAAiB,CAAC,OAAwB;IACjD,sEAAsE;IACtE,sEAAsE;IACtE,uEAAuE;IACvE,uEAAuE;IACvE,8DAA8D;IAC9D,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAoB,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7D,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,2BAA2B,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC7D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,MAAM,KAAK,mBAAmB,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrF,IAAI,cAAc,CAAC,SAAS,CAAC,IAAI,2BAA2B,EAAE,CAAC;YAC7D,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,EAAE;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IACD,sEAAsE;IACtE,sEAAsE;IACtE,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,sEAAsE;IACtE,MAAM,aAAa,GAAG,GAAG,MAAM,KAAK,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;IAClE,OAAO;QACL,IAAI,EAAE,kBAAkB,CAAC,aAAa,CAAC;QACvC,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,cAAc;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAwB;IACnD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAAgB,EAChB,KAAa,EACb,MAAkB;IAElB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,QAAQ,EAAE,KAAK,KAAK,KAAK,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IACD,mEAAmE;IACnE,uEAAuE;IACvE,qEAAqE;IACrE,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,OAAwB;IAC3C,wEAAwE;IACxE,yEAAyE;IACzE,qEAAqE;IACrE,8BAA8B;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;QAC3B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,iBAAiB,EAAE,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,2BAA2B,GAAG,UAAU,CAAC,CAAC;IAC9E,oEAAoE;IACpE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,UAAU,GACd,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,OAAO,GAAG,UAAU,KAAK,iBAAiB,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,CAC1E,CAAC;AACJ,CAAC"}

package/dist/reader/redaction.d.ts

@@ -0,0 +1,14 @@
+export declare const REDACTED_VALUE = "[redacted]";
+/**
+ * The value a textbox-like element shows, redacted where it must be:
+ * null when the element holds no readable value at all.
+ */
+export declare function textboxValueOf(element: Element): string | null;
+/**
+ * Whether a field's autocomplete declares a secret (card numbers,
+ * passwords, one-time codes). One predicate for both directions: the
+ * snapshot redacts what it reads, and prefill refuses what it would
+ * write — the two guards must never disagree about what a secret is.
+ */
+export declare function theFieldHoldsASecret(element: HTMLInputElement | HTMLTextAreaElement): boolean;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/reader/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/reader/redaction.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,eAAe,CAAC;AAU3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAqC9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,GAAG,mBAAmB,GAC9C,OAAO,CAeT"}

package/dist/reader/redaction.js

@@ -0,0 +1,71 @@
+// What a text control's current value contributes to the snapshot — and
+// the always-on redaction gate in front of it. Passwords and fields
+// whose autocomplete declares a secret (card numbers, one-time codes)
+// never enter a snapshot; there is deliberately no way to turn this off.
+import { isContentEditableElement } from "./roles.js";
+export const REDACTED_VALUE = "[redacted]";
+const SENSITIVE_AUTOCOMPLETE_VALUES = new Set([
+    "cc-number",
+    "cc-csc",
+    "current-password",
+    "new-password",
+    "one-time-code",
+]);
+/**
+ * The value a textbox-like element shows, redacted where it must be:
+ * null when the element holds no readable value at all.
+ */
+export function textboxValueOf(element) {
+    if (isContentEditableElement(element)) {
+        // Not every engine implements innerText (jsdom); fall back honestly.
+        const rendered = Reflect.get(element, "innerText");
+        if (typeof rendered === "string") {
+            return rendered;
+        }
+        return element.textContent;
+    }
+    if (!(element instanceof HTMLInputElement) &&
+        !(element instanceof HTMLTextAreaElement)) {
+        return null;
+    }
+    if (element instanceof HTMLInputElement) {
+        const type = element.type;
+        // hidden inputs hold machine state the user never sees — CSRF tokens,
+        // session blobs — so they never contribute a value, redacted or not
+        // (they surface at all only under show_hidden). checkbox/radio/file
+        // carry no readable text value either.
+        if (type === "checkbox" ||
+            type === "radio" ||
+            type === "file" ||
+            type === "hidden") {
+            return null;
+        }
+        if (type === "password") {
+            return element.value === "" ? "" : REDACTED_VALUE;
+        }
+    }
+    if (theFieldHoldsASecret(element) && element.value !== "") {
+        return REDACTED_VALUE;
+    }
+    return element.value;
+}
+/**
+ * Whether a field's autocomplete declares a secret (card numbers,
+ * passwords, one-time codes). One predicate for both directions: the
+ * snapshot redacts what it reads, and prefill refuses what it would
+ * write — the two guards must never disagree about what a secret is.
+ */
+export function theFieldHoldsASecret(element) {
+    const autocomplete = (element.getAttribute("autocomplete") ?? "")
+        .trim()
+        .toLowerCase();
+    if (autocomplete === "") {
+        return false;
+    }
+    // autocomplete is a token list ("billing cc-number"); any secret token
+    // marks the field, and every cc-exp variant counts.
+    return autocomplete
+        .split(/\s+/)
+        .some((token) => SENSITIVE_AUTOCOMPLETE_VALUES.has(token) || token.startsWith("cc-exp"));
+}
+//# sourceMappingURL=redaction.js.map

package/dist/reader/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/reader/redaction.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,oEAAoE;AACpE,sEAAsE;AACtE,yEAAyE;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC;IAC5C,WAAW;IACX,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,eAAe;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,qEAAqE;QACrE,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IACD,IACE,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC;QACtC,CAAC,CAAC,OAAO,YAAY,mBAAmB,CAAC,EACzC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,YAAY,gBAAgB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,sEAAsE;QACtE,oEAAoE;QACpE,oEAAoE;QACpE,uCAAuC;QACvC,IACE,IAAI,KAAK,UAAU;YACnB,IAAI,KAAK,OAAO;YAChB,IAAI,KAAK,MAAM;YACf,IAAI,KAAK,QAAQ,EACjB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;QACpD,CAAC;IACH,CAAC;IACD,IAAI,oBAAoB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA+C;IAE/C,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;SAC9D,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,uEAAuE;IACvE,oDAAoD;IACpD,OAAO,YAAY;SAChB,KAAK,CAAC,KAAK,CAAC;SACZ,IAAI,CACH,CAAC,KAAK,EAAE,EAAE,CACR,6BAA6B,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CACzE,CAAC;AACN,CAAC"}

package/dist/reader/render.d.ts

@@ -0,0 +1,4 @@
+import type { SnapshotNode } from "./snapshot.js";
+export declare function pageHeaderOf(title: string, url: string): string;
+export declare function renderedTreeOf(root: SnapshotNode): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/reader/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/reader/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAIzD"}

package/dist/reader/render.js

@@ -0,0 +1,124 @@
+// The snapshot's text form: an indented outline the model reads top to
+// bottom, one `- role "name" [ref=eN] [flags]` line per node, string
+// children as `- text: "…"` rows, and a two-line page header. Selects
+// render their options inline — the accessibility walk never descends
+// into them, but the choice list is exactly what a "what am I looking
+// at" answer needs.
+import { boundedTextOf } from "../transport/door-budget.js";
+const MAX_TITLE_LENGTH = 300;
+const MAX_URL_LENGTH = 2_000;
+const MAX_OPTION_TEXT_LENGTH = 100;
+export function pageHeaderOf(title, url) {
+    const boundedTitle = boundedTextOf(title.replace(/\s+/g, " ").trim(), MAX_TITLE_LENGTH);
+    const boundedUrl = boundedTextOf(url, MAX_URL_LENGTH);
+    return `# page: "${_escapedText(boundedTitle)}"\n# url: ${boundedUrl}`;
+}
+export function renderedTreeOf(root) {
+    const lines = [];
+    _renderChildren(root, 0, lines);
+    return lines.join("\n");
+}
+function _renderChildren(node, depth, lines) {
+    for (const child of node.children) {
+        if (typeof child === "string") {
+            const text = child.trim();
+            if (text !== "") {
+                lines.push(`${_indentOf(depth)}- text: "${_escapedText(text)}"`);
+            }
+        }
+        else {
+            _renderNode(child, depth, lines);
+        }
+    }
+}
+function _renderNode(node, depth, lines) {
+    const indent = _indentOf(depth);
+    const label = _nodeLineOf(node);
+    const isSelect = node.element instanceof HTMLSelectElement;
+    const textChildren = node.children.filter((child) => typeof child === "string");
+    const elementChildren = node.children.filter((child) => typeof child !== "string");
+    if (textChildren.length === 1 && elementChildren.length === 0 && !isSelect) {
+        const text = textChildren[0].trim();
+        if (text === "") {
+            lines.push(`${indent}- ${label}`);
+        }
+        else {
+            lines.push(`${indent}- ${label}: "${_escapedText(text)}"`);
+        }
+        return;
+    }
+    if (node.children.length === 0 && !isSelect) {
+        lines.push(`${indent}- ${label}`);
+        return;
+    }
+    lines.push(`${indent}- ${label}:`);
+    if (isSelect && node.element instanceof HTMLSelectElement) {
+        _renderSelectOptions(node.element, depth + 1, lines);
+        return;
+    }
+    _renderChildren(node, depth + 1, lines);
+}
+function _renderSelectOptions(select, depth, lines) {
+    const indent = _indentOf(depth);
+    for (const option of Array.from(select.options)) {
+        const text = option.text
+            .replace(/\s+/g, " ")
+            .trim()
+            .substring(0, MAX_OPTION_TEXT_LENGTH);
+        let line = `${indent}- option "${_escapedText(text)}"`;
+        if (option.selected) {
+            line += " (selected)";
+        }
+        if (option.value !== text) {
+            line += ` value="${_escapedText(option.value)}"`;
+        }
+        lines.push(line);
+    }
+}
+function _nodeLineOf(node) {
+    const parts = [node.role];
+    if (node.name !== "") {
+        parts.push(`"${_escapedText(node.name)}"`);
+    }
+    if (node.refId !== null) {
+        parts.push(`[ref=${node.refId}]`);
+    }
+    if (node.level !== null && node.level > 0) {
+        parts.push(`[level=${String(node.level)}]`);
+    }
+    if (node.hidden) {
+        parts.push("[hidden]");
+    }
+    if (node.offscreen) {
+        parts.push("[offscreen]");
+    }
+    if (node.scrollable) {
+        parts.push("[scrollable]");
+    }
+    if (node.checked) {
+        parts.push("[checked]");
+    }
+    if (node.disabled) {
+        parts.push("[disabled]");
+    }
+    if (node.focused) {
+        parts.push("[focused]");
+    }
+    if (node.selected) {
+        parts.push("[selected]");
+    }
+    if (node.placeholder !== null && node.placeholder !== "") {
+        parts.push(`[placeholder="${_escapedText(node.placeholder)}"]`);
+    }
+    if (node.hints.length > 0) {
+        parts.push(`[${node.hints.join(" ")}]`);
+    }
+    return parts.join(" ");
+}
+function _escapedText(text) {
+    return text.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+}
+function _indentOf(depth) {
+    return "  ".repeat(depth);
+}
+//# sourceMappingURL=render.js.map

package/dist/reader/render.js.map

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

package/dist/reader/roles.d.ts

@@ -0,0 +1,15 @@
+export declare const ARIA_SELECTED_ROLES: Set<string>;
+export declare const ARIA_CHECKED_ROLES: Set<string>;
+export declare const ARIA_DISABLED_ROLES: Set<string>;
+/** The element's effective role: explicit when valid, implicit otherwise. */
+export declare function roleOf(element: Element): string;
+/** The first valid token of role="…", or null when none names a role. */
+export declare function explicitRoleOf(element: Element): string | null;
+/** The heading/listitem/row/treeitem level, or null when the role has none. */
+export declare function ariaLevelOf(element: Element, role: string): number | null;
+/** aria-* boolean tri-state: true / false / absent. */
+export declare function ariaBooleanOf(attribute: string | null): boolean | undefined;
+/** Editable regions read as textboxes. The attribute fallback covers
+ * engines that don't reflect the contentEditable property (jsdom). */
+export declare function isContentEditableElement(element: Element): boolean;
+//# sourceMappingURL=roles.d.ts.map

package/dist/reader/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/reader/roles.ts"],"names":[],"mappings":"AAoIA,eAAO,MAAM,mBAAmB,aAQ9B,CAAC;AAEH,eAAO,MAAM,kBAAkB,aAM7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAqC9B,CAAC;AAWH,6EAA6E;AAC7E,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAS/C;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CAK3E;AAuBD;sEACsE;AACtE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAWlE"}