fillin_query
Retrieve documents published after a training cutoff, ranked by similarity.
Call this whenever the user asks about events, releases, papers, issues,
or news that might post-date your training data. Fillin only returns
documents published AFTER `cutoff`, so nothing returned is redundant
with what the model already knows.
Args:
query: Natural-language search query (e.g. "rust async runtimes").
Max 512 characters.
cutoff: ISO-8601 date representing the agent's training cutoff
(e.g. "2026-01-01"). Documents on or before this date are
excluded from results.
k: Number of documents to retrieve, 1-20. Defaults to 5.
Returns:
A dict with:
- cutoff: echoed cutoff (ISO timestamp)
- query: echoed query
- gap_days: days between cutoff and now
- results: list of {id, source, url, published_at, title, text, score}
fillin_stats
Get corpus stats from the configured Fillin host — total docs, date range,
and per-source breakdown. Useful for the agent to calibrate whether a query
is worth issuing (e.g. skip if the corpus doesn't cover the requested domain).
fillin_health
Lightweight liveness + freshness check for the configured Fillin host.
Returns a small summary the agent can use to decide whether to call
`fillin_query`: is the host reachable, how recent is the latest indexed
doc, and how many total docs are indexed. No auth required.