# --- @plurnk/plurnk-execs-search : web search via a SearXNG instance ---
# Only SEARXNG_URL is required; every other knob is optional and UNSET means the
# documented fallback, never a baked default. Values below are illustrative and
# commented — uncomment and set only what you want to override. These comments
# ARE the operator docs.

# Base URL of the SearXNG instance. REQUIRED — unset ⇒ search is unavailable
# (probe() reports it). An empty value counts as set, so keep this commented
# until it holds a real URL. HTTP Basic credentials may use standard URL
# userinfo (`https://KEY@host`); credentials are stripped from diagnostics.
# PLURNK_EXECS_SEARCH_SEARXNG_URL=http://127.0.0.1:8888

# Result language. Unset ⇒ the instance's own default.
# PLURNK_EXECS_SEARCH_LANGUAGE=en

# Comma-separated exclusive SearXNG engine selection. When set, this replaces
# the runtime category; unset ⇒ the runtime's SearXNG category.
# PLURNK_EXECS_SEARCH_ENGINES=engine-a,engine-b

# Client-side candidate cap. The portable default bounds acquisition and model
# chooser volume; operators may override it.
PLURNK_EXECS_SEARCH_LIMIT=12

# Per-query deadline in ms. Unset ⇒ the consumer's abort signal is the only deadline.
# PLURNK_EXECS_SEARCH_TIMEOUT=10000

# SafeSearch level: 0 off | 1 moderate | 2 strict. Unset ⇒ the instance's default.
# PLURNK_EXECS_SEARCH_SAFESEARCH=1

# Max characters per result snippet. Unset ⇒ unbounded.
# PLURNK_EXECS_SEARCH_SNIPPET=500

# Max query characters included in error facts.
PLURNK_EXECS_SEARCH_QUERY_PREVIEW=120

# Truthy ⇒ emit the verbatim SearXNG payload, bypassing the digest (debug only).
# PLURNK_EXECS_SEARCH_RAW=1

# Note: the page-fetch knobs (timeout, redirects) moved to the consumer with the
# fetch — the executor never fetches result pages ({§executor-entry-sink}).
# schemes-http owns the prefetch and its own PLURNK_SCHEMES_HTTP_* knobs.