/**
 * Retrieval context packets and evidence adapters.
 *
 * Retrieval results are treated strictly as bounded evidence candidates, never
 * as authority. Every result carries an addressable evidence id, provenance
 * (index generation + content hash + path + line range), freshness, and
 * contributing score signals.
 */
import type { RetrievalContextPacket, WorkspaceRetrievalResult } from "./types.js";
export interface RetrievalEvidenceRecord {
    evidenceId: string;
    kind: "workspace_retrieval";
    workspaceId: string;
    indexGenerationId: string;
    filePath: string;
    contentSha256: string;
    lines: {
        startLine: number;
        endLine: number;
    };
    chunkId: string;
    symbol?: {
        name: string;
        qualifiedName?: string;
        kind?: string;
    };
    score: WorkspaceRetrievalResult["score"];
    freshness: WorkspaceRetrievalResult["freshness"];
    snippet: string;
    truncated: boolean;
}
/** Build an addressable evidence record from a retrieval result. */
export declare function toEvidenceRecord(result: WorkspaceRetrievalResult): RetrievalEvidenceRecord;
/** Build a bounded retrieval context packet for the model context window. */
export declare function buildRetrievalContextPacket(options: {
    query: string;
    retrievalPlanId: string;
    indexGenerationId: string;
    results: WorkspaceRetrievalResult[];
    maximumContextTokens?: number;
}): RetrievalContextPacket;
/** Render a packet as delimited, untrusted evidence text for prompt injection safety. */
export declare function renderPacketAsEvidence(packet: RetrievalContextPacket): string;
//# sourceMappingURL=context-packet.d.ts.map