agentfootprint/dist/types/trace-toolpack/causeCapture.d.ts

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

import type { LogAddress } from 'foottrace';
/** Fixed public reasons only; never stringify caller metadata or exceptions. */
export type CaptureReason = 'captured-root-log' | 'missing-attestation' | 'invalid-attestation' | 'run-mismatch' | 'scope-not-covered' | 'incomplete-extent' | 'run-not-completed' | 'modes-not-supported' | 'channel-not-captured' | 'capture-limited' | 'control-not-retained' | 'projection-incomplete';
export type SourceCaptureStatus = 'captured' | 'partial' | 'failed' | 'unknown';
export interface SnapshotCapture {
    readonly status: 'admitted' | 'incomplete';
    readonly reason: CaptureReason;
    readonly scope: 'root-log';
    readonly persistence: 'memory-only';
    readonly readSources: 'not-collected' | SourceCaptureStatus;
}
/** Own DATA only. A metadata getter is never a source of captured evidence. */
export declare function captureOwn(object: unknown, key: string): unknown;
export declare function captureAssessment(reason: CaptureReason, readSources?: SnapshotCapture['readSources']): SnapshotCapture;
/** Admit only the native root/current-leg contract. This is not an authenticity or storage check. */
export declare function assessCapture(snapshot: unknown, commits: number): SnapshotCapture;
/** Saved-only: the public producer reader has separately admitted source ownership. */
export declare function assessSourceCapture(snapshot: unknown, commits: number, sources: SourceCaptureStatus): SnapshotCapture;
/** Root notes never authorize a child address, or a synthetic snapshot namespace. */
export declare function captureAddress(value: unknown): LogAddress | undefined;
//# sourceMappingURL=causeCapture.d.ts.map