@tenphi/akno-protocol 0.1.0

package/dist/ops/recall.d.ts

@@ -0,0 +1,531 @@
+import { z } from 'zod';
+export declare const RecallInput: z.ZodObject<{
+    query: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        lookup: "lookup";
+        question: "question";
+        explore: "explore";
+    }>>;
+    depth: z.ZodOptional<z.ZodEnum<{
+        summary: "summary";
+        lines: "lines";
+        full: "full";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    budget: z.ZodOptional<z.ZodNumber>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>>>;
+    expand: z.ZodOptional<z.ZodBoolean>;
+    graph: z.ZodOptional<z.ZodBoolean>;
+    rerank: z.ZodOptional<z.ZodBoolean>;
+    filter: z.ZodOptional<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>>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RecallInput = z.infer<typeof RecallInput>;
+export declare const RecallOutput: 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>;
+    results: z.ZodArray<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">>;
+    searched: z.ZodArray<z.ZodString>;
+    budget_used: z.ZodNumber;
+    scores: z.ZodEnum<{
+        absolute: "absolute";
+        relative: "relative";
+    }>;
+    qualification: z.ZodOptional<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>>;
+    coverage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    mode: z.ZodEnum<{
+        lookup: "lookup";
+        question: "question";
+        explore: "explore";
+    }>;
+}, z.core.$strip>;
+export type RecallOutput = z.infer<typeof RecallOutput>;
+//# sourceMappingURL=recall.d.ts.map

package/dist/ops/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/ops/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/ops/recall.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { DatePrefix, Depth, PageRole, RecallMode, RecallQualification, RecallResult, ResultEnvelope, SlugFilter, } from "../common.js";
+export const RecallInput = z.object({
+    query: z.string().min(1),
+    /** Inferred from the query when absent. Passing it explicitly always wins, and
+     *  getting it wrong costs relevance, never correctness. */
+    mode: RecallMode.optional(),
+    depth: Depth.optional(),
+    limit: z.number().int().positive().max(100).optional(),
+    /** Token budget for the assembled response. Whole cards are filled first. */
+    budget: z.number().int().positive().optional(),
+    /** `source` pages compete for relevance on equal terms and come back capped.
+     *  Passing `include: ['source']` with `depth: 'full'` overrides the cap —
+     *  role is a relevance policy, not access control. */
+    include: z.array(PageRole).optional(),
+    /**
+     * Skip query expansion for this call. Worth it when the query is already the text
+     * you want to match — routing a document by its own summary, say — where a model
+     * rewriting it costs a round trip and buys nothing.
+     */
+    expand: z.boolean().optional(),
+    /** Add exact, bounded evidence-graph candidates before ordinary reranking. */
+    graph: z.boolean().optional(),
+    /** Run the configured reranker and relevance qualifier. Defaults to true for recall. */
+    rerank: z.boolean().optional(),
+    filter: SlugFilter.optional(),
+    since: DatePrefix.optional(),
+    until: DatePrefix.optional(),
+});
+export const RecallOutput = ResultEnvelope.extend({
+    /** Authoritative mixed page/document results. Use `type` to select the variant. */
+    results: z.array(RecallResult),
+    /** Every query actually issued, including expansions. On `empty` this is the
+     *  proof — an agent can say "not recorded" because the layer showed its work. */
+    searched: z.array(z.string()),
+    budget_used: z.number().int().nonnegative(),
+    /**
+     * Whether `score` means anything on its own.
+     *
+     * `absolute` — a cross-encoder or the embedding arm supplied a real 0..1 relevance,
+     * and `relevance` is set on every card. Safe to threshold.
+     * `relative` — scores only order this result set. The top hit is 1.0 whether it is
+     * a perfect match or the least bad of a bad batch, so thresholding it is a mistake:
+     * every query appears to succeed.
+     */
+    scores: z.enum(['absolute', 'relative']),
+    /** Present when a reranker judged candidates, including when filtering was disabled or unavailable. */
+    qualification: RecallQualification.optional(),
+    /**
+     * `question` mode only. Which concepts from the question the results
+     * actually cover. Deterministic — did the key terms appear in what came back —
+     * not a model judging whether the answer is there. Closes the most common
+     * hallucination path: a page ranks first because it matches half the question,
+     * and the agent invents the other half.
+     */
+    coverage: z.record(z.string(), z.boolean()).optional(),
+    mode: RecallMode,
+});
+//# sourceMappingURL=recall.js.map

package/dist/ops/recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/ops/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,UAAU,EACV,KAAK,EACL,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB;+DAC2D;IAC3D,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACtD,6EAA6E;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C;;0DAEsD;IACtD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACrC;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,8EAA8E;IAC9E,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,wFAAwF;IACxF,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC;IAChD,mFAAmF;IACnF,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC9B;qFACiF;IACjF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C;;;;;;;;OAQG;IACH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxC,uGAAuG;IACvG,aAAa,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IAC7C;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,IAAI,EAAE,UAAU;CACjB,CAAC,CAAC"}