ColdState — Deterministic Knowledge Infrastructure

Search a ColdState index by collection name or index ID. Returns ranked results with Ψ scores and state classification (CRYSTALLINE/FLUID/REACTIVE/DECOHERENT). Provide exactly one of `collection` or `index_id`.

List all your ColdState indexes with their status, mode, document count, and domain preset.

Browse documents in a ColdState index. Indexes are zero-knowledge, so each document is returned as your ref_id plus its state classification and E-score — no stored text. Map ref_id back to your own content.

Explain why a specific document ranked for a query. Returns a per-term relevance breakdown and an overall match summary — deterministic and reproducible.

Search ColdState's global knowledge base (48.4M+ entries across 35 domains including SCIENCE, MEDICINE, TECHNOLOGY, HISTORY, etc). Returns deterministically ranked results with Ψ relevance scores and a state classification. Optionally filter by domain.

List all available knowledge domains in ColdState's global knowledge base with entry counts.

Fetch a single knowledge-base entry verbatim by its stable id (e.g. "eng_000229f438f7cebd"). Deterministic retrieval — returns the full record plus a content_hash and kb_snapshot for reproducible citation.

Get a canonical, reproducible citation for a knowledge entry by id (title, domain, source, content_hash, kb_snapshot). Cite a fact so it can be re-verified later with coldstate_verify.

Verify a previously-cited knowledge fact is unchanged. Provide the entry id and the content_hash you stored earlier; returns whether it still matches the current knowledge base. The trust primitive for AI-to-AI fact-checking.

Get the current knowledge-base snapshot/version id. Pin this kb_snapshot for reproducibility: the same query against the same kb_snapshot returns identical results.

Find knowledge entries deterministically related to a given entry id via ColdState's concept-cluster graph. Returns same-cluster and neighboring-cluster entries, each tagged with its relation and a cross_domain flag. Same id ⇒ same neighbors.

Resolve a name, alias, or surface form to its canonical ColdState knowledge entry (id + title). Deterministic: an exact title match wins, else the top relevance-Ψ entry. Returns the canonical entry plus alternatives. Use the returned id with coldstate_fetch / coldstate_related.

Run several knowledge-base queries in one call against a single consistent kb_snapshot. Returns each query with its ranked results — efficient and snapshot-consistent across the whole batch.

Deterministic statistics. With a `query`: total matches + state distribution of the top results. Without: global knowledge-base stats (entry count, domains, snapshot).

Machine-readable manifest of this server: available tools, knowledge domains, current kb_snapshot, determinism guarantees, and limits. Call this first to self-configure.

Cross-domain structural analog: given a knowledge entry id, find its closest structural twin in each OTHER domain ("same structure, different domain"). Deterministic. Use coldstate_resolve to turn a name into an id first.