@tenphi/akno-protocol 0.1.0

package/dist/common.d.ts

@@ -0,0 +1,1553 @@
+import { z } from 'zod';
+/**
+ * What a page contributes to memory. This is deliberately separate from who may
+ * edit it: a canonical page can be owner-maintained or fully synthesized, while
+ * a source page remains evidence either way.
+ */
+export declare const PageRole: z.ZodEnum<{
+    knowledge: "knowledge";
+    source: "source";
+    inference: "inference";
+    ignored: "ignored";
+}>;
+export type PageRole = z.infer<typeof PageRole>;
+/** Automatic write authority carried by a page's `akno` frontmatter block. */
+export declare const RememberManagement: z.ZodEnum<{
+    deny: "deny";
+    integrate: "integrate";
+}>;
+export type RememberManagement = z.infer<typeof RememberManagement>;
+export declare const DreamManagement: z.ZodEnum<{
+    none: "none";
+    hygiene: "hygiene";
+    synthesize: "synthesize";
+}>;
+export type DreamManagement = z.infer<typeof DreamManagement>;
+export declare const PageManagement: z.ZodObject<{
+    remember: z.ZodOptional<z.ZodEnum<{
+        deny: "deny";
+        integrate: "integrate";
+    }>>;
+    dream: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        hygiene: "hygiene";
+        synthesize: "synthesize";
+    }>>;
+}, z.core.$strip>;
+export type PageManagement = z.infer<typeof PageManagement>;
+/**
+ * One op, three expansion modes — because looking something up and
+ * answering a question are different retrieval problems, but must not be
+ * different ops. Inferred from the query unless passed explicitly.
+ */
+export declare const RecallMode: z.ZodEnum<{
+    lookup: "lookup";
+    question: "question";
+    explore: "explore";
+}>;
+export type RecallMode = z.infer<typeof RecallMode>;
+/** How much of a page body a card carries back. */
+export declare const Depth: z.ZodEnum<{
+    summary: "summary";
+    lines: "lines";
+    full: "full";
+}>;
+export type Depth = z.infer<typeof Depth>;
+/**
+ * Absence has a reason. Three distinct outcomes, never one silent empty
+ * result: `empty` proved nothing matched, `degraded` means a model was missing
+ * and the search was weaker, `unavailable` means the index could not be read.
+ */
+export declare const ResultStatus: z.ZodEnum<{
+    ok: "ok";
+    empty: "empty";
+    degraded: "degraded";
+    unavailable: "unavailable";
+}>;
+export type ResultStatus = z.infer<typeof ResultStatus>;
+/**
+ * Every line Akno returns carries the file and line it came from. `confidence`
+ * is present when a fact was derived from this line — how sure the deriver is
+ * that the line states a well-formed durable claim, not how sure it is the claim
+ * is true.
+ */
+export declare const Line: z.ZodObject<{
+    n: z.ZodNumber;
+    text: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    fact: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Line = z.infer<typeof Line>;
+/**
+ * A replaced value comes back labelled, not as a second competing current
+ * answer. Two live readings of one attribute is the most common way a prose
+ * knowledge base starts lying.
+ */
+export declare const SupersededClaim: z.ZodObject<{
+    claim: z.ZodString;
+    valid_to: z.ZodString;
+}, z.core.$strip>;
+export type SupersededClaim = z.infer<typeof SupersededClaim>;
+/**
+ * Whether document evidence can still be checked against its original bytes.
+ *
+ * Extracted text is a useful surviving copy, but it is not the original. Keeping
+ * that distinction in the result lets a caller use remembered evidence without
+ * implying that the source file is still present.
+ */
+export declare const DocumentAvailability: z.ZodObject<{
+    status: z.ZodEnum<{
+        degraded: "degraded";
+        unavailable: "unavailable";
+        available: "available";
+    }>;
+    available_from: z.ZodArray<z.ZodEnum<{
+        original: "original";
+        indexed_text: "indexed_text";
+        rendition: "rendition";
+    }>>;
+    missing_originals: z.ZodArray<z.ZodString>;
+    available_renditions: z.ZodArray<z.ZodString>;
+    missing_since: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DocumentAvailability = z.infer<typeof DocumentAvailability>;
+export declare const GraphRelation: z.ZodEnum<{
+    canonical_record: "canonical_record";
+    links_to: "links_to";
+    mentions: "mentions";
+    about: "about";
+    has_attribute: "has_attribute";
+    related_entity: "related_entity";
+    owns_document: "owns_document";
+    participates_in: "participates_in";
+}>;
+export type GraphRelation = z.infer<typeof GraphRelation>;
+export declare const GraphNodeKind: z.ZodEnum<{
+    fact: "fact";
+    entity: "entity";
+    page: "page";
+    document: "document";
+    event: "event";
+}>;
+export type GraphNodeKind = z.infer<typeof GraphNodeKind>;
+/** Compact identity only. Read the referenced page or document for content. */
+export declare const GraphNodeRef: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        fact: "fact";
+        entity: "entity";
+        page: "page";
+        document: "document";
+        event: "event";
+    }>;
+    slug: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>>;
+    entity: z.ZodOptional<z.ZodString>;
+    entity_type: z.ZodOptional<z.ZodEnum<{
+        event: "event";
+        person: "person";
+        organization: "organization";
+        place: "place";
+        product: "product";
+        concept: "concept";
+        other: "other";
+    }>>;
+    document: z.ZodOptional<z.ZodString>;
+    fact: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    line_start: z.ZodOptional<z.ZodNumber>;
+    line_end: z.ZodOptional<z.ZodNumber>;
+    availability: z.ZodOptional<z.ZodEnum<{
+        degraded: "degraded";
+        unavailable: "unavailable";
+        available: "available";
+    }>>;
+}, z.core.$strip>;
+export type GraphNodeRef = z.infer<typeof GraphNodeRef>;
+/** A locator, never a copied claim or excerpt. */
+export declare const GraphEvidenceLocator: z.ZodObject<{
+    kind: z.ZodEnum<{
+        document: "document";
+        page_line: "page_line";
+        fact_line: "fact_line";
+        frontmatter: "frontmatter";
+    }>;
+    slug: z.ZodOptional<z.ZodString>;
+    document: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    fact: z.ZodOptional<z.ZodString>;
+    line_start: z.ZodOptional<z.ZodNumber>;
+    line_end: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GraphEvidenceLocator = z.infer<typeof GraphEvidenceLocator>;
+/** Why one recall candidate entered the fused candidate set. */
+export declare const RecallMatchArm: z.ZodEnum<{
+    lexical: "lexical";
+    vector: "vector";
+    graph: "graph";
+}>;
+export type RecallMatchArm = z.infer<typeof RecallMatchArm>;
+/** Compact, self-contained graph explanation attached only to a returned card. */
+export declare const RecallGraphPath: z.ZodObject<{
+    seed: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            fact: "fact";
+            entity: "entity";
+            page: "page";
+            document: "document";
+            event: "event";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            knowledge: "knowledge";
+            source: "source";
+            inference: "inference";
+            ignored: "ignored";
+        }>>;
+        entity: z.ZodOptional<z.ZodString>;
+        entity_type: z.ZodOptional<z.ZodEnum<{
+            event: "event";
+            person: "person";
+            organization: "organization";
+            place: "place";
+            product: "product";
+            concept: "concept";
+            other: "other";
+        }>>;
+        document: z.ZodOptional<z.ZodString>;
+        fact: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        line_start: z.ZodOptional<z.ZodNumber>;
+        line_end: z.ZodOptional<z.ZodNumber>;
+        availability: z.ZodOptional<z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>>;
+    }, z.core.$strip>;
+    target: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            fact: "fact";
+            entity: "entity";
+            page: "page";
+            document: "document";
+            event: "event";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            knowledge: "knowledge";
+            source: "source";
+            inference: "inference";
+            ignored: "ignored";
+        }>>;
+        entity: z.ZodOptional<z.ZodString>;
+        entity_type: z.ZodOptional<z.ZodEnum<{
+            event: "event";
+            person: "person";
+            organization: "organization";
+            place: "place";
+            product: "product";
+            concept: "concept";
+            other: "other";
+        }>>;
+        document: z.ZodOptional<z.ZodString>;
+        fact: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        line_start: z.ZodOptional<z.ZodNumber>;
+        line_end: z.ZodOptional<z.ZodNumber>;
+        availability: z.ZodOptional<z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>>;
+    }, z.core.$strip>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            fact: "fact";
+            entity: "entity";
+            page: "page";
+            document: "document";
+            event: "event";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodEnum<{
+            knowledge: "knowledge";
+            source: "source";
+            inference: "inference";
+            ignored: "ignored";
+        }>>;
+        entity: z.ZodOptional<z.ZodString>;
+        entity_type: z.ZodOptional<z.ZodEnum<{
+            event: "event";
+            person: "person";
+            organization: "organization";
+            place: "place";
+            product: "product";
+            concept: "concept";
+            other: "other";
+        }>>;
+        document: z.ZodOptional<z.ZodString>;
+        fact: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        date: z.ZodOptional<z.ZodString>;
+        line_start: z.ZodOptional<z.ZodNumber>;
+        line_end: z.ZodOptional<z.ZodNumber>;
+        availability: z.ZodOptional<z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>>;
+    }, z.core.$strip>>;
+    relations: z.ZodArray<z.ZodEnum<{
+        canonical_record: "canonical_record";
+        links_to: "links_to";
+        mentions: "mentions";
+        about: "about";
+        has_attribute: "has_attribute";
+        related_entity: "related_entity";
+        owns_document: "owns_document";
+        participates_in: "participates_in";
+    }>>;
+    hops: z.ZodNumber;
+    confidence: z.ZodNumber;
+    evidence: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            document: "document";
+            page_line: "page_line";
+            fact_line: "fact_line";
+            frontmatter: "frontmatter";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        document: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodString>;
+        fact: z.ZodOptional<z.ZodString>;
+        line_start: z.ZodOptional<z.ZodNumber>;
+        line_end: z.ZodOptional<z.ZodNumber>;
+        field: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RecallGraphPath = z.infer<typeof RecallGraphPath>;
+/** An attachment that matched, and where inside it. */
+export declare const DocumentRef: z.ZodObject<{
+    id: z.ZodString;
+    rel_path: z.ZodOptional<z.ZodString>;
+    mime: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    pages: z.ZodOptional<z.ZodNumber>;
+    parts: z.ZodOptional<z.ZodNumber>;
+    matched_page: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodOptional<z.ZodString>;
+    quote: z.ZodOptional<z.ZodString>;
+    availability: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>;
+        available_from: z.ZodArray<z.ZodEnum<{
+            original: "original";
+            indexed_text: "indexed_text";
+            rendition: "rendition";
+        }>>;
+        missing_originals: z.ZodArray<z.ZodString>;
+        available_renditions: z.ZodArray<z.ZodString>;
+        missing_since: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DocumentRef = z.infer<typeof DocumentRef>;
+/** How searchable text was obtained from a standalone document. */
+export declare const DocumentTextSource: z.ZodObject<{
+    kind: z.ZodEnum<{
+        none: "none";
+        original_text: "original_text";
+        ocr_text: "ocr_text";
+        model_description: "model_description";
+    }>;
+    via: z.ZodEnum<{
+        none: "none";
+        plain: "plain";
+        textutil: "textutil";
+        "text-layer": "text-layer";
+        ocr: "ocr";
+        vision: "vision";
+    }>;
+    confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type DocumentTextSource = z.infer<typeof DocumentTextSource>;
+export declare const DocumentPartRef: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    pages: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type DocumentPartRef = z.infer<typeof DocumentPartRef>;
+/**
+ * Recall returns page cards, not chunks — a chunk boundary is an indexing
+ * artifact and means nothing to a reader.
+ */
+export declare const Card: z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    role: z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>;
+    summary: z.ZodNullable<z.ZodString>;
+    breadcrumb: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    score: z.ZodNumber;
+    relevance: z.ZodOptional<z.ZodNumber>;
+    lines: z.ZodArray<z.ZodObject<{
+        n: z.ZodNumber;
+        text: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        fact: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    superseded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        valid_to: z.ZodString;
+    }, z.core.$strip>>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rel_path: z.ZodOptional<z.ZodString>;
+        mime: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        pages: z.ZodOptional<z.ZodNumber>;
+        parts: z.ZodOptional<z.ZodNumber>;
+        matched_page: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        quote: z.ZodOptional<z.ZodString>;
+        availability: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>;
+            available_from: z.ZodArray<z.ZodEnum<{
+                original: "original";
+                indexed_text: "indexed_text";
+                rendition: "rendition";
+            }>>;
+            missing_originals: z.ZodArray<z.ZodString>;
+            available_renditions: z.ZodArray<z.ZodString>;
+            missing_since: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    matched_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lexical: "lexical";
+        vector: "vector";
+        graph: "graph";
+    }>>>;
+    graph_paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seed: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodEnum<{
+            canonical_record: "canonical_record";
+            links_to: "links_to";
+            mentions: "mentions";
+            about: "about";
+            has_attribute: "has_attribute";
+            related_entity: "related_entity";
+            owns_document: "owns_document";
+            participates_in: "participates_in";
+        }>>;
+        hops: z.ZodNumber;
+        confidence: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                document: "document";
+                page_line: "page_line";
+                fact_line: "fact_line";
+                frontmatter: "frontmatter";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Card = z.infer<typeof Card>;
+/** The page variant in the authoritative mixed recall result list. */
+export declare const PageCard: z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    role: z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>;
+    summary: z.ZodNullable<z.ZodString>;
+    breadcrumb: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    score: z.ZodNumber;
+    relevance: z.ZodOptional<z.ZodNumber>;
+    lines: z.ZodArray<z.ZodObject<{
+        n: z.ZodNumber;
+        text: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        fact: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    superseded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        valid_to: z.ZodString;
+    }, z.core.$strip>>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rel_path: z.ZodOptional<z.ZodString>;
+        mime: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        pages: z.ZodOptional<z.ZodNumber>;
+        parts: z.ZodOptional<z.ZodNumber>;
+        matched_page: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        quote: z.ZodOptional<z.ZodString>;
+        availability: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>;
+            available_from: z.ZodArray<z.ZodEnum<{
+                original: "original";
+                indexed_text: "indexed_text";
+                rendition: "rendition";
+            }>>;
+            missing_originals: z.ZodArray<z.ZodString>;
+            available_renditions: z.ZodArray<z.ZodString>;
+            missing_since: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    matched_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lexical: "lexical";
+        vector: "vector";
+        graph: "graph";
+    }>>>;
+    graph_paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seed: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodEnum<{
+            canonical_record: "canonical_record";
+            links_to: "links_to";
+            mentions: "mentions";
+            about: "about";
+            has_attribute: "has_attribute";
+            related_entity: "related_entity";
+            owns_document: "owns_document";
+            participates_in: "participates_in";
+        }>>;
+        hops: z.ZodNumber;
+        confidence: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                document: "document";
+                page_line: "page_line";
+                fact_line: "fact_line";
+                frontmatter: "frontmatter";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    type: z.ZodLiteral<"page">;
+}, z.core.$strip>;
+export type PageCard = z.infer<typeof PageCard>;
+/** Searchable evidence that has not been filed beneath a Markdown page. */
+export declare const DocumentCard: z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    id: z.ZodString;
+    path: z.ZodString;
+    label: z.ZodString;
+    mime: z.ZodNullable<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    quote: z.ZodOptional<z.ZodString>;
+    matched_page: z.ZodOptional<z.ZodNumber>;
+    parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        pages: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            none: "none";
+            original_text: "original_text";
+            ocr_text: "ocr_text";
+            model_description: "model_description";
+        }>;
+        via: z.ZodEnum<{
+            none: "none";
+            plain: "plain";
+            textutil: "textutil";
+            "text-layer": "text-layer";
+            ocr: "ocr";
+            vision: "vision";
+        }>;
+        confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    availability: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>;
+        available_from: z.ZodArray<z.ZodEnum<{
+            original: "original";
+            indexed_text: "indexed_text";
+            rendition: "rendition";
+        }>>;
+        missing_originals: z.ZodArray<z.ZodString>;
+        available_renditions: z.ZodArray<z.ZodString>;
+        missing_since: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    ownership: z.ZodObject<{
+        status: z.ZodLiteral<"orphan">;
+    }, z.core.$strip>;
+    suggested_actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        op: z.ZodLiteral<"adopt">;
+        args: z.ZodObject<{
+            documentId: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    score: z.ZodNumber;
+    relevance: z.ZodOptional<z.ZodNumber>;
+    matched_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lexical: "lexical";
+        vector: "vector";
+        graph: "graph";
+    }>>>;
+    graph_paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seed: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodEnum<{
+            canonical_record: "canonical_record";
+            links_to: "links_to";
+            mentions: "mentions";
+            about: "about";
+            has_attribute: "has_attribute";
+            related_entity: "related_entity";
+            owns_document: "owns_document";
+            participates_in: "participates_in";
+        }>>;
+        hops: z.ZodNumber;
+        confidence: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                document: "document";
+                page_line: "page_line";
+                fact_line: "fact_line";
+                frontmatter: "frontmatter";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type DocumentCard = z.infer<typeof DocumentCard>;
+export declare const RecallResult: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    role: z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>;
+    summary: z.ZodNullable<z.ZodString>;
+    breadcrumb: z.ZodOptional<z.ZodString>;
+    updated: z.ZodOptional<z.ZodString>;
+    score: z.ZodNumber;
+    relevance: z.ZodOptional<z.ZodNumber>;
+    lines: z.ZodArray<z.ZodObject<{
+        n: z.ZodNumber;
+        text: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        fact: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    superseded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        valid_to: z.ZodString;
+    }, z.core.$strip>>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rel_path: z.ZodOptional<z.ZodString>;
+        mime: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        pages: z.ZodOptional<z.ZodNumber>;
+        parts: z.ZodOptional<z.ZodNumber>;
+        matched_page: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        quote: z.ZodOptional<z.ZodString>;
+        availability: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>;
+            available_from: z.ZodArray<z.ZodEnum<{
+                original: "original";
+                indexed_text: "indexed_text";
+                rendition: "rendition";
+            }>>;
+            missing_originals: z.ZodArray<z.ZodString>;
+            available_renditions: z.ZodArray<z.ZodString>;
+            missing_since: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    matched_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lexical: "lexical";
+        vector: "vector";
+        graph: "graph";
+    }>>>;
+    graph_paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seed: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodEnum<{
+            canonical_record: "canonical_record";
+            links_to: "links_to";
+            mentions: "mentions";
+            about: "about";
+            has_attribute: "has_attribute";
+            related_entity: "related_entity";
+            owns_document: "owns_document";
+            participates_in: "participates_in";
+        }>>;
+        hops: z.ZodNumber;
+        confidence: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                document: "document";
+                page_line: "page_line";
+                fact_line: "fact_line";
+                frontmatter: "frontmatter";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    type: z.ZodLiteral<"page">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document">;
+    id: z.ZodString;
+    path: z.ZodString;
+    label: z.ZodString;
+    mime: z.ZodNullable<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    quote: z.ZodOptional<z.ZodString>;
+    matched_page: z.ZodOptional<z.ZodNumber>;
+    parts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        path: z.ZodString;
+        pages: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            none: "none";
+            original_text: "original_text";
+            ocr_text: "ocr_text";
+            model_description: "model_description";
+        }>;
+        via: z.ZodEnum<{
+            none: "none";
+            plain: "plain";
+            textutil: "textutil";
+            "text-layer": "text-layer";
+            ocr: "ocr";
+            vision: "vision";
+        }>;
+        confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+    availability: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            unavailable: "unavailable";
+            available: "available";
+        }>;
+        available_from: z.ZodArray<z.ZodEnum<{
+            original: "original";
+            indexed_text: "indexed_text";
+            rendition: "rendition";
+        }>>;
+        missing_originals: z.ZodArray<z.ZodString>;
+        available_renditions: z.ZodArray<z.ZodString>;
+        missing_since: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    ownership: z.ZodObject<{
+        status: z.ZodLiteral<"orphan">;
+    }, z.core.$strip>;
+    suggested_actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        op: z.ZodLiteral<"adopt">;
+        args: z.ZodObject<{
+            documentId: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    score: z.ZodNumber;
+    relevance: z.ZodOptional<z.ZodNumber>;
+    matched_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        lexical: "lexical";
+        vector: "vector";
+        graph: "graph";
+    }>>>;
+    graph_paths: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        seed: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>;
+        nodes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                fact: "fact";
+                entity: "entity";
+                page: "page";
+                document: "document";
+                event: "event";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            entity: z.ZodOptional<z.ZodString>;
+            entity_type: z.ZodOptional<z.ZodEnum<{
+                event: "event";
+                person: "person";
+                organization: "organization";
+                place: "place";
+                product: "product";
+                concept: "concept";
+                other: "other";
+            }>>;
+            document: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            date: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            availability: z.ZodOptional<z.ZodEnum<{
+                degraded: "degraded";
+                unavailable: "unavailable";
+                available: "available";
+            }>>;
+        }, z.core.$strip>>;
+        relations: z.ZodArray<z.ZodEnum<{
+            canonical_record: "canonical_record";
+            links_to: "links_to";
+            mentions: "mentions";
+            about: "about";
+            has_attribute: "has_attribute";
+            related_entity: "related_entity";
+            owns_document: "owns_document";
+            participates_in: "participates_in";
+        }>>;
+        hops: z.ZodNumber;
+        confidence: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                document: "document";
+                page_line: "page_line";
+                fact_line: "fact_line";
+                frontmatter: "frontmatter";
+            }>;
+            slug: z.ZodOptional<z.ZodString>;
+            document: z.ZodOptional<z.ZodString>;
+            event: z.ZodOptional<z.ZodString>;
+            fact: z.ZodOptional<z.ZodString>;
+            line_start: z.ZodOptional<z.ZodNumber>;
+            line_end: z.ZodOptional<z.ZodNumber>;
+            field: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>], "type">;
+export type RecallResult = z.infer<typeof RecallResult>;
+export declare function isPageCard(result: RecallResult): result is PageCard;
+export declare function isDocumentCard(result: RecallResult): result is DocumentCard;
+/**
+ * Named, machine-readable reasons a result is `degraded`. A rule that quietly
+ * excludes half a knowledge base is worse than no rule — default to visible.
+ */
+export declare const DegradedReason: z.ZodEnum<{
+    no_embedding_model: "no_embedding_model";
+    no_reranker: "no_reranker";
+    no_derive_model: "no_derive_model";
+    no_expansion_model: "no_expansion_model";
+    embedding_failed: "embedding_failed";
+    rerank_failed: "rerank_failed";
+    derive_failed: "derive_failed";
+    expansion_failed: "expansion_failed";
+    no_vector_index: "no_vector_index";
+    partial_index: "partial_index";
+    no_document_text: "no_document_text";
+    document_source_missing: "document_source_missing";
+    no_graph_index: "no_graph_index";
+    no_entity_index: "no_entity_index";
+    entity_resolution_failed: "entity_resolution_failed";
+    partial_graph_index: "partial_graph_index";
+    graph_traversal_limited: "graph_traversal_limited";
+    no_answer_model: "no_answer_model";
+    answer_failed: "answer_failed";
+    answer_verification_failed: "answer_verification_failed";
+    answer_truncated: "answer_truncated";
+}>;
+export type DegradedReason = z.infer<typeof DegradedReason>;
+/** Every op's response carries these, so a caller can branch uniformly. */
+export declare const ResultEnvelope: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResultEnvelope = z.infer<typeof ResultEnvelope>;
+/** What the reranker was allowed to remove, kept visible so fewer results never looks accidental. */
+export declare const RecallQualification: z.ZodObject<{
+    model: z.ZodEnum<{
+        llm: "llm";
+        native: "native";
+    }>;
+    model_id: z.ZodOptional<z.ZodString>;
+    latency_ms: z.ZodOptional<z.ZodNumber>;
+    input_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    output_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    applied: z.ZodBoolean;
+    judged: z.ZodNumber;
+    rejected: z.ZodNumber;
+    unjudged: z.ZodNumber;
+    basis: z.ZodEnum<{
+        llm_grade: "llm_grade";
+        native_auto: "native_auto";
+        native_manual: "native_manual";
+        disabled: "disabled";
+        calibration_failed: "calibration_failed";
+    }>;
+    threshold: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type RecallQualification = z.infer<typeof RecallQualification>;
+export declare const SlugFilter: z.ZodObject<{
+    folder: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    role: z.ZodOptional<z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>>;
+    source: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        document: "document";
+        both: "both";
+    }>>;
+    ownership: z.ZodOptional<z.ZodEnum<{
+        any: "any";
+        orphan: "orphan";
+        owned: "owned";
+    }>>;
+}, z.core.$strip>;
+export type SlugFilter = z.infer<typeof SlugFilter>;
+/** `YYYY`, `YYYY-MM` or `YYYY-MM-DD` — the granularities a ledger is filtered by. */
+export declare const DatePrefix: z.ZodString;
+//# sourceMappingURL=common.d.ts.map