/** 审计记录最小结构（测试注入 + 本地读出的公共形状） */
interface AuditTrailTestEntry {
    timestamp: string;
    diffRange: string;
    exitCode: number;
    agentId?: string;
    commitSha?: string;
}
/**
 * 测试用审计记录注入（MCP 单测隔离——不读真实 history.jsonl）。
 * @param records fake 设备审计记录；null 恢复默认（读真实本地历史）
 */
export declare function setAuditTrailTestRecords(records: Array<{
    entry: AuditTrailTestEntry;
    deviceId: string;
    trust: string;
}> | null): void;
export interface AuditTrailArgs {
    /** Agent 身份码（缺省 = 列出全部有轨迹的 agent） */
    agent_id?: string;
    /** 是否包含跨设备 peer 记录（缺省 false——仅本地） */
    include_peers?: boolean;
}
export interface AuditTrailResult {
    /** 首行必须 [sofagent] 前缀 */
    text: string;
    /** 结构化数据 */
    data: {
        agentId?: string;
        agents?: Array<{
            agentId: string;
            recordCount: number;
            devices: string[];
        }>;
        trail?: Array<{
            timestamp: string;
            diffRange: string;
            exitCode: number;
            deviceId: string;
            trust: string;
            hmacStatus: string;
            commitSha?: string;
        }>;
        isError: boolean;
    };
}
/**
 * 按 agentId 查询跨设备审计轨迹（无 agent_id 时列出全部）。
 *
 * @param args 参数
 * @returns 结构化结果（text + data）
 */
export declare function auditTrail(args?: AuditTrailArgs): Promise<AuditTrailResult>;
export {};
//# sourceMappingURL=audit-trail.d.ts.map