/** * Centralized configuration for handoff payload size limits * * Issue #380 (Post-Review Hardening): Makes handoff size limits configurable * via environment variables. Previously, MAX_RECENT_ENTRIES and MAX_RECENT_DECISIONS * were hardcoded constants in handoff.ts. * * Environment variables follow the pattern: DOLLHOUSE_HANDOFF_* * Values are clamped between safety floors and security ceilings. * * @example * // Override via environment variables (set before server starts) * // DOLLHOUSE_HANDOFF_MAX_RECENT_ENTRIES=50 * // DOLLHOUSE_HANDOFF_MAX_RECENT_DECISIONS=25 * // DOLLHOUSE_HANDOFF_WARN_PAYLOAD_BYTES=512000 */ /** * Absolute maximum values — cannot be exceeded even with environment variable overrides. * Prevents resource exhaustion via unbounded handoff payloads. */ export declare const HANDOFF_HARD_LIMITS: { readonly recentEntries: 100; readonly recentDecisions: 50; readonly warnPayloadBytes: 1048576; }; /** * Minimum values — configured values cannot go below these. * Ensures handoff blocks contain enough context to be useful. */ export declare const HANDOFF_MIN_LIMITS: { readonly recentEntries: 5; readonly recentDecisions: 3; readonly warnPayloadBytes: 1024; }; /** * Default values when no environment variable is set. * Matches the original hardcoded constants. */ export declare const HANDOFF_DEFAULTS: { readonly recentEntries: 20; readonly recentDecisions: 10; readonly warnPayloadBytes: 102400; }; /** * Maps handoff config keys to their environment variable names. * Exported for documentation and testing purposes. */ export declare const HANDOFF_ENV_VARS: { readonly recentEntries: "DOLLHOUSE_HANDOFF_MAX_RECENT_ENTRIES"; readonly recentDecisions: "DOLLHOUSE_HANDOFF_MAX_RECENT_DECISIONS"; readonly warnPayloadBytes: "DOLLHOUSE_HANDOFF_WARN_PAYLOAD_BYTES"; }; /** * Get the maximum number of recent entries to include in a handoff payload. * Respects environment variable overrides with validation and clamping. */ export declare function getHandoffMaxRecentEntries(): number; /** * Get the maximum number of recent decisions to include in a handoff payload. * Respects environment variable overrides with validation and clamping. */ export declare function getHandoffMaxRecentDecisions(): number; /** * Get the payload size threshold (in bytes) at which a warning is logged. * Respects environment variable overrides with validation and clamping. */ export declare function getHandoffWarnPayloadBytes(): number; //# sourceMappingURL=handoff-limits.d.ts.map