agentfootprint/dist/esm/lib/context-contract/evidence-navigation.d.ts

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

/** An application-declared evidence gap, not a model claim or a diagnosis. */
export interface EvidenceNeed {
    readonly id: string;
    readonly description: string;
}
/** A potential destination. Registration is neither access permission nor proof of data availability. */
export interface EvidenceRoute {
    readonly id: string;
    readonly need: string;
    readonly destination: string;
    readonly description: string;
    readonly requiredInputs: readonly string[];
}
export interface EvidenceNeedResolution {
    readonly need: EvidenceNeed;
    readonly status: 'not_configured' | 'no_matching_route' | 'matched';
    readonly routes: readonly (EvidenceRoute & {
        readonly status: 'needs_input' | 'proposed';
        readonly missingInputs: readonly string[];
    })[];
}
/**
 * Pure, opt-in exact-ID lookup over trusted application declarations. No I/O,
 * semantic matching, authorization, source probing, execution or recovery loop.
 * The app validates which input names are actually satisfied for the current
 * scope. Missing configuration is not evidence of absence outside this map.
 */
export declare function resolveEvidenceNeed(need: EvidenceNeed, routes?: readonly EvidenceRoute[], availableInputs?: readonly string[]): EvidenceNeedResolution;