Project Files

.claude

settings.local.json

src

bing

build-urls.ts

index.ts

parse-results.ts

search-images.ts

cache

image-search-results-payload.ts

index.ts

search-cache-key.ts

search-results-payload.ts

ttl-cache.ts

web-search-result.ts

config

auto-sentinel.ts

config-schematics.ts

resolve-config.ts

duckduckgo

build-urls.ts

index.ts

safe-search.ts

search-web.ts

enrichment

create-metascraper.ts

enrich-search-results.ts

index.ts

metascraper-helpers.d.ts

shape-web-search-results.ts

errors

index.ts

inspect-error.ts

no-results-error.ts

tool-error.ts

unsupported-content-type-error.ts

index.ts

lmstudio-home.ts

markdown-path.ts

url-filename.ts

http

decode-bytes.ts

fetch-error.ts

fetch-ok.ts

follow-redirects.ts

impit-client.ts

index.ts

parse-content-type.ts

read-limited-bytes.ts

retry.ts

translate-impit-error.ts

url-guard.ts

url-schema.ts

images

download-image.ts

download-images.ts

index.ts

parsers

page

page-images.ts

page-text.ts

pdf-text.ts

image-extensions.ts

index.ts

search-results.ts

text

escape-markdown.ts

html-to-markdown.ts

html-to-text.ts

index.ts

normalize-blank-lines.ts

normalize-text.ts

timing

index.ts

per-host-rate-limiter.ts

rate-limiter.ts

tools

fetch-images-tool.ts

image-search-tool.ts

visit-website-tool.ts

web-search-tool.ts

website

fetch-website.ts

fetched-page.ts

index.ts

page-kind.ts

render-visit-result.ts

index.ts

tools-provider.ts

.gitignore

.prettierrc.json

CLAUDE.md

eslint.config.mjs

knip.json

LICENSE

manifest.json

package-lock.json

package.json

QWEN.md

README.md

thumbnail.png

tsconfig.json

src / enrichment / metascraper-helpers.d.ts

/* eslint-disable jsdoc/require-jsdoc, unicorn/prevent-abbreviations, @typescript-eslint/consistent-type-imports */

/**
 * Minimal ambient declaration for the subset of `@metascraper/helpers` we use. The package
 * ships pure JS without bundled types, so we declare only the three exports the enrichment
 * plugin consumes (`date`, `description`, `$jsonld`) and reuse metascraper's own typed
 * surface for the cheerio root passed into `$jsonld`. Kept as a script file (no top-level
 * imports) so `declare module` declares a fresh ambient module rather than augmenting one.
 */

declare module "@metascraper/helpers" {
  type CheerioRoot = import("metascraper").RulesTestOptions["htmlDom"]

  export function date(value: unknown): string | undefined

  export function description(value: unknown, opts?: { truncateLength?: number; ellipsis?: string }): string | undefined

  export function $jsonld(propName: string): (dom: CheerioRoot) => unknown
}

web-tools