dsh-plugin-verified-search

The inherited web_search tool in a DeepSeek Harness agent is an opaque black box: source scope is uncontrolled, citation evidence is unauditable, JSON parsing relies on model guessing, and answer gaps are silently filled from memory. dsh-plugin-verified-search replaces that inherited behavior with a set of bounded, explicit workflows that make the source allowlist, retained excerpts, deterministic selection logic, and unresolved gaps all visible after every retrieval. When something cannot be confirmed, the plugin reports an explicit unresolved gap rather than fabricating an answer.

The plugin exposes five layered tools: verified_search performs a single mutable-fact lookup with hostname post-filtering; verified_research handles multi-entity, multi-claim research with per-claim retained excerpts and retrieval metadata; verified_json_selection runs strict RFC 6901 pointer traversal with date cutoffs over official JSON feeds; verified_json_numeric_extrema extracts exact numeric maxima or minima using source-lexeme comparison to avoid floating-point drift; verified_json_projection yields every strictly matching row in source order. The stable v0.1.1 release ships verified_search only; the remaining four tools live in a pinned experimental snapshot.

Ideal for agent-workflow developers who need an auditable evidence chain, teams with hard compliance requirements on citation integrity, and automation scenarios that must extract precise data from official JSON endpoints without delegating that step to free-form model reasoning. The plugin enforces postconditions on retrieved structured sources but does not certify publisher truth, index freshness, or semantic entailment; it is a verifiable retrieval-boundary layer, not a fact-checking oracle.