docs(skill): troubleshoot stale web_extract pages — cache carveouts + cache_exempt_hosts

Adds a 'web_extract shows a stale page' section to the bundled
hermes-agent skill's troubleshooting reference: the 20-minute TTL
symptom, the automatic never-cache carveouts (localhost/private/LAN,
website_blocklist, rescue/failed responses), the web.cache_exempt_hosts
recipe for staging/tunnel sites, and the TTL/disable fallbacks.
This commit is contained in:
Teknium
2026-08-25 04:00:37 -07:00
parent ba9fc55e16
commit 1bbb6e5bce

View File

@@ -21,6 +21,33 @@
- **Config changes:** In gateway: `/restart`. In CLI: exit and relaunch.
- **Code changes:** Restart the CLI or gateway process
### web_extract shows a stale page (result caching)
`web_search`/`web_extract` cache results for 20 minutes (PR #94618) — a
repeat fetch of the same URL within the TTL is served from cache, which
can look like "my website changes aren't showing up."
Automatic carveouts (always fetched live, never cached):
- localhost / 127.0.0.1 / `*.local` / `*.localhost` / single-label LAN
hostnames / private + link-local IP ranges (dev servers, hot-reload
builds, chat-GUI artifact previews)
- URLs matched by `security.website_blocklist`
- failed responses and keyless-rescue-served responses
Developing a site tested over the PUBLIC internet (Vercel/Netlify
preview, ngrok/cloudflared tunnel, staging domain)? Public DNS isn't
auto-carved-out — list the host in config.yaml:
```yaml
web:
cache_exempt_hosts: # always fetched live; effective immediately
- mysite.vercel.app
- "*.ngrok-free.app"
- mysite.dev # suffix match: also covers preview.mysite.dev
```
Blunt instruments: `web.cache_ttl_minutes: 1` (min) or
`web.cache_enabled: false` disables both caches entirely.
### Skills not showing
1. `hermes skills list` — verify installed
2. `hermes skills config` — check platform enablement