agentfootprint/dist/esm/recorders/observability/internal/CandidateAnswerBuffer.d.ts

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

/**
 * @internal — not part of the public agentfootprint API. Imported only
 * by RunStepRecorder. Subject to change without notice.
 *
 * CandidateAnswerBuffer — buffers a "this leaf MIGHT be the run's
 * answer" candidate that's only confirmed on `onRunEnd`. Replaced
 * by every later leaf exit at run scope; the last one wins.
 *
 * Extracted from RunStepRecorder per Convention 1.
 *
 * Use:
 *   - On leaf EXIT at run scope: `set(frame, ts, runtimeStageId)`.
 *   - On `onRunEnd`: `flush()` returns the buffered candidate (or
 *     undefined if none), and clears the buffer.
 */
export interface CandidateAnswer<TFrame> {
    readonly frame: TFrame;
    readonly tsMs: number;
    readonly runtimeStageId: string;
}
export declare class CandidateAnswerBuffer<TFrame> {
    private candidate;
    /** Buffer a new candidate, replacing any prior one. */
    set(frame: TFrame, tsMs: number, runtimeStageId: string): void;
    /** Return + clear the buffered candidate (or undefined if empty). */
    flush(): CandidateAnswer<TFrame> | undefined;
    clear(): void;
}