type LogLevel = | "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent"; function getPositiveNumber( envKey: string, fallback: number, ): number { const raw = process.env[envKey]?.trim(); if (!raw) return fallback; const parsed = Number(raw); return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback; } function getRatioNumber( envKey: string, fallback: number, ): number { const raw = process.env[envKey]?.trim(); if (!raw) return fallback; const parsed = Number(raw); return Number.isFinite(parsed) && parsed >= 0 && parsed <= 1 ? parsed : fallback; } export function getNodeEnv(): "dev" | "test" | "prod" { const value = process.env["NODE_ENV"]?.trim(); return value === "test" || value === "prod" ? value : "dev"; } export function getServiceName(): string { return process.env["SERVICE_NAME"]?.trim() || "lolympus-agent"; } export function getLogLevel(): LogLevel { const raw = process.env["LOG_LEVEL"]?.trim().toLowerCase() as | LogLevel | undefined; if ( raw === "fatal" || raw === "error" || raw === "warn" || raw === "info" || raw === "debug" || raw === "trace" || raw === "silent" ) { return raw; } const nodeEnv = getNodeEnv(); if (nodeEnv === "prod") return "warn"; if (nodeEnv === "test") return "debug"; return "trace"; } export function getOtelSamplingRatio(): number { const fallback = getNodeEnv() === "prod" ? 0.1 : 1.0; return getRatioNumber("OTEL_SAMPLING_RATIO", fallback); } export function getOtelExporter(): "stdout" { return "stdout"; } export function getRequestSubject(): string { return ( process.env["AGENT_REQUEST_SUBJECT"]?.trim() || "lolympus-agent.request" ); } export function getOnboardingSessionKeyPrefix(): string { return process.env["ONBOARDING_SESSION_KEY_PREFIX"]?.trim() || "lolympus"; } export function getConversationTtlSeconds(): number { return getPositiveNumber("CONVERSATION_TTL_SECONDS", 12 * 60 * 60); } export function getBlackboardTtlSeconds(): number { return getPositiveNumber("BLACKBOARD_TTL_SEC", 12 * 60 * 60); } export function getConversationSummaryTtlSeconds(): number { return getPositiveNumber("CONVERSATION_SUMMARY_TTL_SEC", 24 * 60 * 60); } export function getBackgroundStreamMaxLen(): number { return getPositiveNumber("BACKGROUND_STREAM_MAXLEN", 5_000); } export function getMaxConversationMessages(): number { return getPositiveNumber("MAX_CONVERSATION_MESSAGES", 20); } export function getLlmRequestTimeoutMs(): number { return getPositiveNumber("LLM_REQUEST_TIMEOUT_MS", 30_000); } export function getLlmHealthTimeoutMs(): number { return getPositiveNumber("LLM_HEALTH_TIMEOUT_MS", 5_000); } export function getLlmHealthCacheTtlMs(): number { return getPositiveNumber("LLM_HEALTH_CACHE_TTL_MS", 30_000); } export function getLlmCircuitFailureThreshold(): number { return getPositiveNumber("LLM_CIRCUIT_FAILURE_THRESHOLD", 3); } export function getLlmCircuitCooldownMs(): number { return getPositiveNumber("LLM_CIRCUIT_COOLDOWN_MS", 60_000); } export function getClassifierMaxTokens(): number { return getPositiveNumber("CLASSIFIER_MAX_TOKENS", 16); } export function getDeadlineNearThresholdMin(): number { return getPositiveNumber("DEADLINE_NEAR_THRESHOLD_MIN", 30); } export function getLlmMaxTokens(): number { return getPositiveNumber("LLM_MAX_TOKENS", 768); } export function getLlmTemperature(): number { const raw = process.env["LLM_TEMPERATURE"]?.trim(); if (raw) { const n = Number(raw); if (Number.isFinite(n) && n >= 0 && n <= 2) return n; } return 0.55; } export function getMaxResponseLength(): number { return getPositiveNumber("MAX_RESPONSE_LENGTH", 600); } export function getMongoDbProjectId(): string | undefined { return process.env["MONGODB_PROJECT_ID"]?.trim() || undefined; } export function getRoomContextLimit(): number { return getPositiveNumber("ROOM_CONTEXT_LIMIT", 8); }