interface ToolEnvelope {
    schemaVersion: string;
    success: boolean;
    operation: string;
    resource: string;
}
export interface SuccessEnvelope extends ToolEnvelope {
    success: true;
    result: unknown;
}
export interface ErrorEnvelope extends ToolEnvelope {
    success: false;
    error: {
        errorType: string;
        message: string;
        nextAction: string;
        context?: Record<string, unknown>;
    };
}
export declare const ERROR_TYPES: {
    readonly API_ERROR: "API_ERROR";
    readonly ENTITY_NOT_FOUND: "ENTITY_NOT_FOUND";
    readonly NO_RESULTS_FOUND: "NO_RESULTS_FOUND";
    readonly MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
    readonly MISSING_ENTITY_ID: "MISSING_ENTITY_ID";
    readonly INVALID_OPERATION: "INVALID_OPERATION";
    readonly WRITE_OPERATION_BLOCKED: "WRITE_OPERATION_BLOCKED";
    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
    readonly UNKNOWN_RESOURCE: "UNKNOWN_RESOURCE";
};
export declare function wrapSuccess(resource: string, operation: string, result: unknown): SuccessEnvelope;
export declare function wrapError(resource: string, operation: string, errorType: string, message: string, nextAction: string, context?: Record<string, unknown>): ErrorEnvelope;
export declare function formatMissingIdError(resource: string, operation: string, supportsSearch?: boolean): ErrorEnvelope;
export declare function formatNotFoundError(resource: string, operation: string, id: number, supportsSearch?: boolean): ErrorEnvelope;
export declare function formatNoResultsFound(resource: string, operation: string, filters: Record<string, unknown>): ErrorEnvelope;
export declare function formatApiError(message: string, resource: string, operation: string, supportsSearch?: boolean): ErrorEnvelope;
export {};