/**
 * Permission String Formatter / Parser
 *
 * Standard format: module:resource:action (e.g., "admin:bots:read")
 * Legacy formats (read-only): resource.action, resource:action
 *
 * @see agents.dofe.ai/docs/0624/sso-opz/01-audit-and-optimization.md §5.2
 */
export interface ParsedPermission {
    module?: string;
    resource: string;
    action: string;
}
export interface FormatPermissionInput {
    module: string;
    resource: string;
    action: string;
}
/**
 * Format a structured permission into the standard string.
 *
 * @example formatPermission({ module: 'admin', resource: 'bots', action: 'read' })
 * // => "admin:bots:read"
 */
export declare function formatPermission(input: FormatPermissionInput): string;
/**
 * Parse a permission string into its components.
 *
 * Supports:
 * - Standard:  "module:resource:action" → { module, resource, action }
 * - Legacy dot: "resource.action"       → { resource, action }
 * - Legacy colon:"resource:action"      → { resource, action }
 *
 * @example parsePermission("admin:bots:read")  // => { module: "admin", resource: "bots", action: "read" }
 * @example parsePermission("bots.read")        // => { resource: "bots", action: "read" }
 * @example parsePermission("bots:read")        // => { resource: "bots", action: "read" }
 */
export declare function parsePermission(permission: string): ParsedPermission;
//# sourceMappingURL=permission.d.ts.map