import type { ToolResult } from './audit-tools';
/** 守卫判定结果 */
export interface GuardVerdict {
    /** 是否放行执行 */
    allowed: boolean;
    /** 拦截时的错误信息（allowed=false 时有） */
    blockReason?: string;
}
/** 守卫是否启用（SOFAGENT_PERMISSION_GUARD=1 opt-in） */
export declare function isPermissionGuardEnabled(): boolean;
/** 测试隔离出口——清空引擎单例 */
export declare function resetPermissionGuard(): void;
/**
 * tools/call 前置判定（守卫先于事件分发）。
 *
 * @param toolName 工具名
 * @returns allowed=false 时调用方必须拦截（sendError）不再执行工具
 */
export declare function guardToolCall(toolName: string): Promise<GuardVerdict>;
/** 类型锚（消费面形态——sendTool 的 ToolOutcome 分支） */
export type GuardToolResult = ToolResult;
//# sourceMappingURL=permission-guard.d.ts.map