@murphai/murph 0.2.6 → 0.2.10

package/node_modules/@murphai/assistant-engine/dist/assistant/web-fetch.js

@@ -1,54 +1,13 @@
-import { lookup } from 'node:dns/promises';
-import { request as requestHttp } from 'node:http';
-import { request as requestHttps } from 'node:https';
-import { BlockList, isIP } from 'node:net';
-import { Readable } from 'node:stream';
-import { urlToHttpOptions } from 'node:url';
-import { createBrotliDecompress, createUnzip } from 'node:zlib';
-import { Readability } from '@mozilla/readability';
-import { DOMParser } from 'linkedom';
 import { createTimeoutAbortController } from '@murphai/operator-config/http-retry';
 import { VaultCliError } from '@murphai/operator-config/vault-cli-errors';
-import { errorMessage, normalizeNullableString, } from './shared.js';
-export const assistantWebFetchExtractModeValues = [
-    'markdown',
-    'text',
-];
-export const assistantWebFetchEnvKeys = [
-    'MURPH_WEB_FETCH_ENABLED',
-    'MURPH_WEB_FETCH_MAX_CHARS',
-    'MURPH_WEB_FETCH_MAX_RESPONSE_BYTES',
-    'MURPH_WEB_FETCH_TIMEOUT_MS',
-    'MURPH_WEB_FETCH_MAX_REDIRECTS',
-];
-const ASSISTANT_WEB_FETCH_DEFAULT_MAX_CHARS = 12_000;
-const ASSISTANT_WEB_FETCH_MAX_CHARS = 40_000;
-const ASSISTANT_WEB_FETCH_DEFAULT_MAX_RESPONSE_BYTES = 1_000_000;
-const ASSISTANT_WEB_FETCH_MAX_RESPONSE_BYTES = 5_000_000;
-const ASSISTANT_WEB_FETCH_DEFAULT_TIMEOUT_MS = 15_000;
-const ASSISTANT_WEB_FETCH_MIN_TIMEOUT_MS = 1_000;
-const ASSISTANT_WEB_FETCH_MAX_TIMEOUT_MS = 60_000;
-const ASSISTANT_WEB_FETCH_DEFAULT_MAX_REDIRECTS = 5;
-const ASSISTANT_WEB_FETCH_MAX_REDIRECTS = 10;
-const ASSISTANT_WEB_FETCH_BLOCKED_HOSTNAMES = [
-    'home.arpa',
-    'localhost',
-    'localhost.localdomain',
-];
-const ASSISTANT_WEB_FETCH_DEFAULT_ACCEPT_HEADER = 'text/html, application/xhtml+xml, application/json, text/plain;q=0.9, */*;q=0.1';
-const ASSISTANT_WEB_FETCH_TEXT_NODE = 3;
-const ASSISTANT_WEB_FETCH_ELEMENT_NODE = 1;
-const assistantWebFetchBlockedAddressList = createAssistantWebFetchBlockedAddressList();
-export function resolveAssistantWebFetchEnabled(env = process.env) {
-    if (typeof globalThis.Headers !== 'function' || typeof globalThis.Response !== 'function') {
-        return false;
-    }
-    const raw = normalizeNullableString(env.MURPH_WEB_FETCH_ENABLED);
-    if (!raw) {
-        return false;
-    }
-    return ['1', 'true', 'yes', 'on', 'enabled'].includes(raw.toLowerCase());
-}
+import { normalizeNullableString } from './shared.js';
+import { createAssistantWebFetchRuntimeContext, normalizeAssistantWebRequestUrl, resolveAssistantWebFetchMaxChars, } from './web-fetch/config.js';
+import { fetchAssistantWebResponse, redactAssistantWebFetchUrl, } from './web-fetch/network.js';
+import { extractAssistantWebResponse, resolveAssistantWebMediaType, } from './web-fetch/content.js';
+export { assistantWebFetchEnvKeys, assistantWebFetchExtractModeValues, createAssistantWebFetchRuntimeContext, normalizeAssistantWebHostname, normalizeAssistantWebRequestUrl, resolveAssistantWebFetchEnabled, resolveAssistantWebFetchMaxChars, } from './web-fetch/config.js';
+export { fetchAssistantWebResponse, redactAssistantWebFetchUrl, } from './web-fetch/network.js';
+export { readAssistantWebResponseBytes, readAssistantWebResponseText, } from './web-fetch/response.js';
+export { resolveAssistantWebMediaType, truncateAssistantWebText, } from './web-fetch/content.js';
 export async function fetchAssistantWeb(request, env = process.env) {
     const normalizedRequest = normalizeAssistantWebFetchRequest(request, env);
     const runtime = createAssistantWebFetchRuntimeContext(env);
@@ -64,6 +23,7 @@ export async function fetchAssistantWeb(request, env = process.env) {
         const extracted = await extractAssistantWebResponse({
             contentType,
             extractMode: normalizedRequest.extractMode,
+            finalUrl: fetched.finalUrl,
             maxChars: normalizedRequest.maxChars,
             maxResponseBytes: runtime.maxResponseBytes,
             response: fetched.response,
@@ -105,21 +65,16 @@ function normalizeAssistantWebFetchRequest(request, env) {
     }
     let parsedUrl;
     try {
-        parsedUrl = new URL(url);
+        parsedUrl = normalizeAssistantWebRequestUrl(url);
     }
     catch {
         throw new VaultCliError('WEB_FETCH_URL_INVALID', 'web.fetch requires a valid absolute URL.');
     }
-    parsedUrl.hash = '';
-    const normalizedHostname = normalizeAssistantWebHostname(parsedUrl.hostname);
-    if (normalizedHostname) {
-        parsedUrl.hostname = normalizedHostname;
-    }
     const extractMode = isAssistantWebFetchExtractMode(request.extractMode)
         ? request.extractMode
         : 'markdown';
     const configuredMaxChars = resolveAssistantWebFetchMaxChars(env);
-    const maxChars = Math.max(1, Math.min(Math.trunc(request.maxChars ?? configuredMaxChars), configuredMaxChars, ASSISTANT_WEB_FETCH_MAX_CHARS));
+    const maxChars = Math.max(1, Math.min(Math.trunc(request.maxChars ?? configuredMaxChars), configuredMaxChars));
     return {
         url: parsedUrl,
         extractMode,
@@ -127,810 +82,7 @@ function normalizeAssistantWebFetchRequest(request, env) {
         signal: request.signal,
     };
 }
-export function createAssistantWebFetchRuntimeContext(env) {
-    if (!resolveAssistantWebFetchEnabled(env)) {
-        throw new VaultCliError('WEB_FETCH_DISABLED', 'web.fetch is disabled in this runtime.');
-    }
-    return {
-        lookupImplementation: lookup,
-        timeoutMs: resolveAssistantWebFetchTimeoutMs(env),
-        maxResponseBytes: resolveAssistantWebFetchMaxResponseBytes(env),
-        maxRedirects: resolveAssistantWebFetchMaxRedirects(env),
-    };
-}
-export async function fetchAssistantWebResponse(input) {
-    let currentUrl = input.url;
-    const warnings = [];
-    for (let redirectCount = 0;; redirectCount += 1) {
-        const resolvedTarget = await resolveAssistantWebPublicTarget(currentUrl, input.runtime.lookupImplementation, input.toolName);
-        let response;
-        try {
-            response = await requestAssistantWebResponseAtPublicTarget({
-                acceptHeader: input.acceptHeader ?? ASSISTANT_WEB_FETCH_DEFAULT_ACCEPT_HEADER,
-                resolvedTarget,
-                signal: input.signal,
-                url: currentUrl,
-            });
-        }
-        catch (error) {
-            throw new VaultCliError('WEB_FETCH_REQUEST_FAILED', `${input.toolName} could not reach ${redactAssistantWebFetchUrl(currentUrl)}: ${errorMessage(error)}`);
-        }
-        if (!isAssistantWebRedirectStatus(response.status)) {
-            return {
-                finalUrl: currentUrl,
-                response,
-                warnings,
-            };
-        }
-        const location = normalizeNullableString(response.headers.get('location'));
-        if (!location) {
-            await cancelAssistantWebResponseBody(response);
-            throw new VaultCliError('WEB_FETCH_REDIRECT_INVALID', `${input.toolName} received HTTP ${response.status} without a redirect location.`);
-        }
-        if (redirectCount >= input.runtime.maxRedirects) {
-            await cancelAssistantWebResponseBody(response);
-            throw new VaultCliError('WEB_FETCH_REDIRECT_LIMIT', `${input.toolName} followed too many redirects (>${input.runtime.maxRedirects}).`);
-        }
-        const nextUrl = new URL(location, currentUrl);
-        nextUrl.hash = '';
-        warnings.push(`Followed redirect ${redirectCount + 1} to ${redactAssistantWebFetchUrl(nextUrl)}.`);
-        await cancelAssistantWebResponseBody(response);
-        currentUrl = nextUrl;
-    }
-}
-async function resolveAssistantWebPublicTarget(candidateUrl, lookupImplementation, toolName) {
-    const protocol = candidateUrl.protocol.toLowerCase();
-    if (protocol !== 'http:' && protocol !== 'https:') {
-        throw new VaultCliError('WEB_FETCH_URL_UNSUPPORTED_SCHEME', `${toolName} only supports http:// and https:// URLs.`);
-    }
-    if (candidateUrl.username || candidateUrl.password) {
-        throw new VaultCliError('WEB_FETCH_URL_CREDENTIALS_FORBIDDEN', `${toolName} does not allow credentials in URLs.`);
-    }
-    const hostname = normalizeAssistantWebHostname(candidateUrl.hostname);
-    if (!hostname) {
-        throw new VaultCliError('WEB_FETCH_HOST_INVALID', `${toolName} requires a URL with a hostname.`);
-    }
-    if (isAssistantWebBlockedHostname(hostname)) {
-        throw new VaultCliError('WEB_FETCH_PRIVATE_HOST_BLOCKED', `${toolName} blocked ${hostname} because private or loopback hosts are not allowed.`);
-    }
-    const hostAddressFamily = isIP(hostname);
-    if (hostAddressFamily !== 0) {
-        if (isAssistantWebBlockedIpAddress(hostname, hostAddressFamily)) {
-            throw new VaultCliError('WEB_FETCH_PRIVATE_HOST_BLOCKED', `${toolName} blocked ${hostname} because private or loopback hosts are not allowed.`);
-        }
-        return {
-            hostname,
-            addresses: [
-                {
-                    address: hostname,
-                    family: hostAddressFamily,
-                },
-            ],
-        };
-    }
-    let resolvedAddresses;
-    try {
-        resolvedAddresses = await lookupAllAssistantWebAddresses(lookupImplementation, hostname);
-    }
-    catch (error) {
-        throw new VaultCliError('WEB_FETCH_DNS_LOOKUP_FAILED', `${toolName} could not resolve ${hostname}: ${errorMessage(error)}`);
-    }
-    if (resolvedAddresses.length === 0) {
-        throw new VaultCliError('WEB_FETCH_DNS_LOOKUP_FAILED', `${toolName} could not resolve ${hostname} to any IP address.`);
-    }
-    for (const address of resolvedAddresses) {
-        if (isAssistantWebBlockedIpAddress(address.address, address.family)) {
-            throw new VaultCliError('WEB_FETCH_PRIVATE_HOST_BLOCKED', `${toolName} blocked ${hostname} because it resolved to a private or loopback address.`);
-        }
-    }
-    return {
-        hostname,
-        addresses: resolvedAddresses,
-    };
-}
-async function extractAssistantWebResponse(input) {
-    if (input.contentType === 'application/pdf') {
-        await cancelAssistantWebResponseBody(input.response);
-        throw new VaultCliError('WEB_FETCH_PDF_UNSUPPORTED', 'web.fetch does not parse PDFs. Use web.pdf.read for PDF content.');
-    }
-    if (isAssistantWebLikelyBinaryContentType(input.contentType)) {
-        await cancelAssistantWebResponseBody(input.response);
-        throw new VaultCliError('WEB_FETCH_CONTENT_TYPE_UNSUPPORTED', `web.fetch cannot extract readable text from ${input.contentType}.`);
-    }
-    const responseText = await readAssistantWebResponseText({
-        response: input.response,
-        maxResponseBytes: input.maxResponseBytes,
-    });
-    const warnings = [...responseText.warnings];
-    let title = null;
-    let text = responseText.text;
-    let extractor = 'raw-text';
-    if (isAssistantWebHtmlContentType(input.contentType)) {
-        const extractedHtml = extractAssistantWebHtml({
-            extractMode: input.extractMode,
-            html: responseText.text,
-        });
-        title = extractedHtml.title;
-        text = extractedHtml.text;
-        extractor = extractedHtml.extractor;
-        warnings.push(...extractedHtml.warnings);
-    }
-    else if (isAssistantWebJsonContentType(input.contentType)) {
-        extractor = 'json';
-        const normalizedJson = normalizeAssistantWebJsonText(responseText.text);
-        text = normalizedJson.text;
-        warnings.push(...normalizedJson.warnings);
-    }
-    const truncated = responseText.truncated;
-    const bounded = truncateAssistantWebText(text, input.maxChars);
-    if (bounded.truncated) {
-        warnings.push(`Trimmed extracted content to ${input.maxChars} characters for model safety.`);
-    }
-    return {
-        extractor,
-        title,
-        text: bounded.text,
-        truncated: truncated || bounded.truncated,
-        warnings,
-    };
-}
-async function readAssistantWebResponseText(input) {
-    const body = await readAssistantWebResponseBytes(input);
-    const decoder = new TextDecoder();
-    return {
-        text: decoder.decode(body.bytes),
-        truncated: body.truncated,
-        warnings: body.warnings,
-    };
-}
-export async function readAssistantWebResponseBytes(input) {
-    const warnings = [];
-    const contentLength = parsePositiveInteger(input.response.headers.get('content-length'));
-    if (contentLength !== null &&
-        contentLength > input.maxResponseBytes) {
-        warnings.push(`Response declared ${contentLength} bytes; reading only the first ${input.maxResponseBytes} bytes.`);
-    }
-    if (!input.response.body) {
-        return {
-            bytes: new Uint8Array(),
-            truncated: false,
-            warnings,
-        };
-    }
-    const reader = input.response.body.getReader();
-    let totalBytes = 0;
-    const chunks = [];
-    let truncated = false;
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done) {
-            break;
-        }
-        if (!value || value.length === 0) {
-            continue;
-        }
-        const remainingBytes = input.maxResponseBytes - totalBytes;
-        if (remainingBytes <= 0) {
-            truncated = true;
-            break;
-        }
-        const chunk = value.length > remainingBytes
-            ? value.subarray(0, remainingBytes)
-            : value;
-        totalBytes += chunk.length;
-        chunks.push(chunk);
-        if (value.length > remainingBytes) {
-            truncated = true;
-            break;
-        }
-    }
-    if (truncated) {
-        warnings.push(`Response body exceeded ${input.maxResponseBytes} bytes and was truncated.`);
-        try {
-            await reader.cancel();
-        }
-        catch {
-            // Ignore cancellation failures after truncation.
-        }
-    }
-    return {
-        bytes: concatAssistantWebResponseBytes(chunks, totalBytes),
-        truncated,
-        warnings,
-    };
-}
-function extractAssistantWebHtml(input) {
-    const document = parseAssistantHtmlDocument(input.html);
-    const article = parseAssistantHtmlWithReadability(document);
-    const warnings = [];
-    if (article) {
-        const articleText = normalizeAssistantText(article.textContent ?? '');
-        const markdownText = normalizeAssistantMarkdown(renderAssistantHtmlToMarkdown(parseAssistantHtmlFragment(normalizeNullableString(article.content) ?? '')));
-        if (input.extractMode === 'markdown' && markdownText.length === 0 && articleText.length > 0) {
-            warnings.push('Readable article markdown conversion was empty; falling back to normalized article text.');
-        }
-        return {
-            extractor: 'readability',
-            title: normalizeNullableString(article.title) ??
-                resolveAssistantHtmlDocumentTitle(document),
-            text: input.extractMode === 'markdown'
-                ? (markdownText || articleText)
-                : articleText,
-            warnings,
-        };
-    }
-    warnings.push('Readable article extraction failed; falling back to a simpler HTML cleanup path.');
-    const fallbackText = normalizeAssistantText(document.body?.textContent ?? '');
-    const fallbackMarkdown = normalizeAssistantMarkdown(renderAssistantHtmlToMarkdown(document));
-    if (input.extractMode === 'markdown' && fallbackMarkdown.length === 0 && fallbackText.length > 0) {
-        warnings.push('Fallback HTML markdown conversion was empty; returning normalized page text instead.');
-    }
-    return {
-        extractor: 'raw-html',
-        title: resolveAssistantHtmlDocumentTitle(document),
-        text: input.extractMode === 'markdown'
-            ? (fallbackMarkdown || fallbackText)
-            : fallbackText,
-        warnings,
-    };
-}
-function normalizeAssistantWebJsonText(input) {
-    try {
-        return {
-            text: `${JSON.stringify(JSON.parse(input), null, 2)}\n`,
-            warnings: [],
-        };
-    }
-    catch {
-        return {
-            text: normalizeAssistantText(input),
-            warnings: [
-                'Response declared JSON but could not be parsed cleanly; returning normalized text instead.',
-            ],
-        };
-    }
-}
-function parseAssistantHtmlDocument(html) {
-    const document = new DOMParser().parseFromString(html, 'text/html');
-    for (const element of document.querySelectorAll('script, style, noscript, iframe, svg, canvas, form')) {
-        element.remove();
-    }
-    return document;
-}
-function parseAssistantHtmlFragment(htmlFragment) {
-    return parseAssistantHtmlDocument(`<!doctype html><html><body>${htmlFragment}</body></html>`);
-}
-function renderAssistantHtmlToMarkdown(document) {
-    return normalizeAssistantMarkdown(renderAssistantNodeToMarkdown(document.body));
-}
-function renderAssistantNodeToMarkdown(node) {
-    if (!node) {
-        return '';
-    }
-    if (node.nodeType === ASSISTANT_WEB_FETCH_TEXT_NODE) {
-        return escapeAssistantMarkdownText(node.textContent ?? '');
-    }
-    if (node.nodeType !== ASSISTANT_WEB_FETCH_ELEMENT_NODE) {
-        return '';
-    }
-    const tagName = node.nodeName.toLowerCase();
-    const childText = renderAssistantChildrenToMarkdown(node);
-    switch (tagName) {
-        case 'body':
-        case 'main':
-        case 'article':
-        case 'section':
-        case 'header':
-        case 'footer':
-        case 'nav':
-        case 'aside':
-        case 'div':
-            return `${childText}\n\n`;
-        case 'h1':
-        case 'h2':
-        case 'h3':
-        case 'h4':
-        case 'h5':
-        case 'h6': {
-            const level = Math.max(1, Math.min(Number(tagName.slice(1)) || 1, 6));
-            const heading = normalizeAssistantText(childText);
-            return heading ? `${'#'.repeat(level)} ${heading}\n\n` : '';
-        }
-        case 'p':
-            return childText.trim() ? `${childText.trim()}\n\n` : '';
-        case 'br':
-            return '\n';
-        case 'hr':
-            return '\n---\n\n';
-        case 'ul':
-        case 'ol':
-            return `${renderAssistantListToMarkdown(node, tagName === 'ol')}\n`;
-        case 'li': {
-            const text = normalizeAssistantMarkdownInline(childText);
-            return text ? `${text}\n` : '';
-        }
-        case 'pre': {
-            const code = normalizeTrailingWhitespace(node.textContent ?? '');
-            return code ? `\n\`\`\`\n${code}\n\`\`\`\n\n` : '';
-        }
-        case 'code': {
-            const text = normalizeAssistantText(node.textContent ?? '');
-            return text ? `\`${text}\`` : '';
-        }
-        case 'a': {
-            const text = normalizeAssistantMarkdownInline(childText);
-            const href = normalizeNullableString(node.getAttribute?.('href') ?? null);
-            if (!text) {
-                return '';
-            }
-            if (!href) {
-                return text;
-            }
-            return `[${text}](${href})`;
-        }
-        case 'strong':
-        case 'b': {
-            const text = normalizeAssistantMarkdownInline(childText);
-            return text ? `**${text}**` : '';
-        }
-        case 'em':
-        case 'i': {
-            const text = normalizeAssistantMarkdownInline(childText);
-            return text ? `_${text}_` : '';
-        }
-        case 'blockquote': {
-            const lines = normalizeAssistantText(childText)
-                .split('\n')
-                .filter((line) => line.length > 0);
-            return lines.length > 0
-                ? `${lines.map((line) => `> ${line}`).join('\n')}\n\n`
-                : '';
-        }
-        case 'table':
-            return `${normalizeAssistantText(childText)}\n\n`;
-        default:
-            return childText;
-    }
-}
-function renderAssistantChildrenToMarkdown(node) {
-    if (!node.childNodes || node.childNodes.length === 0) {
-        return '';
-    }
-    let markdown = '';
-    for (const childNode of Array.from(node.childNodes)) {
-        markdown += renderAssistantNodeToMarkdown(childNode);
-    }
-    return markdown;
-}
-function renderAssistantListToMarkdown(node, ordered) {
-    if (!node.childNodes || node.childNodes.length === 0) {
-        return '';
-    }
-    let markdown = '';
-    let orderedListIndex = 1;
-    for (const childNode of Array.from(node.childNodes)) {
-        if (childNode.nodeType !== ASSISTANT_WEB_FETCH_ELEMENT_NODE) {
-            continue;
-        }
-        if (childNode.nodeName.toLowerCase() !== 'li') {
-            markdown += renderAssistantNodeToMarkdown(childNode);
-            continue;
-        }
-        const itemText = normalizeAssistantMarkdownInline(renderAssistantChildrenToMarkdown(childNode));
-        if (!itemText) {
-            continue;
-        }
-        markdown += ordered
-            ? `${orderedListIndex}. ${itemText}\n`
-            : `- ${itemText}\n`;
-        orderedListIndex += 1;
-    }
-    return markdown;
-}
-export function truncateAssistantWebText(input, maxChars) {
-    if (input.length <= maxChars) {
-        return {
-            text: input,
-            truncated: false,
-        };
-    }
-    return {
-        text: input.slice(0, maxChars).trimEnd(),
-        truncated: true,
-    };
-}
-function resolveAssistantWebFetchMaxChars(env) {
-    return readAssistantBoundedIntegerEnv({
-        env,
-        key: 'MURPH_WEB_FETCH_MAX_CHARS',
-        fallback: ASSISTANT_WEB_FETCH_DEFAULT_MAX_CHARS,
-        min: 1,
-        max: ASSISTANT_WEB_FETCH_MAX_CHARS,
-    });
-}
-function resolveAssistantWebFetchMaxResponseBytes(env) {
-    return readAssistantBoundedIntegerEnv({
-        env,
-        key: 'MURPH_WEB_FETCH_MAX_RESPONSE_BYTES',
-        fallback: ASSISTANT_WEB_FETCH_DEFAULT_MAX_RESPONSE_BYTES,
-        min: 16_384,
-        max: ASSISTANT_WEB_FETCH_MAX_RESPONSE_BYTES,
-    });
-}
-function resolveAssistantWebFetchTimeoutMs(env) {
-    return readAssistantBoundedIntegerEnv({
-        env,
-        key: 'MURPH_WEB_FETCH_TIMEOUT_MS',
-        fallback: ASSISTANT_WEB_FETCH_DEFAULT_TIMEOUT_MS,
-        min: ASSISTANT_WEB_FETCH_MIN_TIMEOUT_MS,
-        max: ASSISTANT_WEB_FETCH_MAX_TIMEOUT_MS,
-    });
-}
-function resolveAssistantWebFetchMaxRedirects(env) {
-    return readAssistantBoundedIntegerEnv({
-        env,
-        key: 'MURPH_WEB_FETCH_MAX_REDIRECTS',
-        fallback: ASSISTANT_WEB_FETCH_DEFAULT_MAX_REDIRECTS,
-        min: 0,
-        max: ASSISTANT_WEB_FETCH_MAX_REDIRECTS,
-    });
-}
-function readAssistantBoundedIntegerEnv(input) {
-    const raw = normalizeNullableString(input.env[input.key]);
-    if (!raw) {
-        return input.fallback;
-    }
-    const numeric = Number(raw);
-    if (!Number.isFinite(numeric)) {
-        return input.fallback;
-    }
-    return Math.max(input.min, Math.min(Math.trunc(numeric), input.max));
-}
-export function resolveAssistantWebMediaType(contentType) {
-    const normalized = normalizeNullableString(contentType);
-    if (!normalized) {
-        return null;
-    }
-    return normalized.split(';', 1)[0]?.trim().toLowerCase() ?? null;
-}
-function parsePositiveInteger(value) {
-    const normalized = normalizeNullableString(value);
-    if (!normalized) {
-        return null;
-    }
-    const parsed = Number(normalized);
-    if (!Number.isFinite(parsed) || parsed <= 0) {
-        return null;
-    }
-    return Math.trunc(parsed);
-}
-function concatAssistantWebResponseBytes(chunks, totalBytes) {
-    if (chunks.length === 0) {
-        return new Uint8Array();
-    }
-    if (chunks.length === 1) {
-        return chunks[0] ?? new Uint8Array();
-    }
-    const bytes = new Uint8Array(totalBytes);
-    let offset = 0;
-    for (const chunk of chunks) {
-        bytes.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return bytes;
-}
-function isAssistantWebRedirectStatus(status) {
-    return status === 301 ||
-        status === 302 ||
-        status === 303 ||
-        status === 307 ||
-        status === 308;
-}
 function isAssistantWebFetchExtractMode(value) {
     return value === 'markdown' || value === 'text';
 }
-function isAssistantWebHtmlContentType(contentType) {
-    return contentType === 'text/html' || contentType === 'application/xhtml+xml';
-}
-function isAssistantWebJsonContentType(contentType) {
-    return contentType === 'application/json' ||
-        Boolean(contentType?.endsWith('+json'));
-}
-function isAssistantWebLikelyBinaryContentType(contentType) {
-    if (!contentType) {
-        return false;
-    }
-    if (contentType.startsWith('text/') ||
-        isAssistantWebHtmlContentType(contentType) ||
-        isAssistantWebJsonContentType(contentType) ||
-        contentType === 'application/xml' ||
-        contentType.endsWith('+xml') ||
-        contentType === 'image/svg+xml') {
-        return false;
-    }
-    return contentType.startsWith('image/') ||
-        contentType.startsWith('audio/') ||
-        contentType.startsWith('video/') ||
-        contentType === 'application/octet-stream' ||
-        contentType === 'application/pdf' ||
-        contentType === 'application/zip';
-}
-function isAssistantWebBlockedHostname(hostname) {
-    if (ASSISTANT_WEB_FETCH_BLOCKED_HOSTNAMES.some((blocked) => blocked === hostname)) {
-        return true;
-    }
-    return hostname.endsWith('.localhost') ||
-        hostname.endsWith('.local') ||
-        hostname.endsWith('.home.arpa');
-}
-function isAssistantWebBlockedIpAddress(address, family) {
-    if (family === 4) {
-        return assistantWebFetchBlockedAddressList.check(address, 'ipv4');
-    }
-    if (family === 6) {
-        const mappedIpv4 = resolveAssistantWebIpv4MappedAddress(address);
-        if (mappedIpv4) {
-            return assistantWebFetchBlockedAddressList.check(mappedIpv4, 'ipv4');
-        }
-        return assistantWebFetchBlockedAddressList.check(address, 'ipv6');
-    }
-    return false;
-}
-function normalizeAssistantWebHostname(value) {
-    const normalized = normalizeNullableString(value)?.toLowerCase();
-    if (!normalized) {
-        return null;
-    }
-    const unwrapped = normalized.startsWith('[') && normalized.endsWith(']')
-        ? normalized.slice(1, -1)
-        : normalized;
-    const trimmed = unwrapped.replace(/\.+$/u, '');
-    return trimmed.length > 0 ? trimmed : null;
-}
-function resolveAssistantWebIpv4MappedAddress(address) {
-    const normalized = address.toLowerCase();
-    if (!normalized.startsWith('::ffff:')) {
-        return null;
-    }
-    const suffix = normalized.slice('::ffff:'.length);
-    if (isIP(suffix) === 4) {
-        return suffix;
-    }
-    const parts = suffix.split(':');
-    if (parts.length !== 2 ||
-        !parts.every((part) => /^[0-9a-f]{1,4}$/u.test(part))) {
-        return null;
-    }
-    const left = Number.parseInt(parts[0] ?? '', 16);
-    const right = Number.parseInt(parts[1] ?? '', 16);
-    if (!Number.isFinite(left) || !Number.isFinite(right)) {
-        return null;
-    }
-    return [
-        (left >> 8) & 0xff,
-        left & 0xff,
-        (right >> 8) & 0xff,
-        right & 0xff,
-    ].join('.');
-}
-function createAssistantWebFetchBlockedAddressList() {
-    const blockList = new BlockList();
-    blockList.addSubnet('0.0.0.0', 8);
-    blockList.addSubnet('10.0.0.0', 8);
-    blockList.addSubnet('100.64.0.0', 10);
-    blockList.addSubnet('127.0.0.0', 8);
-    blockList.addSubnet('169.254.0.0', 16);
-    blockList.addSubnet('172.16.0.0', 12);
-    blockList.addSubnet('192.0.0.0', 24);
-    blockList.addSubnet('192.168.0.0', 16);
-    blockList.addSubnet('198.18.0.0', 15);
-    blockList.addSubnet('224.0.0.0', 4);
-    blockList.addSubnet('240.0.0.0', 4);
-    blockList.addSubnet('::', 128, 'ipv6');
-    blockList.addSubnet('::ffff:0:0', 96, 'ipv6');
-    blockList.addSubnet('::1', 128, 'ipv6');
-    blockList.addSubnet('fc00::', 7, 'ipv6');
-    blockList.addSubnet('fe80::', 10, 'ipv6');
-    blockList.addSubnet('ff00::', 8, 'ipv6');
-    return blockList;
-}
-export function redactAssistantWebFetchUrl(url) {
-    return `${url.origin}${url.pathname}`;
-}
-async function requestAssistantWebResponseAtPublicTarget(input) {
-    const failures = [];
-    for (const address of input.resolvedTarget.addresses) {
-        try {
-            return await requestAssistantWebResponseAtAddress({
-                acceptHeader: input.acceptHeader,
-                address,
-                hostname: input.resolvedTarget.hostname,
-                signal: input.signal,
-                url: input.url,
-            });
-        }
-        catch (error) {
-            if (input.signal.aborted || isAssistantWebAbortError(error)) {
-                throw error;
-            }
-            failures.push(errorMessage(error));
-        }
-    }
-    throw new Error(failures.length > 0
-        ? `All vetted public addresses failed: ${failures.join('; ')}`
-        : 'All vetted public addresses failed.');
-}
-async function requestAssistantWebResponseAtAddress(input) {
-    const options = {
-        ...urlToHttpOptions(input.url),
-        method: 'GET',
-        headers: {
-            accept: input.acceptHeader,
-            'accept-encoding': 'identity',
-        },
-        autoSelectFamily: false,
-        family: input.address.family,
-        // Use a one-shot socket so the request cannot reuse a pooled connection that resolved differently.
-        agent: false,
-        lookup: isIP(input.hostname) === 0
-            ? createAssistantWebPinnedLookup(input.address)
-            : undefined,
-        servername: input.url.protocol === 'https:' && isIP(input.hostname) === 0
-            ? input.hostname
-            : undefined,
-        signal: input.signal,
-    };
-    const requestImplementation = input.url.protocol === 'https:'
-        ? requestHttps
-        : requestHttp;
-    return await new Promise((resolve, reject) => {
-        const request = requestImplementation(options, (response) => {
-            try {
-                resolve(createAssistantWebNodeResponse(response));
-            }
-            catch (error) {
-                reject(error);
-            }
-        });
-        request.once('error', reject);
-        request.end();
-    });
-}
-function createAssistantWebPinnedLookup(address) {
-    return (_hostname, options, callback) => {
-        const requestedFamily = typeof options === 'number'
-            ? options
-            : options.family === 'IPv4'
-                ? 4
-                : options.family === 'IPv6'
-                    ? 6
-                    : options.family ?? 0;
-        queueMicrotask(() => {
-            if (requestedFamily !== 0 && requestedFamily !== address.family) {
-                callback(new Error(`Pinned address family ${address.family} did not match requested family ${requestedFamily}.`), address.address, address.family);
-                return;
-            }
-            callback(null, address.address, address.family);
-        });
-    };
-}
-function createAssistantWebNodeResponse(response) {
-    const headers = createAssistantWebResponseHeaders(response);
-    const body = decodeAssistantWebResponseBody(response, headers);
-    const status = response.statusCode ?? 500;
-    const statusText = normalizeNullableString(response.statusMessage);
-    return new Response(Readable.toWeb(body), {
-        status,
-        headers,
-        ...(statusText ? { statusText } : {}),
-    });
-}
-function createAssistantWebResponseHeaders(response) {
-    const headers = new Headers();
-    for (const [name, value] of Object.entries(response.headers)) {
-        if (Array.isArray(value)) {
-            for (const entry of value) {
-                headers.append(name, entry);
-            }
-            continue;
-        }
-        if (typeof value === 'string') {
-            headers.append(name, value);
-        }
-    }
-    return headers;
-}
-function decodeAssistantWebResponseBody(response, headers) {
-    const contentEncoding = normalizeNullableString(headers.get('content-encoding'))?.toLowerCase();
-    switch (contentEncoding) {
-        case 'br':
-            headers.delete('content-encoding');
-            headers.delete('content-length');
-            return response.pipe(createBrotliDecompress());
-        case 'deflate':
-        case 'gzip':
-        case 'x-gzip':
-            headers.delete('content-encoding');
-            headers.delete('content-length');
-            return response.pipe(createUnzip());
-        default:
-            return response;
-    }
-}
-async function cancelAssistantWebResponseBody(response) {
-    if (!response.body) {
-        return;
-    }
-    try {
-        await response.body.cancel();
-    }
-    catch {
-        // Ignore response-body cancellation failures during cleanup.
-    }
-}
-function isAssistantWebAbortError(error) {
-    return error instanceof Error && error.name === 'AbortError';
-}
-function normalizeAssistantText(input) {
-    return input
-        .replace(/\r\n?/gu, '\n')
-        .replace(/[ \t]+\n/gu, '\n')
-        .replace(/\n{3,}/gu, '\n\n')
-        .replace(/[ \t]{2,}/gu, ' ')
-        .trim();
-}
-function normalizeAssistantMarkdown(input) {
-    return input
-        .replace(/\r\n?/gu, '\n')
-        .replace(/[ \t]+\n/gu, '\n')
-        .replace(/\n{3,}/gu, '\n\n')
-        .trim();
-}
-function normalizeAssistantMarkdownInline(input) {
-    return normalizeAssistantText(input).replace(/\n+/gu, ' ');
-}
-function parseAssistantHtmlWithReadability(document) {
-    const ReadabilityConstructor = Readability;
-    return new ReadabilityConstructor(document).parse();
-}
-async function lookupAllAssistantWebAddresses(lookupImplementation, hostname) {
-    const resolved = await lookupImplementation(hostname, {
-        all: true,
-        verbatim: true,
-    });
-    const normalized = Array.isArray(resolved) ? resolved : [resolved];
-    const seen = new Set();
-    const addresses = [];
-    for (const entry of normalized) {
-        const key = `${entry.family}:${entry.address}`;
-        if (seen.has(key)) {
-            continue;
-        }
-        seen.add(key);
-        addresses.push(entry);
-    }
-    return addresses;
-}
-function resolveAssistantHtmlDocumentTitle(document) {
-    if (typeof document.title === 'string') {
-        return normalizeNullableString(document.title);
-    }
-    if (document.title &&
-        typeof document.title === 'object' &&
-        'textContent' in document.title) {
-        const textContent = document.title.textContent;
-        return typeof textContent === 'string'
-            ? normalizeNullableString(textContent)
-            : null;
-    }
-    return null;
-}
-function normalizeTrailingWhitespace(input) {
-    return input
-        .replace(/\r\n?/gu, '\n')
-        .replace(/\s+$/u, '');
-}
-function escapeAssistantMarkdownText(input) {
-    return input.replace(/([\\`*_{}\[\]()#+!|>~-])/gu, '\\$1');
-}
 //# sourceMappingURL=web-fetch.js.map