# @plurnk/plurnk-schemes-http — .env.defaults (operator config + defaults floor).
#
# Every knob this package reads, family-namespaced PLURNK_SCHEMES_HTTP_*. This
# file is the canonical value registry; {§http-config} owns policy. The daemon
# assembles every installed member's .env.defaults into one operative floor at
# boot, set-if-unset under the operator's env {§operator-config-env-defaults}.
# UNCOMMENTED keys are real defaults the floor sets. COMMENTED keys are modes
# whose ABSENCE is meaningful (unset = the documented behavior) — the floor
# must not set them. Standalone (no daemon), the required numerics fail hard
# when unset, naming the var.
#
# ── Required (acquisition path) ─────────────────────────────────────────────
# HTTP request timeout in ms.
PLURNK_SCHEMES_HTTP_FETCH_TIMEOUT=30000

# ── Defaults (floor-set; override to change) ────────────────────────────────
# Per-URL freshness TTL in ms: a re-read of a URL fetched within this window
# serves the stored copy with ZERO round-trips (no conditional GET). This makes
# a just-materialized web entry immediately readable like any other entry.
# 0 opts into revalidation on every read via ETag/304.
# Required read: unset crashes, naming the var.
PLURNK_SCHEMES_HTTP_TTL_MS=300000
# Max HTTP redirect hops automatic WebFetcher acquisition follows. Every hop is
# checked; 0 follows none. Required read: unset crashes, naming the var.
PLURNK_SCHEMES_HTTP_REDIRECTS=5
# Maximum buffered characters in one incomplete SSE line/event. Exceeding this
# bound terminates the remote stream instead of allowing unbounded memory growth.
PLURNK_SCHEMES_HTTP_SSE_MAX_BUFFER_CHARS=1048576
# Maximum characters retained from a caught fetch, extract, or transport
# diagnostic in a model-facing Problem detail. Complete errors remain in daemon
# diagnostics.
PLURNK_SCHEMES_HTTP_ERROR_DETAIL_LIMIT=512

# ── Optional modes (absence IS the mode — never floor-set) ──────────────────
# The documented third-party materializer showcase: install the
# @plurnk/plurnk-schemes-http-tavily plugin, then select it and provide its
# key. Absence (unset) of either keeps the installed HTML projection as the
# local floor; the plugin documents its own depth/timeout knobs.
# PLURNK_SCHEMES_HTTP_MATERIALIZER=tavily-extract
# TAVILY_API_KEY=...