inferoa 0.1.0

package/dist/src/tools/skill-tools.js.map

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

package/dist/src/tools/text-args.d.ts

@@ -0,0 +1,5 @@
+export declare function decodeEscapedTextArgument(value: string): string;
+export declare function textArgumentCandidates(value: string): Array<{
+    text: string;
+    decoded_escapes: boolean;
+}>;

package/dist/src/tools/text-args.js

@@ -0,0 +1,22 @@
+export function decodeEscapedTextArgument(value) {
+    // Handle literal escaped multiline text from tool arguments: \r\n -> \n, \n -> \n, \t -> \t, \" -> ", \\ -> \.
+    return value
+        .replace(/\\r\\n/g, "\n")
+        .replace(/\\n/g, "\n")
+        .replace(/\\t/g, "\t")
+        .replace(/\\r/g, "\r")
+        .replace(/\\"/g, '"')
+        .replace(/\\\\/g, "\\")
+        .replace(/\r\n/g, "\n");
+}
+export function textArgumentCandidates(value) {
+    const decoded = decodeEscapedTextArgument(value);
+    if (decoded === value) {
+        return [{ text: value, decoded_escapes: false }];
+    }
+    return [
+        { text: value, decoded_escapes: false },
+        { text: decoded, decoded_escapes: true },
+    ];
+}
+//# sourceMappingURL=text-args.js.map

package/dist/src/tools/text-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-args.js","sourceRoot":"","sources":["../../../src/tools/text-args.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,+GAA+G;IAC/G,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO;QACL,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;QACvC,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC"}

package/dist/src/tools/web-search.d.ts

@@ -0,0 +1,5 @@
+import type { JsonObject, ToolResult } from "../types.js";
+import type { ToolExecutionContext } from "./context.js";
+export declare function webSearch(args: JsonObject, context: ToolExecutionContext): Promise<ToolResult>;
+export declare function webFetch(args: JsonObject, context: ToolExecutionContext): Promise<ToolResult>;
+export declare function webOpen(args: JsonObject, context: ToolExecutionContext): Promise<ToolResult>;

package/dist/src/tools/web-search.js

@@ -0,0 +1,602 @@
+import { fail, ok, truncateText } from "../util/limit.js";
+import { endpointApiKey } from "../config/config.js";
+const DEFAULT_FETCH_BYTES = 1_000_000;
+const MAX_FETCH_BYTES = 5_000_000;
+const DEFAULT_TIMEOUT_MS = 20_000;
+const DEFAULT_SEARCH_TIMEOUT_MS = 20_000;
+const DDG_HTML_URL = "https://html.duckduckgo.com/html/";
+const DDG_INSTANT_URL = "https://api.duckduckgo.com/";
+export async function webSearch(args, context) {
+    const query = String(args.query ?? "").trim();
+    if (!query) {
+        return fail("web_search_missing_query", "web_search requires a non-empty query.");
+    }
+    const directUrl = firstHttpUrl(query);
+    if (directUrl) {
+        const fetched = await webFetch({
+            url: directUrl.toString(),
+            max_bytes: args.max_bytes,
+            timeout_ms: args.timeout_ms,
+        }, context);
+        return {
+            ...fetched,
+            summary: fetched.ok ? `Fetched direct URL from search query: ${directUrl.host}` : fetched.summary,
+            data: {
+                ...objectField(fetched.data),
+                query,
+                direct_url: directUrl.toString(),
+                via_search: true,
+            },
+        };
+    }
+    const limit = typeof args.limit === "number" ? Math.max(1, Math.min(args.limit, 20)) : 5;
+    const provider = context.config.web_search.provider;
+    try {
+        if (provider === "auto" || provider === "off") {
+            return await defaultSearchChain(query, limit, context, provider);
+        }
+        const configured = await configuredProviderSearch(provider, query, limit, context);
+        if (configured.ok) {
+            return configured;
+        }
+        return configured;
+    }
+    catch (error) {
+        return fail("web_search_failed", error instanceof Error ? error.message : String(error));
+    }
+}
+export async function webFetch(args, context) {
+    const parsed = normalizeHttpUrl(String(args.url ?? ""));
+    if (!parsed) {
+        return fail("web_fetch_invalid_url", "web_fetch requires an http or https URL.");
+    }
+    const maxBytes = clampNumber(args.max_bytes, DEFAULT_FETCH_BYTES, 16_384, MAX_FETCH_BYTES);
+    const timeoutMs = clampNumber(args.timeout_ms, DEFAULT_TIMEOUT_MS, 1_000, 120_000);
+    const format = typeof args.format === "string" ? args.format : "text";
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(parsed.toString(), {
+            headers: {
+                accept: "text/html,application/xhtml+xml,text/plain,application/json,*/*;q=0.8",
+                "user-agent": "inferoa/0.1",
+            },
+            redirect: "follow",
+            signal: controller.signal,
+        });
+        const contentType = response.headers.get("content-type") ?? "unknown";
+        const { text: raw, truncated: byteTruncated, bytes } = await readResponseText(response, maxBytes);
+        const extracted = format === "html" ? { text: raw } : extractReadableText(raw, contentType);
+        const preview = truncateText(extracted.text, 18_000);
+        const needsResource = preview.truncated || byteTruncated || raw.length !== extracted.text.length;
+        const resource = needsResource
+            ? context.store.putResource(context.session_id, "web_fetch.text", extracted.text, {
+                url: parsed.toString(),
+                final_url: response.url,
+                status: response.status,
+                content_type: contentType,
+                title: extracted.title,
+                byte_truncated: byteTruncated,
+            }).uri
+            : undefined;
+        return {
+            ok: response.ok,
+            summary: `${response.ok ? "Fetched" : "Fetch returned"} ${response.status} ${contentType} from ${new URL(response.url).host}`,
+            data: {
+                url: parsed.toString(),
+                final_url: response.url,
+                status: response.status,
+                ok: response.ok,
+                content_type: contentType,
+                title: extracted.title,
+                bytes,
+                byte_truncated: byteTruncated,
+                text: preview.text,
+            },
+            resource_uri: resource,
+            error: response.ok ? undefined : { code: "web_fetch_http_error", message: `HTTP ${response.status}` },
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError") {
+            return fail("web_fetch_timeout", `Timed out after ${timeoutMs}ms`, { url: parsed.toString(), timeout_ms: timeoutMs });
+        }
+        return fail("web_fetch_failed", error instanceof Error ? error.message : String(error), { url: parsed.toString() });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export async function webOpen(args, context) {
+    const parsed = normalizeHttpUrl(String(args.url ?? ""));
+    if (!parsed) {
+        return fail("web_open_invalid_url", "web_open requires an http or https URL.");
+    }
+    const preview = await webFetch({
+        url: parsed.toString(),
+        max_bytes: args.max_bytes ?? 500_000,
+        timeout_ms: args.timeout_ms,
+        format: args.format,
+    }, context);
+    const data = objectField(preview.data);
+    const note = typeof args.note === "string" ? args.note : undefined;
+    return {
+        ...preview,
+        summary: preview.ok
+            ? preview.summary.replace(/^Fetched/, "Opened")
+            : preview.summary.replace(/^Fetch returned/, "Open returned"),
+        data: {
+            ...data,
+            url: parsed.toString(),
+            opened: true,
+            note,
+        },
+    };
+}
+function objectField(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringField(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function firstHttpUrl(value) {
+    const exact = normalizeHttpUrl(value);
+    if (exact) {
+        return exact;
+    }
+    for (const match of value.matchAll(/https?:\/\/[^\s<>"'`)\]]+/gi)) {
+        const parsed = normalizeHttpUrl(trimTrailingUrlPunctuation(match[0] ?? ""));
+        if (parsed) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+function trimTrailingUrlPunctuation(value) {
+    let next = value.trim();
+    while (/[.,;:!?。，、；：！？]$/.test(next)) {
+        next = next.slice(0, -1);
+    }
+    return next;
+}
+async function configuredProviderSearch(provider, query, limit, context) {
+    if (provider === "brave") {
+        return await braveSearch(query, limit, context);
+    }
+    if (provider === "searxng" || provider === "custom") {
+        return await searxngSearch(query, limit, context);
+    }
+    if (provider === "jina") {
+        return await jinaSearch(query, limit, context);
+    }
+    return fail("web_search_provider_unsupported", `${provider} web_search is not implemented in this build. Choose auto, brave, jina, searxng, or custom in /setup.`, { query, provider });
+}
+async function defaultSearchChain(query, limit, context, mode) {
+    const attempts = [];
+    const candidates = searchQueryCandidates(query);
+    for (const candidate of candidates) {
+        const html = await tryDuckDuckGoHtml(candidate, limit, attempts);
+        if (html.length) {
+            return searchResultsOk("DuckDuckGo", candidate, html, limit, attempts, { mode });
+        }
+        if (containsCjk(candidate)) {
+            const regional = await tryDuckDuckGoHtml(candidate, limit, attempts, "cn-zh");
+            if (regional.length) {
+                return searchResultsOk("DuckDuckGo", candidate, regional, limit, attempts, { mode, region: "cn-zh" });
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        const instant = await tryDuckDuckGoInstant(candidate, limit, attempts);
+        if (instant.length) {
+            return searchResultsOk("DuckDuckGo Instant", candidate, instant, limit, attempts, { mode });
+        }
+    }
+    const jina = await jinaSearch(query, limit, context, true);
+    const data = objectField(jina.data);
+    return {
+        ...jina,
+        data: {
+            ...data,
+            mode,
+            attempts: attempts,
+        },
+    };
+}
+function searchQueryCandidates(query) {
+    const normalized = query.replace(/\s+/g, " ").trim();
+    return normalized ? [normalized] : [];
+}
+async function tryDuckDuckGoHtml(query, limit, attempts, region) {
+    const label = region ? `duckduckgo:${region}` : "duckduckgo";
+    try {
+        const url = new URL(DDG_HTML_URL);
+        url.searchParams.set("q", query);
+        if (region) {
+            url.searchParams.set("kl", region);
+        }
+        const response = await fetchTextWithTimeout(url, {
+            accept: "text/html,application/xhtml+xml",
+            timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,
+        });
+        if (!response.ok) {
+            attempts.push({ provider: label, status: "failed", message: `HTTP ${response.status}` });
+            return [];
+        }
+        const results = parseDuckDuckGoHtml(response.text, limit);
+        attempts.push({
+            provider: label,
+            status: results.length ? "ok" : "skipped",
+            message: results.length ? `${results.length} results` : "no results",
+        });
+        return results;
+    }
+    catch (error) {
+        attempts.push({ provider: label, status: "failed", message: error instanceof Error ? error.message : String(error) });
+        return [];
+    }
+}
+async function tryDuckDuckGoInstant(query, limit, attempts) {
+    try {
+        const url = new URL(DDG_INSTANT_URL);
+        url.searchParams.set("q", query);
+        url.searchParams.set("format", "json");
+        url.searchParams.set("no_html", "1");
+        url.searchParams.set("skip_disambig", "1");
+        const response = await fetchTextWithTimeout(url, {
+            accept: "application/json",
+            timeoutMs: DEFAULT_SEARCH_TIMEOUT_MS,
+        });
+        if (!response.ok) {
+            attempts.push({ provider: "duckduckgo:instant", status: "failed", message: `HTTP ${response.status}` });
+            return [];
+        }
+        const results = parseDuckDuckGoInstant(response.text, limit);
+        attempts.push({
+            provider: "duckduckgo:instant",
+            status: results.length ? "ok" : "skipped",
+            message: results.length ? `${results.length} results` : "no results",
+        });
+        return results;
+    }
+    catch (error) {
+        attempts.push({ provider: "duckduckgo:instant", status: "failed", message: error instanceof Error ? error.message : String(error) });
+        return [];
+    }
+}
+function searchResultsOk(provider, query, results, limit, attempts, extra = {}) {
+    return ok(`Found ${results.length} results via ${provider}`, {
+        query,
+        provider,
+        fallback: true,
+        limit,
+        results: results,
+        results_text: formatSearchResults(query, results),
+        attempts: attempts,
+        ...extra,
+    });
+}
+function parseDuckDuckGoHtml(html, limit) {
+    const results = [];
+    const blocks = html.match(/<div[^>]+class=["'][^"']*\bresult\b[^"']*["'][\s\S]*?(?=<div[^>]+class=["'][^"']*\bresult\b|<\/body>|$)/gi) ?? [html];
+    for (const block of blocks) {
+        const link = /<a[^>]+class=["'][^"']*\bresult__a\b[^"']*["'][^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/i.exec(block)
+            ?? /<a[^>]+href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/i.exec(block);
+        if (!link?.[1] || !link[2]) {
+            continue;
+        }
+        const url = unwrapDuckDuckGoResultUrl(decodeHtml(link[1]));
+        if (!url || results.some((result) => result.url === url)) {
+            continue;
+        }
+        const snippetMatch = /<a[^>]+class=["'][^"']*\bresult__snippet\b[^"']*["'][^>]*>([\s\S]*?)<\/a>/i.exec(block)
+            ?? /<div[^>]+class=["'][^"']*\bresult__snippet\b[^"']*["'][^>]*>([\s\S]*?)<\/div>/i.exec(block);
+        const title = normalizeText(decodeHtml(stripTags(link[2]))) || url;
+        const snippet = snippetMatch?.[1] ? normalizeText(decodeHtml(stripTags(snippetMatch[1]))) : undefined;
+        results.push({ title, url, snippet });
+        if (results.length >= limit) {
+            break;
+        }
+    }
+    return results;
+}
+function parseDuckDuckGoInstant(text, limit) {
+    const payload = safeJson(text);
+    const results = [];
+    const abstract = stringField(payload.AbstractText);
+    const abstractUrl = stringField(payload.AbstractURL);
+    if (abstract) {
+        results.push({ title: stringField(payload.Heading) ?? abstractUrl ?? "Instant answer", url: abstractUrl ?? "https://duckduckgo.com/", snippet: abstract });
+    }
+    const answer = stringField(payload.Answer);
+    if (answer && !results.some((result) => result.snippet === answer)) {
+        results.push({ title: stringField(payload.Heading) ?? "Instant answer", url: abstractUrl ?? "https://duckduckgo.com/", snippet: answer });
+    }
+    const related = Array.isArray(payload.RelatedTopics) ? flattenInstantTopics(payload.RelatedTopics) : [];
+    for (const item of related) {
+        const topic = objectField(item);
+        const topicText = stringField(topic.Text);
+        if (!topicText) {
+            continue;
+        }
+        const url = stringField(topic.FirstURL) ?? "https://duckduckgo.com/";
+        results.push({ title: topicText.split(" - ")[0] ?? topicText, url, snippet: topicText });
+        if (results.length >= limit) {
+            break;
+        }
+    }
+    return results.slice(0, limit);
+}
+function flattenInstantTopics(values) {
+    const output = [];
+    for (const value of values) {
+        const item = objectField(value);
+        const nested = item.Topics;
+        if (Array.isArray(nested)) {
+            output.push(...flattenInstantTopics(nested));
+        }
+        else if (Object.keys(item).length) {
+            output.push(item);
+        }
+    }
+    return output;
+}
+function formatSearchResults(query, results) {
+    const lines = [`search: ${query}`];
+    for (const [index, result] of results.entries()) {
+        lines.push(`${index + 1}. ${result.title}`);
+        lines.push(`   ${result.url}`);
+        if (result.snippet) {
+            lines.push(`   ${truncateText(result.snippet, 280).text}`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatJsonSearchResults(query, results) {
+    return formatSearchResults(query, results.map((result) => {
+        const title = stringField(result.title) ?? stringField(result.name) ?? stringField(result.url) ?? "Untitled";
+        const url = stringField(result.url) ?? stringField(result.link) ?? stringField(result.href) ?? "";
+        const snippet = stringField(result.description) ?? stringField(result.snippet) ?? stringField(result.content);
+        return { title, url, snippet };
+    }).filter((result) => result.url));
+}
+function unwrapDuckDuckGoResultUrl(rawUrl) {
+    const candidate = rawUrl.startsWith("//") ? `https:${rawUrl}` : rawUrl.startsWith("/") ? `https://duckduckgo.com${rawUrl}` : rawUrl;
+    const parsed = normalizeHttpUrl(candidate);
+    if (!parsed) {
+        return undefined;
+    }
+    if (parsed.hostname.endsWith("duckduckgo.com") && parsed.pathname.startsWith("/l/")) {
+        const redirect = parsed.searchParams.get("uddg");
+        const unwrapped = redirect ? normalizeHttpUrl(redirect) : undefined;
+        return unwrapped?.toString() ?? parsed.toString();
+    }
+    return parsed.toString();
+}
+async function fetchTextWithTimeout(url, options) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options.timeoutMs);
+    try {
+        const response = await fetch(url, {
+            headers: {
+                accept: options.accept,
+                "user-agent": "inferoa/0.1",
+            },
+            redirect: "follow",
+            signal: controller.signal,
+        });
+        return { ok: response.ok, status: response.status, text: await response.text() };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function containsCjk(value) {
+    return [...value].some((char) => {
+        const code = char.codePointAt(0) ?? 0;
+        return (code >= 0x3400 && code <= 0x9fff) || (code >= 0xf900 && code <= 0xfaff);
+    });
+}
+function stripTags(value) {
+    return value.replace(/<script\b[\s\S]*?<\/script>/gi, " ").replace(/<style\b[\s\S]*?<\/style>/gi, " ").replace(/<[^>]+>/g, " ");
+}
+function safeJson(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return objectField(parsed);
+    }
+    catch {
+        return {};
+    }
+}
+async function braveSearch(query, limit, context) {
+    const apiKey = endpointApiKey(context.config.web_search);
+    if (!apiKey) {
+        return fail("brave_api_key_missing", "BRAVE web search requires api_key or api_key_ref.");
+    }
+    const url = new URL("https://api.search.brave.com/res/v1/web/search");
+    url.searchParams.set("q", query);
+    url.searchParams.set("count", String(limit));
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "x-subscription-token": apiKey,
+        },
+    });
+    if (!response.ok) {
+        return fail("brave_search_failed", `Brave returned ${response.status}: ${await response.text()}`);
+    }
+    const json = (await response.json());
+    const results = (json.web?.results ?? []).slice(0, limit);
+    return ok(`Found ${results.length} Brave results`, {
+        query,
+        provider: "brave",
+        results: results,
+        results_text: formatJsonSearchResults(query, results),
+        limit,
+    });
+}
+async function searxngSearch(query, limit, context) {
+    if (!context.config.web_search.base_url) {
+        return fail("searxng_base_url_missing", "searxng/custom web_search requires base_url.");
+    }
+    const url = new URL(context.config.web_search.base_url.replace(/\/$/, "") + "/search");
+    url.searchParams.set("q", query);
+    url.searchParams.set("format", "json");
+    const response = await fetch(url, { headers: { accept: "application/json" } });
+    if (!response.ok) {
+        return fail("searxng_search_failed", `Search returned ${response.status}: ${await response.text()}`);
+    }
+    const json = (await response.json());
+    const results = (json.results ?? []).slice(0, limit);
+    return ok(`Found ${results.length} search results`, {
+        query,
+        provider: context.config.web_search.provider,
+        results: results,
+        results_text: formatJsonSearchResults(query, results),
+        limit,
+    });
+}
+async function jinaSearch(query, limit, context, fallback = false) {
+    const url = new URL("https://s.jina.ai/");
+    url.searchParams.set("q", query);
+    const apiKey = endpointApiKey(context.config.web_search);
+    const headers = { accept: "application/json" };
+    if (apiKey) {
+        headers.authorization = `Bearer ${apiKey}`;
+    }
+    const response = await fetch(url, { headers });
+    const text = await response.text();
+    if (!response.ok) {
+        return fail("jina_search_failed", `Jina returned ${response.status}: ${text}`);
+    }
+    const truncated = truncateText(text, 12_000);
+    const resource = truncated.truncated ? context.store.putResource(context.session_id, "web_search.raw", text, { query, provider: "jina" }).uri : undefined;
+    return {
+        ok: true,
+        summary: `${fallback ? "Fallback search" : "Jina search"} returned ${text.length} chars`,
+        data: {
+            query,
+            provider: "jina",
+            fallback,
+            results_text: truncated.text,
+            limit,
+        },
+        resource_uri: resource,
+    };
+}
+function normalizeHttpUrl(value) {
+    try {
+        const url = new URL(value.trim());
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return undefined;
+        }
+        return url;
+    }
+    catch {
+        return undefined;
+    }
+}
+function clampNumber(value, fallback, min, max) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return Math.max(min, Math.min(Math.trunc(value), max));
+}
+async function readResponseText(response, maxBytes) {
+    if (!response.body) {
+        const text = await response.text();
+        return { text, bytes: Buffer.byteLength(text), truncated: false };
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let bytes = 0;
+    let truncated = false;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        const chunk = value ?? new Uint8Array();
+        const remaining = maxBytes - bytes;
+        if (chunk.byteLength > remaining) {
+            chunks.push(chunk.slice(0, Math.max(0, remaining)));
+            bytes = maxBytes;
+            truncated = true;
+            await reader.cancel().catch(() => undefined);
+            break;
+        }
+        chunks.push(chunk);
+        bytes += chunk.byteLength;
+    }
+    return { text: new TextDecoder("utf-8", { fatal: false }).decode(concatChunks(chunks, bytes)), bytes, truncated };
+}
+function concatChunks(chunks, length) {
+    const out = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+function extractReadableText(raw, contentType) {
+    if (!/html|xml/i.test(contentType) && !looksLikeHtml(raw)) {
+        return { text: normalizeText(raw) };
+    }
+    const withoutHidden = raw
+        .replace(/<!--[\s\S]*?-->/g, " ")
+        .replace(/<script\b[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style\b[\s\S]*?<\/style>/gi, " ")
+        .replace(/<noscript\b[\s\S]*?<\/noscript>/gi, " ");
+    const titleMatch = /<title\b[^>]*>([\s\S]*?)<\/title>/i.exec(withoutHidden);
+    const title = titleMatch?.[1] ? normalizeText(decodeHtml(titleMatch[1].replace(/<[^>]+>/g, " "))) : undefined;
+    const withBreaks = withoutHidden
+        .replace(/<(br|hr)\b[^>]*>/gi, "\n")
+        .replace(/<\/(p|div|section|article|header|footer|main|li|tr|h[1-6])>/gi, "\n")
+        .replace(/<li\b[^>]*>/gi, "- ");
+    return { title, text: normalizeText(decodeHtml(withBreaks.replace(/<[^>]+>/g, " "))) };
+}
+function looksLikeHtml(text) {
+    return /<!doctype\s+html|<html\b|<body\b|<title\b/i.test(text.slice(0, 4096));
+}
+function normalizeText(text) {
+    return text
+        .replace(/\r\n?/g, "\n")
+        .split("\n")
+        .map((line) => line.replace(/[ \t\f\v]+/g, " ").trim())
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+function decodeHtml(text) {
+    return text.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (entity, token) => {
+        if (token.startsWith("#x")) {
+            return fromCodePoint(Number.parseInt(token.slice(2), 16), entity);
+        }
+        if (token.startsWith("#")) {
+            return fromCodePoint(Number.parseInt(token.slice(1), 10), entity);
+        }
+        const named = {
+            amp: "&",
+            apos: "'",
+            gt: ">",
+            lt: "<",
+            nbsp: " ",
+            quot: "\"",
+        };
+        return named[token.toLowerCase()] ?? entity;
+    });
+}
+function fromCodePoint(value, fallback) {
+    if (!Number.isFinite(value)) {
+        return fallback;
+    }
+    try {
+        return String.fromCodePoint(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=web-search.js.map