/**
 * ps_execute Tool
 *
 * Executes an action under a PromptSpeak frame's governance.
 * The gatekeeper intercepts the action and enforces frame constraints.
 */
import type { InterceptorDecision } from '../types/index.js';
export interface PSExecuteRequest {
    agentId: string;
    frame: string;
    action: {
        tool: string;
        arguments: Record<string, unknown>;
        description?: string;
    };
    parentFrame?: string;
    metadata?: Record<string, unknown>;
}
export interface PSExecuteResult {
    success: boolean;
    agentId: string;
    frame: string;
    action: string;
    decision: InterceptorDecision;
    result?: unknown;
    driftStatus?: {
        score: number;
        alert: boolean;
        circuitState: string;
    };
    executionTime: number;
    auditId: string;
}
export declare function ps_execute(request: PSExecuteRequest): Promise<PSExecuteResult>;
export interface BatchExecuteRequest {
    agentId: string;
    frame: string;
    actions: Array<{
        tool: string;
        arguments: Record<string, unknown>;
        description?: string;
    }>;
    parentFrame?: string;
    stopOnFirstFailure?: boolean;
    parallel?: boolean;
}
export interface BatchExecuteResult {
    agentId: string;
    frame: string;
    allSucceeded: boolean;
    results: PSExecuteResult[];
    summary: {
        total: number;
        succeeded: number;
        failed: number;
        blocked: number;
    };
    totalExecutionTime: number;
}
export declare function ps_execute_batch(request: BatchExecuteRequest): Promise<BatchExecuteResult>;
export interface DryRunRequest {
    agentId: string;
    frame: string;
    action: {
        tool: string;
        arguments: Record<string, unknown>;
    };
    parentFrame?: string;
}
export interface DryRunResult {
    wouldSucceed: boolean;
    decision: InterceptorDecision;
    validationReport: {
        valid: boolean;
        errorCount: number;
        warningCount: number;
    };
    coverageAnalysis: {
        confidence: number;
        uncoveredAspects: string[];
    };
}
export declare function ps_execute_dry_run(request: DryRunRequest): DryRunResult;
//# sourceMappingURL=ps_execute.d.ts.map