jeopi-cli 16.2.14 → 16.2.15

package/dist/types/web/scrapers/bluesky.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Bluesky post URLs
+ */
+export declare const handleBluesky: SpecialHandler;

package/dist/types/web/scrapers/brew.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Homebrew formulae and cask URLs via API
+ */
+export declare const handleBrew: SpecialHandler;

package/dist/types/web/scrapers/cheatsh.d.ts

@@ -0,0 +1,8 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle cheat.sh / cht.sh URLs for command cheatsheets
+ *
+ * API: Plain text at https://cheat.sh/{topic}?T (T flag removes ANSI colors)
+ * Supports: commands, language/topic queries (e.g., python/list, go/slice)
+ */
+export declare const handleCheatSh: SpecialHandler;

package/dist/types/web/scrapers/chocolatey.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Chocolatey package URLs via NuGet v2 OData API
+ */
+export declare const handleChocolatey: SpecialHandler;

package/dist/types/web/scrapers/choosealicense.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleChooseALicense: SpecialHandler;

package/dist/types/web/scrapers/cisa-kev.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle CISA Known Exploited Vulnerabilities (KEV) URLs
+ */
+export declare const handleCisaKev: SpecialHandler;

package/dist/types/web/scrapers/clojars.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Clojars URLs via API
+ */
+export declare const handleClojars: SpecialHandler;

package/dist/types/web/scrapers/coingecko.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle CoinGecko cryptocurrency URLs via API
+ */
+export declare const handleCoinGecko: SpecialHandler;

package/dist/types/web/scrapers/crates-io.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle crates.io URLs via API
+ */
+export declare const handleCratesIo: SpecialHandler;

package/dist/types/web/scrapers/crossref.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleCrossref: SpecialHandler;

package/dist/types/web/scrapers/devto.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle dev.to URLs via API
+ */
+export declare const handleDevTo: SpecialHandler;

package/dist/types/web/scrapers/discogs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Discogs URL handler for music releases and masters
+ *
+ * Uses the Discogs API to extract structured metadata about releases.
+ * API docs: https://www.discogs.com/developers
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleDiscogs: SpecialHandler;

package/dist/types/web/scrapers/discourse.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Discourse forum URLs via API
+ */
+export declare const handleDiscourse: SpecialHandler;

package/dist/types/web/scrapers/dockerhub.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Docker Hub URLs via API
+ */
+export declare const handleDockerHub: SpecialHandler;

package/dist/types/web/scrapers/docs-rs.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleDocsRs: SpecialHandler;

package/dist/types/web/scrapers/fdroid.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle F-Droid URLs via API
+ */
+export declare const handleFdroid: SpecialHandler;

package/dist/types/web/scrapers/firefox-addons.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleFirefoxAddons: SpecialHandler;

package/dist/types/web/scrapers/flathub.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleFlathub: SpecialHandler;

package/dist/types/web/scrapers/github-gist.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle GitHub Gist URLs via GitHub API
+ */
+export declare const handleGitHubGist: SpecialHandler;

package/dist/types/web/scrapers/github.d.ts

@@ -0,0 +1,34 @@
+import type { SpecialHandler } from "./types";
+interface GitHubUrl {
+    type: "blob" | "tree" | "repo" | "commit" | "issue" | "issues" | "pull" | "pulls" | "discussion" | "discussions" | "actions-run" | "actions-job" | "other";
+    owner: string;
+    repo: string;
+    ref?: string;
+    path?: string;
+    number?: number;
+    runId?: number;
+    jobId?: number;
+}
+/**
+ * Parse GitHub URL into components
+ */
+export declare function parseGitHubUrl(url: string): GitHubUrl | null;
+/**
+ * Fetch from GitHub API
+ */
+export declare function fetchGitHubApi(endpoint: string, timeout: number, signal?: AbortSignal): Promise<{
+    data: unknown;
+    ok: boolean;
+}>;
+/**
+ * Strip the per-line ISO-8601 timestamp prefix GitHub prepends to every job log line.
+ * Cuts ~28 bytes/line of noise while preserving the message text. Also drops the leading
+ * UTF-8 BOM GitHub puts at the start of the log file (otherwise the first line's timestamp
+ * survives because `^` no longer sits before a digit).
+ */
+export declare function stripActionsLogTimestamps(logs: string): string;
+/**
+ * Handle GitHub URLs specially
+ */
+export declare const handleGitHub: SpecialHandler;
+export {};

package/dist/types/web/scrapers/gitlab.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle GitLab URLs specially
+ */
+export declare const handleGitLab: SpecialHandler;

package/dist/types/web/scrapers/go-pkg.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle pkg.go.dev URLs via proxy API and page parsing
+ */
+export declare const handleGoPkg: SpecialHandler;

package/dist/types/web/scrapers/hackage.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Hackage (Haskell package registry) URLs via JSON API
+ */
+export declare const handleHackage: SpecialHandler;

package/dist/types/web/scrapers/hackernews.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleHackerNews: SpecialHandler;

package/dist/types/web/scrapers/hex.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Hex.pm (Elixir package registry) URLs via API
+ */
+export declare const handleHex: SpecialHandler;

package/dist/types/web/scrapers/huggingface.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleHuggingFace: SpecialHandler;

package/dist/types/web/scrapers/iacr.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle IACR ePrint Archive URLs
+ */
+export declare const handleIacr: SpecialHandler;

package/dist/types/web/scrapers/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Web Fetch Special Handlers Index
+ *
+ * Exports all special handlers for site-specific content extraction.
+ */
+import { handleArtifactHub } from "./artifacthub";
+import { handleArxiv } from "./arxiv";
+import { handleAur } from "./aur";
+import { handleBiorxiv } from "./biorxiv";
+import { handleBluesky } from "./bluesky";
+import { handleBrew } from "./brew";
+import { handleCheatSh } from "./cheatsh";
+import { handleChocolatey } from "./chocolatey";
+import { handleChooseALicense } from "./choosealicense";
+import { handleCisaKev } from "./cisa-kev";
+import { handleClojars } from "./clojars";
+import { handleCoinGecko } from "./coingecko";
+import { handleCratesIo } from "./crates-io";
+import { handleCrossref } from "./crossref";
+import { handleDevTo } from "./devto";
+import { handleDiscogs } from "./discogs";
+import { handleDiscourse } from "./discourse";
+import { handleDockerHub } from "./dockerhub";
+import { handleDocsRs } from "./docs-rs";
+import { handleFdroid } from "./fdroid";
+import { handleFirefoxAddons } from "./firefox-addons";
+import { handleFlathub } from "./flathub";
+import { fetchGitHubApi, handleGitHub } from "./github";
+import { handleGitHubGist } from "./github-gist";
+import { handleGitLab } from "./gitlab";
+import { handleGoPkg } from "./go-pkg";
+import { handleHackage } from "./hackage";
+import { handleHackerNews } from "./hackernews";
+import { handleHex } from "./hex";
+import { handleHuggingFace } from "./huggingface";
+import { handleIacr } from "./iacr";
+import { handleJetBrainsMarketplace } from "./jetbrains-marketplace";
+import { handleLemmy } from "./lemmy";
+import { handleLobsters } from "./lobsters";
+import { handleMastodon } from "./mastodon";
+import { handleMaven } from "./maven";
+import { handleMDN } from "./mdn";
+import { handleMetaCPAN } from "./metacpan";
+import { handleMusicBrainz } from "./musicbrainz";
+import { handleNpm } from "./npm";
+import { handleNuGet } from "./nuget";
+import { handleNvd } from "./nvd";
+import { handleOllama } from "./ollama";
+import { handleOpenVsx } from "./open-vsx";
+import { handleOpenCorporates } from "./opencorporates";
+import { handleOpenLibrary } from "./openlibrary";
+import { handleOrcid } from "./orcid";
+import { handleOsv } from "./osv";
+import { handlePackagist } from "./packagist";
+import { handlePubDev } from "./pub-dev";
+import { handlePubMed } from "./pubmed";
+import { handlePyPI } from "./pypi";
+import { handleRawg } from "./rawg";
+import { handleReadTheDocs } from "./readthedocs";
+import { handleReddit } from "./reddit";
+import { handleRepology } from "./repology";
+import { handleRfc } from "./rfc";
+import { handleRubyGems } from "./rubygems";
+import { handleSearchcode } from "./searchcode";
+import { handleSecEdgar } from "./sec-edgar";
+import { handleSemanticScholar } from "./semantic-scholar";
+import { handleSnapcraft } from "./snapcraft";
+import { handleSourcegraph } from "./sourcegraph";
+import { handleSpdx } from "./spdx";
+import { handleSpotify } from "./spotify";
+import { handleStackOverflow } from "./stackoverflow";
+import { handleTerraform } from "./terraform";
+import { handleTldr } from "./tldr";
+import { handleTwitter } from "./twitter";
+import type { SpecialHandler } from "./types";
+import { handleVimeo } from "./vimeo";
+import { handleVscodeMarketplace } from "./vscode-marketplace";
+import { handleW3c } from "./w3c";
+import { handleWikidata } from "./wikidata";
+import { handleWikipedia } from "./wikipedia";
+import { handleYouTube } from "./youtube";
+export type { RenderResult, SpecialHandler } from "./types";
+export { fetchGitHubApi, handleArtifactHub, handleArxiv, handleAur, handleBiorxiv, handleBluesky, handleBrew, handleCheatSh, handleChocolatey, handleChooseALicense, handleCisaKev, handleClojars, handleCoinGecko, handleCratesIo, handleCrossref, handleDevTo, handleDiscogs, handleDiscourse, handleDockerHub, handleDocsRs, handleFdroid, handleFirefoxAddons, handleFlathub, handleGitHub, handleGitHubGist, handleGitLab, handleGoPkg, handleHackage, handleHackerNews, handleHex, handleHuggingFace, handleIacr, handleJetBrainsMarketplace, handleLemmy, handleLobsters, handleMastodon, handleMaven, handleMDN, handleMetaCPAN, handleMusicBrainz, handleNpm, handleNuGet, handleNvd, handleOllama, handleOpenCorporates, handleOpenLibrary, handleOpenVsx, handleOrcid, handleOsv, handlePackagist, handlePubDev, handlePubMed, handlePyPI, handleRawg, handleReadTheDocs, handleReddit, handleRepology, handleRfc, handleRubyGems, handleSearchcode, handleSecEdgar, handleSemanticScholar, handleSnapcraft, handleSourcegraph, handleSpdx, handleSpotify, handleStackOverflow, handleTerraform, handleTldr, handleTwitter, handleVimeo, handleVscodeMarketplace, handleW3c, handleWikidata, handleWikipedia, handleYouTube, };
+export declare const specialHandlers: SpecialHandler[];

package/dist/types/web/scrapers/jetbrains-marketplace.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleJetBrainsMarketplace: SpecialHandler;

package/dist/types/web/scrapers/lemmy.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleLemmy: SpecialHandler;

package/dist/types/web/scrapers/lobsters.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Lobste.rs URLs via JSON API
+ */
+export declare const handleLobsters: SpecialHandler;

package/dist/types/web/scrapers/mastodon.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Mastodon/Fediverse URLs
+ */
+export declare const handleMastodon: SpecialHandler;

package/dist/types/web/scrapers/maven.d.ts

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Maven Central URLs via Solr API
+ * Supports: search.maven.org/artifact/... and mvnrepository.com/artifact/...
+ */
+export declare const handleMaven: SpecialHandler;

package/dist/types/web/scrapers/mdn.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleMDN: SpecialHandler;

package/dist/types/web/scrapers/metacpan.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle MetaCPAN URLs via fastapi.metacpan.org
+ */
+export declare const handleMetaCPAN: SpecialHandler;

package/dist/types/web/scrapers/musicbrainz.d.ts

@@ -0,0 +1,5 @@
+/**
+ * MusicBrainz URL handler for artists, releases, and recordings
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleMusicBrainz: SpecialHandler;

package/dist/types/web/scrapers/npm.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle npm URLs via registry API
+ */
+export declare const handleNpm: SpecialHandler;

package/dist/types/web/scrapers/nuget.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle NuGet URLs via API
+ */
+export declare const handleNuGet: SpecialHandler;

package/dist/types/web/scrapers/nvd.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle NVD (National Vulnerability Database) CVE URLs
+ */
+export declare const handleNvd: SpecialHandler;

package/dist/types/web/scrapers/ollama.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleOllama: SpecialHandler;

package/dist/types/web/scrapers/open-vsx.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Open VSX URLs via their API
+ */
+export declare const handleOpenVsx: SpecialHandler;

package/dist/types/web/scrapers/opencorporates.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle OpenCorporates URLs via API
+ */
+export declare const handleOpenCorporates: SpecialHandler;

package/dist/types/web/scrapers/openlibrary.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Open Library URLs via their API
+ */
+export declare const handleOpenLibrary: SpecialHandler;

package/dist/types/web/scrapers/orcid.d.ts

@@ -0,0 +1,5 @@
+/**
+ * ORCID handler for web-fetch
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleOrcid: SpecialHandler;

package/dist/types/web/scrapers/osv.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle OSV (Open Source Vulnerabilities) URLs
+ */
+export declare const handleOsv: SpecialHandler;

package/dist/types/web/scrapers/packagist.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Packagist URLs via JSON API
+ */
+export declare const handlePackagist: SpecialHandler;

package/dist/types/web/scrapers/pub-dev.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle pub.dev URLs via API
+ */
+export declare const handlePubDev: SpecialHandler;

package/dist/types/web/scrapers/pubmed.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle PubMed URLs - fetch article metadata, abstract, MeSH terms
+ */
+export declare const handlePubMed: SpecialHandler;

package/dist/types/web/scrapers/pypi.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle PyPI URLs via JSON API
+ */
+export declare const handlePyPI: SpecialHandler;

package/dist/types/web/scrapers/rawg.d.ts

@@ -0,0 +1,2 @@
+import { type SpecialHandler } from "./types";
+export declare const handleRawg: SpecialHandler;

package/dist/types/web/scrapers/readthedocs.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Read the Docs handler for web-fetch
+ */
+import { type SpecialHandler } from "./types";
+export declare const handleReadTheDocs: SpecialHandler;

package/dist/types/web/scrapers/reddit.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle Reddit URLs via JSON API
+ */
+export declare const handleReddit: SpecialHandler;

package/dist/types/web/scrapers/repology.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle Repology URLs via API
+ */
+export declare const handleRepology: SpecialHandler;

package/dist/types/web/scrapers/rfc.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle RFC Editor URLs - fetches IETF RFCs
+ */
+export declare const handleRfc: SpecialHandler;

package/dist/types/web/scrapers/rubygems.d.ts

@@ -0,0 +1,5 @@
+import { type SpecialHandler } from "./types";
+/**
+ * Handle RubyGems URLs via API
+ */
+export declare const handleRubyGems: SpecialHandler;

package/dist/types/web/scrapers/searchcode.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSearchcode: SpecialHandler;

package/dist/types/web/scrapers/sec-edgar.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle SEC EDGAR URLs via data.sec.gov API
+ */
+export declare const handleSecEdgar: SpecialHandler;

package/dist/types/web/scrapers/semantic-scholar.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSemanticScholar: SpecialHandler;

package/dist/types/web/scrapers/snapcraft.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSnapcraft: SpecialHandler;

package/dist/types/web/scrapers/sourcegraph.d.ts

@@ -0,0 +1,2 @@
+import type { SpecialHandler } from "./types";
+export declare const handleSourcegraph: SpecialHandler;

package/dist/types/web/scrapers/spdx.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle SPDX license URLs via SPDX JSON API
+ */
+export declare const handleSpdx: SpecialHandler;

package/dist/types/web/scrapers/spotify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Spotify URL handler for podcasts, tracks, albums, and playlists
+ *
+ * Uses oEmbed API and Open Graph metadata to extract information
+ * from Spotify URLs without requiring authentication.
+ */
+import type { SpecialHandler } from "./types";
+export declare const handleSpotify: SpecialHandler;

package/dist/types/web/scrapers/stackoverflow.d.ts

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Stack Exchange network URLs via API
+ * Supports stackoverflow.com, *.stackexchange.com, superuser.com, serverfault.com, askubuntu.com, etc.
+ */
+export declare const handleStackOverflow: SpecialHandler;

package/dist/types/web/scrapers/terraform.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Terraform Registry URLs via API
+ */
+export declare const handleTerraform: SpecialHandler;

package/dist/types/web/scrapers/tldr.d.ts

@@ -0,0 +1,7 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle tldr page URLs
+ * - https://tldr.sh/{command}
+ * - https://tldr.ostera.io/{command}
+ */
+export declare const handleTldr: SpecialHandler;

package/dist/types/web/scrapers/twitter.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Twitter/X URLs via Nitter
+ */
+export declare const handleTwitter: SpecialHandler;

package/dist/types/web/scrapers/types.d.ts

@@ -0,0 +1,90 @@
+import type { AgentStorage } from "../../session/agent-storage";
+export { formatNumber } from "jeopi-utils";
+export interface RenderResult {
+    url: string;
+    finalUrl: string;
+    contentType: string;
+    method: string;
+    content: string;
+    fetchedAt: string;
+    truncated: boolean;
+    notes: string[];
+}
+export type SpecialHandler = (url: string, timeout: number, signal?: AbortSignal, storage?: AgentStorage | null) => Promise<RenderResult | null>;
+export declare const MAX_OUTPUT_CHARS = 500000;
+export declare const MAX_BYTES: number;
+/**
+ * Truncate and cleanup output
+ */
+export declare function finalizeOutput(content: string): {
+    content: string;
+    truncated: boolean;
+};
+export interface LoadPageOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    method?: string;
+    body?: string;
+    maxBytes?: number;
+    signal?: AbortSignal;
+    /**
+     * Return true to skip reading the response body for this content type
+     * (lowercased mime, no params). The caller is expected to re-fetch the
+     * payload as binary; this avoids streaming + decoding huge binaries twice.
+     */
+    skipBodyForContentType?: (contentType: string) => boolean;
+}
+export interface LoadPageResult {
+    content: string;
+    contentType: string;
+    finalUrl: string;
+    ok: boolean;
+    status?: number;
+    /** True when the body was cut mid-stream at maxBytes. */
+    truncated?: boolean;
+    /** Last transport-level error message when ok is false. */
+    error?: string;
+    /** True when the body read was skipped via skipBodyForContentType. */
+    bodySkipped?: boolean;
+}
+/**
+ * Fetch a page with timeout and size limit
+ */
+export declare function loadPage(url: string, options?: LoadPageOptions): Promise<LoadPageResult>;
+/**
+ * Convert HTML to markdown using Turndown with GFM support.
+ * Strips script/style tags before conversion.
+ */
+export declare function htmlToBasicMarkdown(html: string): Promise<string>;
+/**
+ * Build a RenderResult from markdown content. Calls finalizeOutput internally.
+ */
+export declare function buildResult(md: string, opts: {
+    url: string;
+    finalUrl?: string;
+    method: string;
+    fetchedAt: string;
+    notes?: string[];
+    contentType?: string;
+}): RenderResult;
+/**
+ * Format a date value as YYYY-MM-DD. Returns empty string on invalid input.
+ */
+export declare function formatIsoDate(value?: string | number | Date): string;
+/**
+ * Decode common HTML entities.
+ */
+export declare function decodeHtmlEntities(text: string): string;
+/**
+ * Format seconds into HH:MM:SS or MM:SS.
+ */
+export declare function formatMediaDuration(totalSeconds: number): string;
+/**
+ * Extract localized text, preferring en-US/en.
+ */
+export type LocalizedText = string | Record<string, string | null> | null | undefined;
+export declare function getLocalizedText(value: LocalizedText, defaultLocale?: string): string | undefined;
+/**
+ * Check if content looks like HTML by inspecting the leading tag.
+ */
+export declare function looksLikeHtml(content: string): boolean;