@dollhousemcp/mcp-server/dist/handlers/mcp-aql/GatekeeperConfig.d.ts

DollhouseMCP - A Model Context Protocol (MCP) server that enables dynamic AI persona management from markdown files, allowing Claude and other compatible AI assistants to activate and switch between different behavioral personas.

/**
 * Gatekeeper Configuration
 *
 * Default configuration for the Gatekeeper Policy Engine.
 * Contains tunable settings for verification strictness,
 * timeouts, and other enforcement parameters.
 */
import { VerificationStrictness } from './GatekeeperTypes.js';
/**
 * Gatekeeper configuration interface.
 * All settings are optional and fall back to defaults.
 */
export interface GatekeeperConfigOptions {
    /** Verification strictness level (default: STANDARD) */
    strictness?: VerificationStrictness;
    /** Timeout for verification prompts in milliseconds (default: 60000) */
    verificationTimeoutMs?: number;
    /** Whether to enable audit logging (default: true) */
    enableAuditLogging?: boolean;
    /** Maximum number of session confirmations to cache (default: 100) */
    maxSessionConfirmations?: number;
    /**
     * Whether active element policies (allow/confirm/deny/scopeRestrictions) can override the
     * default operation permission levels (default: true).
     *
     * When `true` (default): elements loaded into the session can elevate or restrict any
     * elevatable operation within the policy hierarchy (deny > confirm > allow > route default).
     *
     * When `false`: Layer 2 of `Gatekeeper.enforce()` is bypassed entirely. Only route validation
     * and default operation permission levels apply — no element can elevate or restrict anything.
     *
     * Use cases:
     * - **Emergency lockdown**: operator disables the element policy layer when a compromised
     *   or malformed element is suspected of influencing enforcement decisions.
     * - **Hardened deployment**: infrastructure-managed policy only; elements must never touch
     *   security posture (set this via env-var or deploy config).
     * - **Policy debugging**: isolate whether a gatekeeper decision originates from element
     *   policy or from the route default by toggling this flag.
     */
    allowElementPolicyOverrides?: boolean;
    /** Whether danger zone operations require extra verification (default: true) */
    requireDangerZoneVerification?: boolean;
}
/**
 * Default Gatekeeper configuration.
 * These values provide a secure, user-friendly balance.
 */
export declare const DEFAULT_GATEKEEPER_CONFIG: Required<GatekeeperConfigOptions>;
/**
 * Gatekeeper configuration manager.
 * Merges user config with defaults and provides type-safe access.
 */
export declare class GatekeeperConfig {
    private readonly config;
    constructor(options?: GatekeeperConfigOptions);
    /**
     * Get the verification strictness level.
     */
    get strictness(): VerificationStrictness;
    /**
     * Get the verification timeout in milliseconds.
     */
    get verificationTimeoutMs(): number;
    /**
     * Check if audit logging is enabled.
     */
    get enableAuditLogging(): boolean;
    /**
     * Get the maximum number of session confirmations to cache.
     */
    get maxSessionConfirmations(): number;
    /**
     * Whether element policies are permitted to override default operation permission levels.
     * When `false`, Layer 2 of `Gatekeeper.enforce()` is skipped entirely (operator kill switch).
     */
    get allowElementPolicyOverrides(): boolean;
    /**
     * Check if danger zone operations require extra verification.
     */
    get requireDangerZoneVerification(): boolean;
    /**
     * Get a copy of the full configuration.
     */
    toJSON(): Required<GatekeeperConfigOptions>;
}
//# sourceMappingURL=GatekeeperConfig.d.ts.map