@xiaoso/dsh-tool-plus 0.1.6 → 0.1.7-beta.1

package/lib/types/tools/omp/utils/zip.d.ts

@@ -0,0 +1,129 @@
+/** A ZIP archive decoded to a `path → bytes` map of its file members. */
+export type Unzipped = Record<string, Uint8Array>;
+/** Read a single ZIP entry as UTF-8 text, or `undefined` when the entry is absent. */
+export declare function unzipText(entries: Unzipped, entryPath: string): string | undefined;
+/**
+ * Decode an in-memory ZIP archive into a `path → bytes` map of its file members
+ * (directory entries and `..`-escaping names are dropped). Shares the
+ * central-directory record parser with the lazy, file-backed reader.
+ */
+export declare function unzip(bytes: Uint8Array): Unzipped;
+export type ArchiveFormat = "zip" | "tar" | "tar.gz";
+/**
+ * Where to read an archive from: an extension-inferred filesystem path, a
+ * format-tagged filesystem path, or in-memory bytes with an explicit format.
+ * ZIP paths are read lazily via ranged central-directory access.
+ */
+export type ArchiveSource = string | {
+    bytes: Uint8Array;
+    format: ArchiveFormat;
+} | {
+    path: string;
+    format: ArchiveFormat;
+};
+/** Content for a member when packing or extracting an archive. */
+export type ArchiveMemberContent = string | Uint8Array | Blob;
+export interface ArchivePathCandidate {
+    archivePath: string;
+    subPath: string;
+}
+export interface ArchiveNode {
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    mtimeMs?: number;
+}
+export interface ArchiveDirectoryEntry extends ArchiveNode {
+    name: string;
+}
+export interface ExtractedArchiveFile extends ArchiveNode {
+    bytes: Uint8Array;
+}
+/** A byte window into an archive — file-backed (lazy) or in-memory. */
+interface ByteSource {
+    readonly size: number;
+    read(start: number, end: number): Promise<Uint8Array>;
+}
+interface TarStorage {
+    type: "tar";
+    buffer: Uint8Array;
+    dataOffset: number;
+    sparse: boolean;
+}
+interface TarLinkStorage {
+    type: "tar-link";
+    targetPath: string;
+}
+interface ZipStorage {
+    type: "zip";
+    source: ByteSource;
+    compressedSize: number;
+    compression: number;
+    flags: number;
+    localHeaderOffset: number;
+}
+type EntryStorage = TarStorage | TarLinkStorage | ZipStorage;
+interface ArchiveIndexEntry extends ArchiveNode {
+    storage?: EntryStorage;
+}
+/** Infer an archive format from a filesystem path's extension. */
+export declare function archiveFormatFromPath(filePath: string): ArchiveFormat | undefined;
+export declare function formatArchiveEntryLines(entries: readonly ArchiveDirectoryEntry[]): string[];
+export declare function sniffArchiveFormat(bytes: Uint8Array): ArchiveFormat | undefined;
+/**
+ * Split an `archive.ext:inner/path` reference into every plausible
+ * `{ archivePath, subPath }` pair, longest archive prefix first. A path may
+ * contain more than one archive extension, so each candidate is a guess at
+ * where the archive ends and the member portion begins.
+ */
+export declare function parseArchivePathCandidates(filePath: string): ArchivePathCandidate[];
+/**
+ * An indexed, read-only view over a single archive. ZIP archives are indexed
+ * from the central directory and members are inflated on demand; tar archives
+ * are parsed from one in-memory buffer, members are sliced on demand, and
+ * directory symlink aliases are traversed lazily.
+ */
+export declare class ArchiveReader {
+    #private;
+    readonly format: ArchiveFormat;
+    constructor(format: ArchiveFormat, entries: ArchiveIndexEntry[]);
+    getNode(subPath?: string): ArchiveNode | undefined;
+    listDirectory(subPath?: string): ArchiveDirectoryEntry[];
+    readFile(subPath: string): Promise<ExtractedArchiveFile>;
+}
+/**
+ * Open an archive for reading. ZIP archives opened from a path are indexed
+ * lazily via ranged central-directory reads (members inflate on demand); tar
+ * archives and in-memory ZIPs are read from a single buffer.
+ */
+export declare function openArchive(source: ArchiveSource): Promise<ArchiveReader>;
+/** Render the top-level entries of an in-memory archive as one line each. */
+export declare function listArchiveRoot(bytes: Uint8Array, format: ArchiveFormat, opts?: {
+    limit?: number;
+}): Promise<string>;
+/**
+ * Fully materialize every file member into a `path → content` map: ZIP members
+ * are inflated in memory, tar members are sliced from the decoded archive
+ * buffer. Use this when you need every entry (rewrite, extract); for browsing
+ * or single-member reads prefer `openArchive`, which is lazy for ZIP.
+ */
+export declare function readArchiveEntries(source: ArchiveSource): Promise<Map<string, ArchiveMemberContent>>;
+/**
+ * Serialize `entries` into an archive of `format` and write it to `destPath`.
+ * ZIP is framed in memory, tar / tar.gz via `Bun.Archive` (gzip for tar.gz).
+ * String members are encoded as UTF-8.
+ */
+export declare function writeArchive(destPath: string, format: ArchiveFormat, entries: Iterable<readonly [string, ArchiveMemberContent]>): Promise<void>;
+/**
+ * Extract every file member to `destDir`, creating parent directories as
+ * needed. Entries that would escape `destDir` (via `..` or an absolute path)
+ * are rejected. Returns the number of files written.
+ */
+export declare function extractArchive(source: ArchiveSource, destDir: string): Promise<number>;
+/**
+ * Frame a `path → bytes` map into a ZIP archive in memory. Each member is raw
+ * DEFLATE unless that would not shrink it, in which case it is stored. ZIP64 is
+ * not emitted; archives beyond the 32-bit limits throw rather than corrupt.
+ */
+export declare function zip(entries: Unzipped): Uint8Array;
+export {};

package/lib/types/tools/omp/web/browser-render.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Browser JS rendering for the read URL pipeline — the last reader backend
+ * in `FETCH_PROVIDER_ORDER`. Where the other backends fetch the raw HTML and
+ * convert it server-side, this one launches a real headless Chromium
+ * (puppeteer-core), lets the page's JavaScript run, and extracts readable
+ * content from the rendered DOM — which is what SPA pages need.
+ *
+ * Design (per the 2026-08-29 plan):
+ * - Singleton browser: lazily launched on first use, reused across renders,
+ *   closed after `BROWSER_IDLE_CLOSE_MS` of inactivity, best-effort killed on
+ *   process exit; a memoized instance found closed (idle recycle / crash) is
+ *   cleared and relaunched on the next render. A promise queue serializes
+ *   renders (one page at a time).
+ * - Budget: goto ≤ min(overall timeout, 20s), `domcontentloaded` + 800ms JS
+ *   settle, DOM capped at `BROWSER_RENDER_MAX_BYTES` before extraction.
+ * - Failure degenerates to `null` (the fetch chain then moves to the next
+ *   backend or reports the raw HTML), never throws for "no browser".
+ *
+ * `resetBrowserForTests` is the test seam for the unit suite.
+ * @module @xiaoso/dsh-tool-plus/web/browser-render
+ */
+/** Cap on the rendered DOM handed to the readable extractor. */
+export declare const BROWSER_RENDER_MAX_BYTES: number;
+/** Idle time after which the singleton browser is closed (renders reuse it). */
+export declare const BROWSER_IDLE_CLOSE_MS = 60000;
+/** Extra settle time after `domcontentloaded` for JS-rendered content. */
+export declare const RENDER_SETTLE_MS = 800;
+/**
+ * Render a URL in a headless browser and return readable markdown, or null
+ * when no browser is available / rendering fails. Serialized through the
+ * singleton queue; honors `signal` cancellation between attempts.
+ */
+export declare function renderUrlWithBrowser(url: string, options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<string | null>;
+/**
+ * Test seam: replicate the production idle-close state — the singleton
+ * browser is closed but `browserPromise` is left pointing at the dead
+ * instance (which is exactly what {@link scheduleIdleClose} does). A render
+ * in this state must relaunch rather than fail.
+ */
+export declare function simulateIdleCloseForTests(): Promise<void>;
+/**
+ * Test seam: close the singleton browser (if any) and reset the queue so a
+ * later render starts from a clean state. Also clears the launch memo so a
+ * subsequent render re-resolves the executable (e.g. after the detection
+ * RPC ran).
+ */
+export declare function resetBrowserForTests(): Promise<void>;

package/lib/types/tools/omp/web/parallel.d.ts

@@ -0,0 +1,68 @@
+import { type FetchImpl } from "@oh-my-pi/pi-ai";
+import type { AgentStorage } from "../session/agent-storage";
+export declare const PARALLEL_SEARCH_URL = "https://api.parallel.ai/v1beta/search";
+export declare const PARALLEL_BETA_HEADER = "search-extract-2025-10-10";
+export interface ParallelUsageItem {
+    name?: string;
+    count?: number;
+}
+export interface ParallelSearchSource {
+    title: string;
+    url: string;
+    snippet?: string;
+    publishedDate?: string;
+    excerpts: string[];
+}
+export interface ParallelSearchResult {
+    requestId: string;
+    sources: ParallelSearchSource[];
+    warnings: string[];
+    usage: ParallelUsageItem[];
+}
+export interface ParallelExtractDocument {
+    url: string;
+    title?: string;
+    publishedDate?: string;
+    excerpts: string[];
+    fullContent?: string;
+}
+export interface ParallelExtractErrorEntry {
+    url: string;
+    errorType?: string;
+    httpStatusCode?: number;
+    content?: string;
+}
+export interface ParallelExtractResult {
+    requestId: string;
+    results: ParallelExtractDocument[];
+    errors: ParallelExtractErrorEntry[];
+    warnings: string[];
+    usage: ParallelUsageItem[];
+}
+export interface ParallelSearchOptions {
+    mode?: "fast" | "research";
+    maxCharsPerResult?: number;
+    signal?: AbortSignal;
+    fetch?: FetchImpl;
+}
+export interface ParallelExtractOptions {
+    objective?: string;
+    searchQueries?: string[];
+    excerpts?: boolean;
+    fullContent?: boolean;
+    signal?: AbortSignal;
+    fetch?: FetchImpl;
+}
+export declare class ParallelApiError extends Error {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number);
+}
+export declare function parseParallelErrorResponse(statusCode: number, responseText: string): ParallelApiError;
+export declare function parseParallelJsonResponse(response: Response, operation: "search" | "extract"): Promise<unknown>;
+export declare function parseParallelSearchPayload(payload: unknown, options?: {
+    parseMetadata?: boolean;
+}): ParallelSearchResult;
+export declare function findParallelApiKey(storage: AgentStorage | null | undefined): string | null;
+export declare function getParallelExtractContent(document: ParallelExtractDocument): string;
+export declare function searchWithParallel(objective: string, queries: string[], options: ParallelSearchOptions, storage: AgentStorage | null | undefined): Promise<ParallelSearchResult>;
+export declare function extractWithParallel(urls: string[], options: ParallelExtractOptions, storage: AgentStorage | null | undefined): Promise<ParallelExtractResult>;

package/lib/types/tools/omp/web/scrapers/artifacthub.d.ts

@@ -0,0 +1,6 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle Artifact Hub URLs via API
+ * Supports Helm charts, OLM operators, Falco rules, OPA policies, etc.
+ */
+export declare const handleArtifactHub: SpecialHandler;

package/lib/types/tools/omp/web/scrapers/arxiv.d.ts

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

package/lib/types/tools/omp/web/scrapers/aur.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle AUR (Arch User Repository) URLs via RPC API
+ */
+export declare const handleAur: SpecialHandler;

package/lib/types/tools/omp/web/scrapers/biorxiv.d.ts

@@ -0,0 +1,5 @@
+import type { SpecialHandler } from "./types";
+/**
+ * Handle bioRxiv and medRxiv preprint URLs via their API
+ */
+export declare const handleBiorxiv: SpecialHandler;

package/lib/types/tools/omp/web/scrapers/bluesky.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/choosealicense.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/crossref.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/docs-rs.d.ts

@@ -0,0 +1,9 @@
+import type { SpecialHandler } from "./types";
+/** Hard ceiling for decompressed rustdoc JSON: a 50 MB compressed payload can
+ *  expand far enough to block the event loop or OOM without a cap. Exceeding it
+ *  throws (RangeError), which the fetch path converts to a `null` result. */
+export declare const MAX_RUSTDOC_GUNZIP_BYTES: number;
+/** Decompress a docs.rs rustdoc gzip payload with the output-size cap applied.
+ *  `maxOutputLength` is overridable only for tests exercising the cap contract. */
+export declare function gunzipRustdocJson(compressed: Buffer, maxOutputLength?: number): string;
+export declare const handleDocsRs: SpecialHandler;

package/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/firefox-addons.d.ts

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

package/lib/types/tools/omp/web/scrapers/flathub.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/gitlab.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/hackernews.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/huggingface.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/jetbrains-marketplace.d.ts

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

package/lib/types/tools/omp/web/scrapers/lemmy.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/mastodon.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/web/scrapers/mdn.d.ts

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

package/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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/lib/types/tools/omp/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;