@chrischall/mcp-utils 2.11.0 → 2.13.0

package/dist/graphql/operation-kind.d.ts

@@ -0,0 +1,58 @@
+/**
+ * GraphQL operation-kind detection — "is this document a query, a mutation or
+ * a subscription?" — without a `graphql` dependency.
+ *
+ * Consolidates three independent answers to the same question
+ * (chrischall/fleet-audit#1080, #988, #1020), plus vibo's fourth:
+ *
+ *  - onehome-mcp `src/tools/graphql.ts` `topLevelOperationKinds` — regex-blanks
+ *    strings and comments, then reads the first word of each depth-0
+ *    definition. Gates the read-only `onehome_graphql` passthrough tool.
+ *  - hemnet-mcp `src/transport-fetchproxy.ts` `isReadOnlyOperation` — a char
+ *    lexer (BOM, commas, `\"""` escapes) that collects EVERY depth-0 name, so a
+ *    query merely NAMED `mutation` (or carrying an `@mutation` directive) is
+ *    misread as a write. Gates the bridge's retry-on-timeout.
+ *  - booli-mcp `src/transport-fetchproxy.ts` `isMutation` — `/\bmutation\b/`,
+ *    which refuses the timeout retry for any query with a field, alias,
+ *    argument or comment containing the word.
+ *  - vibo-mcp `src/client.ts` `isMutation` — `^\s*(#…)*mutation\b`, which
+ *    misses a mutation preceded by a fragment or a query, so a timed-out
+ *    write was reported as a safe-to-retry read.
+ *
+ * This one is a real tokenizer feeding a tiny top-level grammar: strings,
+ * block strings (with the spec's `\"""` escape) and comments are consumed as
+ * tokens, so their contents can never look like keywords; only the keyword
+ * that STARTS each top-level definition is read, so names, directives and
+ * variables never count. It is a single linear pass (no regex backtracking),
+ * which matters because it runs on caller-supplied documents.
+ */
+/**
+ * The keyword that starts each top-level definition of a GraphQL document, in
+ * order: `'query'`, `'mutation'`, `'subscription'` or `'fragment'` (an
+ * anonymous `{ … }` shorthand counts as `'query'`). Anything else at the top
+ * level is reported verbatim (`'extend'`, a stray word), so a caller deciding
+ * whether to refuse a document sees it rather than an empty list.
+ *
+ * Best effort on a malformed document — it keeps reading after the first
+ * error — so for a yes/no "is this safe" gate prefer
+ * {@link isReadOnlyGraphqlDocument}, which also refuses what it cannot parse.
+ */
+export declare function graphqlOperationKinds(document: string): string[];
+/**
+ * True when executing the document cannot write: it parses cleanly, contains
+ * at least one `query` (or `{ … }` shorthand), and every top-level definition
+ * is a `query` or a `fragment`. Any `mutation` or `subscription` — wherever it
+ * sits, after a fragment or a query included — makes it NOT read-only, and so
+ * does anything unrecognised: an empty or comment-only document, an
+ * unterminated string, unbalanced braces, an unknown keyword.
+ *
+ * The bias is deliberate. A wrong "no" costs a refused passthrough call or a
+ * skipped timeout retry; a wrong "yes" re-sends a write or lets a read-only
+ * tool change account state.
+ *
+ * The whole document is judged even when an `operationName` would select one
+ * operation from it: a document that carries a mutation at all is not handed
+ * to a read-only path.
+ */
+export declare function isReadOnlyGraphqlDocument(document: string): boolean;
+//# sourceMappingURL=operation-kind.d.ts.map

package/dist/graphql/operation-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-kind.d.ts","sourceRoot":"","sources":["../../src/graphql/operation-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgLH;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGnE"}

package/dist/graphql/operation-kind.js

@@ -0,0 +1,237 @@
+/**
+ * GraphQL operation-kind detection — "is this document a query, a mutation or
+ * a subscription?" — without a `graphql` dependency.
+ *
+ * Consolidates three independent answers to the same question
+ * (chrischall/fleet-audit#1080, #988, #1020), plus vibo's fourth:
+ *
+ *  - onehome-mcp `src/tools/graphql.ts` `topLevelOperationKinds` — regex-blanks
+ *    strings and comments, then reads the first word of each depth-0
+ *    definition. Gates the read-only `onehome_graphql` passthrough tool.
+ *  - hemnet-mcp `src/transport-fetchproxy.ts` `isReadOnlyOperation` — a char
+ *    lexer (BOM, commas, `\"""` escapes) that collects EVERY depth-0 name, so a
+ *    query merely NAMED `mutation` (or carrying an `@mutation` directive) is
+ *    misread as a write. Gates the bridge's retry-on-timeout.
+ *  - booli-mcp `src/transport-fetchproxy.ts` `isMutation` — `/\bmutation\b/`,
+ *    which refuses the timeout retry for any query with a field, alias,
+ *    argument or comment containing the word.
+ *  - vibo-mcp `src/client.ts` `isMutation` — `^\s*(#…)*mutation\b`, which
+ *    misses a mutation preceded by a fragment or a query, so a timed-out
+ *    write was reported as a safe-to-retry read.
+ *
+ * This one is a real tokenizer feeding a tiny top-level grammar: strings,
+ * block strings (with the spec's `\"""` escape) and comments are consumed as
+ * tokens, so their contents can never look like keywords; only the keyword
+ * that STARTS each top-level definition is read, so names, directives and
+ * variables never count. It is a single linear pass (no regex backtracking),
+ * which matters because it runs on caller-supplied documents.
+ */
+const NAME_START = /[_A-Za-z]/;
+const NAME_CONTINUE = /[_0-9A-Za-z]/;
+/** Tokenize per the GraphQL lexical grammar, keeping only what the top level needs. */
+function lex(src) {
+    const tokens = [];
+    const n = src.length;
+    let i = 0;
+    while (i < n) {
+        const c = src[i];
+        // Ignored tokens: BOM, whitespace, line terminators, commas.
+        if (c === '' || c === ' ' || c === '\t' || c === '\n' || c === '\r' || c === ',') {
+            i++;
+            continue;
+        }
+        if (c === '#') {
+            while (i < n && src[i] !== '\n' && src[i] !== '\r')
+                i++;
+            continue;
+        }
+        if (c === '"') {
+            if (src.startsWith('"""', i)) {
+                // Block string: ends at the first `"""` that is not the `\"""` escape.
+                i += 3;
+                for (;;) {
+                    if (i >= n)
+                        return { tokens, unterminated: true };
+                    if (src[i] === '\\' && src.startsWith('"""', i + 1)) {
+                        i += 4;
+                    }
+                    else if (src.startsWith('"""', i)) {
+                        i += 3;
+                        break;
+                    }
+                    else {
+                        i++;
+                    }
+                }
+            }
+            else {
+                i++;
+                for (;;) {
+                    if (i >= n || src[i] === '\n' || src[i] === '\r')
+                        return { tokens, unterminated: true };
+                    if (src[i] === '\\') {
+                        i += 2;
+                    }
+                    else if (src[i] === '"') {
+                        i++;
+                        break;
+                    }
+                    else {
+                        i++;
+                    }
+                }
+            }
+            tokens.push({ kind: 'string' });
+            continue;
+        }
+        if (NAME_START.test(c)) {
+            const start = i;
+            i++;
+            while (i < n && NAME_CONTINUE.test(src[i]))
+                i++;
+            tokens.push({ kind: 'name', value: src.slice(start, i) });
+            continue;
+        }
+        tokens.push({ kind: 'punct', value: c });
+        i++;
+    }
+    return { tokens, unterminated: false };
+}
+const OPEN = new Set(['{', '(', '[']);
+const CLOSE = new Set(['}', ')', ']']);
+const OPERATION_KEYWORDS = new Set(['query', 'mutation', 'subscription']);
+/** Read the top-level definitions of a document. */
+function summarize(document) {
+    const { tokens, unterminated } = lex(document);
+    const kinds = [];
+    let wellFormed = !unterminated;
+    let i = 0;
+    const peek = () => tokens[i];
+    const isPunct = (t, value) => t?.kind === 'punct' && t.value === value;
+    /**
+     * Skip one balanced group starting at an opening bracket. Returns false when
+     * the document ends inside it.
+     */
+    const skipGroup = () => {
+        let depth = 0;
+        while (i < tokens.length) {
+            const t = tokens[i++];
+            if (t.kind !== 'punct')
+                continue;
+            if (OPEN.has(t.value))
+                depth++;
+            else if (CLOSE.has(t.value)) {
+                depth--;
+                if (depth === 0)
+                    return true;
+            }
+        }
+        return false;
+    };
+    /** `@name` or `@name(args)`, repeated. */
+    const skipDirectives = () => {
+        while (isPunct(peek(), '@')) {
+            i++;
+            if (peek()?.kind !== 'name')
+                return false;
+            i++;
+            if (isPunct(peek(), '(') && !skipGroup())
+                return false;
+        }
+        return true;
+    };
+    /** The selection set that ends every executable definition. */
+    const selectionSet = () => isPunct(peek(), '{') && skipGroup();
+    while (i < tokens.length) {
+        const t = tokens[i];
+        if (isPunct(t, '{')) {
+            // Anonymous query shorthand.
+            kinds.push('query');
+            if (!skipGroup())
+                wellFormed = false;
+            continue;
+        }
+        if (t.kind !== 'name') {
+            // A string, stray punctuation, or a closing bracket with nothing open.
+            wellFormed = false;
+            i++;
+            continue;
+        }
+        i++;
+        kinds.push(t.value);
+        let ok;
+        if (OPERATION_KEYWORDS.has(t.value)) {
+            // query/mutation/subscription Name? VariableDefinitions? Directives? SelectionSet
+            if (peek()?.kind === 'name')
+                i++;
+            ok = true;
+            if (isPunct(peek(), '('))
+                ok = skipGroup();
+            ok = ok && skipDirectives() && selectionSet();
+        }
+        else if (t.value === 'fragment') {
+            // fragment Name on Type Directives? SelectionSet
+            ok = peek()?.kind === 'name';
+            if (ok)
+                i++;
+            const on = peek();
+            ok = ok && on?.kind === 'name' && on.value === 'on';
+            if (ok)
+                i++;
+            ok = ok && peek()?.kind === 'name';
+            if (ok)
+                i++;
+            ok = ok && skipDirectives() && selectionSet();
+        }
+        else {
+            // Not an executable definition (`extend`, `type`, a typo). Skip to the
+            // end of its body so its inner names are not read as definitions.
+            ok = false;
+            while (i < tokens.length && !isPunct(peek(), '{'))
+                i++;
+            if (i < tokens.length)
+                skipGroup();
+        }
+        // On a malformed definition the unexpected token is left in place and
+        // re-read as the start of the next definition, so a broken head such as
+        // `query Q mutation M { … }` cannot hide the mutation behind it.
+        if (!ok)
+            wellFormed = false;
+    }
+    return { kinds, wellFormed };
+}
+/**
+ * The keyword that starts each top-level definition of a GraphQL document, in
+ * order: `'query'`, `'mutation'`, `'subscription'` or `'fragment'` (an
+ * anonymous `{ … }` shorthand counts as `'query'`). Anything else at the top
+ * level is reported verbatim (`'extend'`, a stray word), so a caller deciding
+ * whether to refuse a document sees it rather than an empty list.
+ *
+ * Best effort on a malformed document — it keeps reading after the first
+ * error — so for a yes/no "is this safe" gate prefer
+ * {@link isReadOnlyGraphqlDocument}, which also refuses what it cannot parse.
+ */
+export function graphqlOperationKinds(document) {
+    return summarize(document).kinds;
+}
+/**
+ * True when executing the document cannot write: it parses cleanly, contains
+ * at least one `query` (or `{ … }` shorthand), and every top-level definition
+ * is a `query` or a `fragment`. Any `mutation` or `subscription` — wherever it
+ * sits, after a fragment or a query included — makes it NOT read-only, and so
+ * does anything unrecognised: an empty or comment-only document, an
+ * unterminated string, unbalanced braces, an unknown keyword.
+ *
+ * The bias is deliberate. A wrong "no" costs a refused passthrough call or a
+ * skipped timeout retry; a wrong "yes" re-sends a write or lets a read-only
+ * tool change account state.
+ *
+ * The whole document is judged even when an `operationName` would select one
+ * operation from it: a document that carries a mutation at all is not handed
+ * to a read-only path.
+ */
+export function isReadOnlyGraphqlDocument(document) {
+    const { kinds, wellFormed } = summarize(document);
+    return wellFormed && kinds.includes('query') && kinds.every((k) => k === 'query' || k === 'fragment');
+}
+//# sourceMappingURL=operation-kind.js.map

package/dist/graphql/operation-kind.js.map

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

package/dist/html/index.d.ts

@@ -15,6 +15,9 @@
  *     escaped strings.
  *   - `extractPlainTextFromHtml` — dependency-free script/style strip + entity
  *     decode used to render Infinite Campus message bodies as plain text.
+ *   - `htmlToReadableText` — the block-aware DOM text extractor (onthecheap):
+ *     block boundaries become word breaks, inline markup stays joined, code
+ *     elements are dropped, every entity is decoded.
  *   - `urlToPath` / `locationToSlug` / `buildIdExtractor` — the small URL atoms
  *     that were byte-identical across the cohort.
  */
@@ -98,6 +101,36 @@ export declare function extractJsonFromHtml(html: string, marker?: string): Reco
  * @returns The decoded, whitespace-collapsed plain text (`''` for empty input).
  */
 export declare function extractPlainTextFromHtml(html: string): string;
+/** Options for {@link htmlToReadableText}. */
+export interface ReadableTextOptions {
+    /**
+     * Cap the result at this many characters (plus a trailing `…`). The cut
+     * lands on the last word boundary when that keeps at least 60% of the
+     * budget, otherwise mid-word. Omit for no cap.
+     */
+    limit?: number;
+}
+/**
+ * Render HTML as readable plain text, the way a browser would lay the words
+ * out: markup stripped, every HTML entity decoded, whitespace collapsed.
+ *
+ * Unlike {@link extractPlainTextFromHtml} (the dependency-free regex version,
+ * kept unchanged for its callers) this walks the DOM, so:
+ *   - **block** boundaries (`<p>`, `<div>`, `<li>`, `<td>`, `<br>`, headings, …)
+ *     become word breaks — `<p>One</p><p>Two</p>` → `One Two`, not `OneTwo`;
+ *   - **inline** markup stays joined — `<b>F</b>ree` → `Free`, not `F ree`;
+ *   - `<script>`/`<style>` (incl. JSON-LD), `<noscript>`, `<template>`,
+ *     `<iframe>` and `<svg>` content is dropped, and comments are ignored;
+ *   - the full named-entity table is decoded (`&eacute;`, `&ndash;`, …).
+ *
+ * Use it for article / post / message bodies. Iterative, so hostile nesting
+ * depth cannot overflow the stack. Hoisted from onthecheap-mcp's `htmlToText`
+ * (fleet audit #1083).
+ *
+ * @param html The HTML (fragment or full document). `null`/`undefined` → `''`.
+ * @returns The readable text (`''` for empty input).
+ */
+export declare function htmlToReadableText(html: string | null | undefined, opts?: ReadableTextOptions): string;
 /**
  * Reduce a portal URL (or path) to its `pathname + search` portion.
  *

package/dist/html/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG3D,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AA4CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,IAAI,CAetB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAM,GACb,WAAW,EAAE,CAgBf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,SAAsB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkDhC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAmDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GACZ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,KAAK,MAAM,GAAG,SAAS,CAU1D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/html/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAmB,KAAK,WAAW,EAA4B,MAAM,kBAAkB,CAAC;AAI/F,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AA4CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,IAAI,CAetB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,SAAM,GACb,WAAW,EAAE,CAgBf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,SAAsB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkDhC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB7D;AAwDD,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAmC1G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GACZ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,KAAK,MAAM,GAAG,SAAS,CAU1D"}

package/dist/html/index.js

@@ -15,11 +15,15 @@
  *     escaped strings.
  *   - `extractPlainTextFromHtml` — dependency-free script/style strip + entity
  *     decode used to render Infinite Campus message bodies as plain text.
+ *   - `htmlToReadableText` — the block-aware DOM text extractor (onthecheap):
+ *     block boundaries become word breaks, inline markup stays joined, code
+ *     elements are dropped, every entity is decoded.
  *   - `urlToPath` / `locationToSlug` / `buildIdExtractor` — the small URL atoms
  *     that were byte-identical across the cohort.
  */
-import { parse } from 'node-html-parser';
+import { parse, NodeType } from 'node-html-parser';
 import { asciiLower } from '../internal/ascii.js';
+import { codePointOr } from '../internal/code-point.js';
 /** Normalise an element's text: collapse internal whitespace runs and trim. */
 function cellText(el) {
     return el.text.replace(/\s+/g, ' ').trim();
@@ -289,21 +293,82 @@ function stripElementContent(html, tag) {
         i = closeAt + close.length;
     }
 }
+// ---------------------------------------------------------------------------
+// htmlToReadableText
+// ---------------------------------------------------------------------------
+/** Elements whose content is code or data, never readable text. */
+const NON_TEXT_TAGS = new Set(['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEMPLATE', 'IFRAME', 'SVG']);
 /**
- * `String.fromCodePoint` guarded against a `RangeError` on an out-of-range
- * (negative or > 0x10FFFF) code point from a scraped numeric entity — returns
- * the raw entity text unchanged instead of throwing. (Lone surrogates do NOT
- * throw and pass the guard, yielding a lone-surrogate string; harmless here.)
+ * Elements that start a new line when rendered. Their boundaries become a word
+ * break; inline elements (`<b>`, `<a>`, …) do not, so `<b>F</b>ree` stays one
+ * word.
  */
-function codePointOr(code, raw) {
-    if (!Number.isInteger(code) || code < 0 || code > 0x10ffff)
-        return raw;
-    try {
-        return String.fromCodePoint(code);
-    }
-    catch {
-        return raw;
+const BREAK_TAGS = new Set([
+    'ADDRESS', 'ARTICLE', 'ASIDE', 'BLOCKQUOTE', 'BR', 'DD', 'DIV', 'DL', 'DT',
+    'FIGCAPTION', 'FIGURE', 'FOOTER', 'H1', 'H2', 'H3', 'H4', 'H5', 'H6', 'HEADER',
+    'HR', 'LI', 'MAIN', 'NAV', 'OL', 'P', 'PRE', 'SECTION', 'TABLE', 'TD', 'TH',
+    'TR', 'UL',
+]);
+/**
+ * Render HTML as readable plain text, the way a browser would lay the words
+ * out: markup stripped, every HTML entity decoded, whitespace collapsed.
+ *
+ * Unlike {@link extractPlainTextFromHtml} (the dependency-free regex version,
+ * kept unchanged for its callers) this walks the DOM, so:
+ *   - **block** boundaries (`<p>`, `<div>`, `<li>`, `<td>`, `<br>`, headings, …)
+ *     become word breaks — `<p>One</p><p>Two</p>` → `One Two`, not `OneTwo`;
+ *   - **inline** markup stays joined — `<b>F</b>ree` → `Free`, not `F ree`;
+ *   - `<script>`/`<style>` (incl. JSON-LD), `<noscript>`, `<template>`,
+ *     `<iframe>` and `<svg>` content is dropped, and comments are ignored;
+ *   - the full named-entity table is decoded (`&eacute;`, `&ndash;`, …).
+ *
+ * Use it for article / post / message bodies. Iterative, so hostile nesting
+ * depth cannot overflow the stack. Hoisted from onthecheap-mcp's `htmlToText`
+ * (fleet audit #1083).
+ *
+ * @param html The HTML (fragment or full document). `null`/`undefined` → `''`.
+ * @returns The readable text (`''` for empty input).
+ */
+export function htmlToReadableText(html, opts = {}) {
+    if (!html)
+        return '';
+    const parts = [];
+    // Explicit stack instead of recursion; a `string` entry is a pending break
+    // to emit after an element's children.
+    // node-html-parser surfaces a leading `<!doctype …>` as a TEXT node, so it
+    // would read as words; drop it before parsing (anchored, so linear).
+    const stack = [parse(html.replace(/^\s*<!doctype[^>]*>/i, ''))];
+    while (stack.length > 0) {
+        const item = stack.pop();
+        if (typeof item === 'string') {
+            parts.push(item);
+            continue;
+        }
+        if (item.nodeType === NodeType.TEXT_NODE) {
+            parts.push(item.text); // `.text` is entity-decoded
+            continue;
+        }
+        if (item.nodeType !== NodeType.ELEMENT_NODE)
+            continue; // comments
+        const tag = item.tagName ?? '';
+        if (NON_TEXT_TAGS.has(tag))
+            continue;
+        const breaks = BREAK_TAGS.has(tag);
+        if (breaks) {
+            parts.push(' ');
+            stack.push(' ');
+        }
+        const children = item.childNodes;
+        for (let i = children.length - 1; i >= 0; i--)
+            stack.push(children[i]);
     }
+    const text = parts.join('').replace(/\s+/g, ' ').trim();
+    const { limit } = opts;
+    if (limit === undefined || text.length <= limit)
+        return text;
+    const cut = text.slice(0, limit);
+    const boundary = cut.lastIndexOf(' ');
+    return `${(boundary > limit * 0.6 ? cut.slice(0, boundary) : cut).trimEnd()}…`;
 }
 /**
  * Reduce a portal URL (or path) to its `pathname + search` portion.

package/dist/html/index.js.map

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

package/dist/http/index.d.ts

@@ -112,9 +112,13 @@ export interface ApiClientOptions {
     onUnauthorized?: () => Error;
     /**
      * Override the error thrown when a 429 persists past the retry budget.
-     * Defaults to {@link RateLimitedError}.
+     * Defaults to {@link RateLimitedError}. Receives a {@link RateLimitContext}
+     * describing that final 429 — its parsed `Retry-After` and whether a CDN/WAF
+     * page answered it — read before the body is discarded, so a consumer no
+     * longer has to capture the response at the `fetchImpl` seam (musicbrainz,
+     * viator). A zero-argument hook still works.
      */
-    onRateLimited?: () => Error;
+    onRateLimited?: (ctx: RateLimitContext) => Error;
     /** Injectable fetch (for tests). Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
     /** Injectable sleep (for tests). Defaults to `setTimeout`. */
@@ -129,6 +133,36 @@ export interface ApiClientOptions {
      */
     timeout?: number;
 }
+/**
+ * What {@link ApiClientOptions.onRateLimited} is told about the 429 that
+ * exhausted the retry budget (the LAST response, not the first).
+ */
+export interface RateLimitContext {
+    /** The response status (429). */
+    status: number;
+    /** The raw `Retry-After` header, or `null` when absent. */
+    retryAfter: string | null;
+    /**
+     * The wait `Retry-After` asks for, in ms: delta-seconds or an HTTP-date
+     * (clamped at 0 once past). Uncapped — `maxRetryAfterMs` bounds the client's
+     * own sleep, not this report. `undefined` when absent or unparseable.
+     */
+    retryAfterMs: number | undefined;
+    /**
+     * The CDN/WAF that answered, per {@link detectEdgeBlock}, or `null`. A 429
+     * can be an edge refusal page rather than the API's rate limit; return an
+     * {@link EdgeBlockedError} for it to say so. A JSON body is the API's own
+     * answer and is not read (`cf-mitigated` is still honoured); any other body
+     * is read under the request timeout, and an unreadable one is no evidence.
+     */
+    edgeBlock: {
+        vendor: string;
+    } | null;
+    /** The request method, as passed. */
+    method: string;
+    /** The request path, as passed. */
+    path: string;
+}
 /** A request body and/or extra headers for a single call. */
 export interface RequestOptions {
     /** JSON-serialized into the request body when present. */
@@ -139,6 +173,27 @@ export interface RequestOptions {
      * precedence over {@link body} when both are present.
      */
     formData?: FormData;
+    /**
+     * Form-encoded body, sent as `application/x-www-form-urlencoded;charset=UTF-8`
+     * (the same type `fetch` gives a bare `URLSearchParams`). A plain record is
+     * encoded with `URLSearchParams`, skipping `undefined` values. Consolidates
+     * resy's local `URLSearchParams` branch (its login, favourite, notify and
+     * booking writes are all form posts).
+     */
+    form?: URLSearchParams | Record<string, string | number | boolean | undefined>;
+    /**
+     * A string body sent verbatim — for upstreams whose writes are neither JSON
+     * nor a form, e.g. MusicBrainz's `application/xml` submissions. Its
+     * `Content-Type` is {@link contentType}, defaulting to
+     * `text/plain; charset=utf-8`. An empty string is still a body.
+     */
+    rawBody?: string;
+    /**
+     * The `Content-Type` of {@link rawBody}. Only valid alongside `rawBody` —
+     * the other body kinds set their own (a per-request `headers` entry still
+     * overrides any of them).
+     */
+    contentType?: string;
     /** Extra request headers, merged over the defaults. */
     headers?: Record<string, string>;
     /** Query params appended via {@link buildQueryString} when present. */
@@ -180,10 +235,15 @@ export declare class UnauthorizedError extends Error {
     readonly status = 401;
     constructor(service: string);
 }
-/** Thrown when a 429 persists after the retry budget is exhausted. */
+/**
+ * Thrown when a 429 persists after the retry budget is exhausted.
+ * `retryAfterMs` is the final response's `Retry-After` as a wait in ms (see
+ * {@link RateLimitContext.retryAfterMs}), when it sent a parseable one.
+ */
 export declare class RateLimitedError extends Error {
     readonly status = 429;
-    constructor(service: string);
+    readonly retryAfterMs: number | undefined;
+    constructor(service: string, retryAfterMs?: number);
 }
 /** Thrown when a request exceeds {@link ApiClientOptions.timeout}. */
 export declare class RequestTimeoutError extends Error {
@@ -497,6 +557,14 @@ export interface RunBoundedBatchOptions<T, R> {
     setTimer?: (ms: number, cb: () => void) => unknown;
     /** Injectable clear paired with {@link setTimer}. Defaults to `clearTimeout`. */
     clearTimer?: (handle: unknown) => void;
+    /**
+     * The caller's cancellation. Defaults to the running tool call's
+     * ({@link currentCallSignal}). When it aborts the batch answers AT ONCE, as if
+     * the deadline had fired: unsettled slots are backfilled by {@link onTimeout},
+     * workers' signals abort, and nothing more is dispatched — a client that
+     * cancelled is no longer fetched for.
+     */
+    signal?: AbortSignal;
 }
 /**
  * Run `worker` over `items` with an overall hard deadline and a per-item
@@ -510,7 +578,9 @@ export interface RunBoundedBatchOptions<T, R> {
  * awaited, so a single hung row can't keep the whole call (and the MCP request
  * deadline behind it) pinned open. Queued items not yet started are never
  * dispatched after the deadline; a worker that retries or loops internally
- * should still check `signal.aborted` itself to stop mid-item. When everything settles before the deadline,
+ * should still check `signal.aborted` itself to stop mid-item. The caller's
+ * cancellation ({@link RunBoundedBatchOptions.signal}, the running tool call's
+ * by default) ends the batch the same way, immediately. When everything settles before the deadline,
  * the timer is cleared and every slot holds its real result.
  *
  * Generalises zillow's bulk-tool `runWithDeadline` (`zillow_bulk_get` /