KYE Governed Knowledge Assistant

Govern the knowledge assistant, not just the answer.

The KYE Governed Knowledge Assistant is the drop-in governance onramp for any document-QA / RAG assistant. A knowledge assistant retrieves passages and answers a question; KYE Protocol governs the act around it: it admits the retrieval, decides whether the assistant may answer, and proves the basis it answered from. Every reply seals into a signed evidence chain you can verify from public keys.

The honest scope: KYE Protocol governs whether the assistant's answer or downstream action may proceed and proves the basis it relied on; it does not judge whether the content is factually true. Truth of content is the assistant author's responsibility and the human reader's judgement.

1 · What this governs

The assistant answers. The protocol governs the answer as an act.

KYE Protocol binds the assistant to a purpose, checks admissibility, and proves the cited basis.

The kind of assistant this governs is a document-QA or retrieval-augmented system: a clinician asks about dosing, an analyst asks about a filing, and the assistant pulls passages from an approved corpus and replies with citations. Products in this category sit close to high-stakes decisions, so the question is not only "is the answer good?" but "was the assistant allowed to answer, and can the basis be replayed?"

KYE Protocol answers the second question. It binds the assistant to a purpose and scope, decides admissibility at the boundary, pins each retrieval call, packs the cited sources as evidence, and seals a replay-proof. The result is an act a regulator can re-derive, not a log they must trust.

2 · The end-to-end flow

A clinician asks a question — five governed steps.

Worked example: a clinician asks the assistant for anticoagulation dosing guidance in renal impairment. Each step below is a real envelope, validated against its existing protocol schema. No new schema was minted for this reference.

  1. Admit. The retrieval call crosses the MCP gateway. Only the allow-listed retriever is admitted.
  2. Decide. A Purpose-Permission verdict answers whether this assistant may retrieve, as a per-check reason list.
  3. Pin. The call is pinned by tool id, version, and input and output hashes.
  4. Evidence. An Evidence Pack binds the decision and each cited source as a signed signal.
  5. Replay-proof. A signed proof asserts the decision re-runs to the same result.

The full six-envelope sequence ships as canonical fixtures under public/examples/governed-knowledge-assistant/ — binding, admissibility, retrieval pin, evidence pack, replay-proof, and the completion ledger.

3 · The envelopes

Six existing schemas, assembled into one chain.

Each envelope validates against the protocol schema it reuses. No new schema was minted.

  • Governance binding — the assistant declares purpose, read-only scope, and its single retriever.
  • Admissibility decision — twelve per-check verdicts answer whether retrieval is allowed.
  • Tool-call pin — the retrieval call, fixed by version and input and output hashes.
  • Evidence pack — cited guideline and formulary passages as signed signals.
  • Replay-proof — the decision re-runs to a byte-equal result.
  • Completion ledger — the actual file reads and tool call, checked against the declared scope.
4 · The honest boundary

What the protocol does not do.

KYE Protocol governs the authority to answer; it never claims to judge the answer.

KYE Protocol does not build a retriever, index a corpus, or rank passages. It does not decide whether an answer is medically or factually correct — truth of content is the assistant author's responsibility and the human reader's judgement.

What the protocol governs is narrower and provable: whether the assistant may answer or act, and the cited basis it answered from, captured as admissible evidence. A retrieval-quality signal can feed the decision; it does not replace it.

5 · Verify it yourself

Provable from public keys alone.

Every signed envelope in the chain verifies against the published key set at trust/self-audit-jwks.json — the same Ed25519 verification surface the protocol uses to audit itself. No credentials, no vendor portal: parse the JSON, canonicalise the payload, and check the signature. The self-audit page walks the verifier step by step.

Drop-in onramp

Wrap your RAG answer in a dozen lines.

Keep your retriever and your model. Add KYE Protocol at the answer boundary.

Ask decide() whether the answer may proceed and under whose authority, then seal the cited basis as an Evidence Pack — verifiable from public keys alone. The free tier runs client-side. The canonical snippets are kye:snippet:govern-rag-ts and kye:snippet:govern-rag-py.

// TypeScript — npm install @kye/sdk
import { KyeClient } from "@kye/sdk";

const kye = new KyeClient({ apiKey: process.env.KYE_API_KEY });

// Your RAG pipeline stays as-is; KYE governs the answer as an act.
export async function answer(question: string, principal: string) {
  const sources = await retrieve(question);
  const decision = await kye.decide({
    purpose: "knowledge.assistant.answer",
    principal,
    inputs: { question, source_ids: sources.map((s) => s.id) },
  });
  if (decision.effect !== "permit") return decision.refusal;

  const draft = await generate(question, sources);
  await kye.evidence.pack(decision.context_seal, { answer: draft, sources });
  return draft;
}

Python parity ships as kye:snippet:govern-rag-py via pip install kye-sdk. KYE Protocol never sees your corpus or your model output beyond the source_ids you pass it — it governs whether the answer may proceed, not whether it is true (§63 / §31).

Govern every answer your assistant gives.

The Governed Knowledge Assistant is a governance projection of KYE Protocol™. It reuses Governed Prompts, the KYE Protocol™ MCP Server, and the Evidence Pack — no new engine.