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; } function normalizeSkillEnvSuffix( skill: string | undefined, ): string | undefined { const suffix = skill ?.trim() .toUpperCase() .replace(/[^A-Z0-9]/gu, "_"); return suffix || undefined; } function getPositiveNumberForSkill( envKey: string, skill: string | undefined, fallback: number, ): number { const skillSuffix = normalizeSkillEnvSuffix(skill); if (skillSuffix) { const raw = process.env[`${envKey}_${skillSuffix}`]?.trim(); if (raw) { const parsed = Number(raw); if (Number.isFinite(parsed) && parsed > 0) { return parsed; } } } return getPositiveNumber(envKey, fallback); } function getRatioNumberForSkill( envKey: string, skill: string | undefined, fallback: number, ): number { const skillSuffix = normalizeSkillEnvSuffix(skill); if (skillSuffix) { const raw = process.env[`${envKey}_${skillSuffix}`]?.trim(); if (raw) { const parsed = Number(raw); if (Number.isFinite(parsed) && parsed >= 0 && parsed <= 1) { return parsed; } } } return getRatioNumber(envKey, fallback); } function getBoolean(envKey: string, fallback: boolean): boolean { const raw = process.env[envKey]?.trim().toLowerCase(); if (!raw) return fallback; if (raw === "1" || raw === "true" || raw === "yes") return true; if (raw === "0" || raw === "false" || raw === "no") return false; return 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" | "none" { const env = process.env["OTEL_EXPORTER"]?.trim().toLowerCase(); if (env === "none" || env === "stdout") { return env; } return getNodeEnv() === "dev" ? "none" : "stdout"; } export function getRequestSubject(): string { return ( process.env["AGENT_REQUEST_SUBJECT"]?.trim() || "lolympus-agent.request" ); } export function getDiscordMemberLookupSubject(): string { return ( process.env["DISCORD_MEMBER_LOOKUP_SUBJECT"]?.trim() || "lolympus.discord.lookup-members" ); } export function getAgentRequestTimeoutMs(): number { return getPositiveNumber("AGENT_REQUEST_TIMEOUT_MS", 5_000); } export function getAgentBudgetEnabled(): boolean { return getBoolean("AGENT_BUDGET_ENABLED", true); } export function getAgentBudgetMaxHandoffs(): number { return getPositiveNumber("AGENT_BUDGET_MAX_HANDOFFS", 4); } export function getAgentBudgetMaxSameAgentVisits(): number { return getPositiveNumber("AGENT_BUDGET_MAX_SAME_AGENT_VISITS", 2); } export function getAgentBudgetMaxToolCalls(): number { return getPositiveNumber("AGENT_BUDGET_MAX_TOOL_CALLS", 20); } export function getAgentBudgetMaxCostUsd(): number { return getPositiveNumber("AGENT_BUDGET_MAX_COST_USD", 0.5); } export function getAgentRuntimeVerifierEnabled(): boolean { return getBoolean("AGENT_RUNTIME_VERIFIER_ENABLED", false); } export function getMetricsPort(): number { return getPositiveNumber("METRICS_PORT", 9464); } export function getDiscordVerifyTimeoutMs(): number { return getPositiveNumber("DISCORD_VERIFY_TIMEOUT_MS", 2_500); } 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 getEvalStreamMaxLen(): number { return getPositiveNumber("EVAL_STREAM_MAXLEN", 10_000); } export function getEvalAggTickMs(): number { return getPositiveNumber("EVAL_AGG_TICK_MS", 300_000); } export function getEvalAggTtlSec(): number { return getPositiveNumber("EVAL_AGG_TTL_SEC", 604_800); } export function getEvalAggLatencySampleCap(): number { return getPositiveNumber("EVAL_AGG_LATENCY_SAMPLE_CAP", 200); } export function getEvalArchiveTickMs(): number { return getPositiveNumber("EVAL_ARCHIVE_TICK_MS", 3_600_000); } export function getEvalArchiveTtlDays(): number { return getPositiveNumber("EVAL_ARCHIVE_TTL_DAYS", 30); } export function getEvalArchiveBatchSize(): number { return getPositiveNumber("EVAL_ARCHIVE_BATCH_SIZE", 500); } export function getEvalDriftTickMs(): number { return getPositiveNumber("EVAL_DRIFT_TICK_MS", 86_400_000); } export function getEvalPromoteTickMs(): number { return getPositiveNumber("EVAL_PROMOTE_TICK_MS", 86_400_000); } export function getEvalPromoteLowScore(): number { return getPositiveNumber("EVAL_PROMOTE_LOW_SCORE", 2); } export function getEvalPromoteRareThreshold(): number { return getPositiveNumber("EVAL_PROMOTE_RARE_THRESHOLD", 5); } export function getEvalPromotePerCategoryLimit(): number { return getPositiveNumber("EVAL_PROMOTE_PER_CATEGORY_LIMIT", 10); } export function getEvalReviewTickMs(): number { return getPositiveNumber("EVAL_REVIEW_TICK_MS", 300_000); } export function getEvalReviewQueueMaxLen(): number { return getPositiveNumber("EVAL_REVIEW_QUEUE_MAXLEN", 500); } export function getEvalReviewLabelMaxLen(): number { return getPositiveNumber("EVAL_REVIEW_LABEL_MAXLEN", 5_000); } export function getEvalReviewPerCategoryLimit(): number { return getPositiveNumber("EVAL_REVIEW_PER_CATEGORY_LIMIT", 5); } export function getEvalReviewDedupeTtlSec(): number { return getPositiveNumber("EVAL_REVIEW_DEDUPE_TTL_SEC", 604_800); } export function getSupervisorReviewQueueMaxLen(): number { return getPositiveNumber("SUPERVISOR_REVIEW_QUEUE_MAXLEN", 10_000); } export function getSupervisorReviewResolutionTtlSec(): number { return getPositiveNumber( "SUPERVISOR_REVIEW_RESOLUTION_TTL_SEC", 90 * 24 * 60 * 60, ); } export function getSupervisorResolutionsStreamMaxLen(): number { return getPositiveNumber("SUPERVISOR_RESOLUTIONS_STREAM_MAXLEN", 100_000); } export function getSupervisorLlmEnabled(): boolean { return getBoolean("AGENT_SUPERVISOR_LLM_ENABLED", true); } export function getSupervisorLlmConfidenceThreshold(): number { return getRatioNumber("AGENT_SUPERVISOR_LLM_CONFIDENCE_THRESHOLD", 0.6); } export function getSupervisorLlmResponseEnabled(): boolean { return getBoolean("AGENT_SUPERVISOR_LLM_RESPONSE_ENABLED", true); } export function getEvalCalibrationMinCorr(): number { return getRatioNumber("EVAL_CALIBRATION_MIN_CORR", 0.5); } export function getLlmProposeModel(): string { return process.env["LLM_PROPOSE_MODEL"]?.trim() || getLlmJudgeModel(); } export function getLlmProposeMaxTokens(): number { return getPositiveNumber("LLM_PROPOSE_MAX_TOKENS", 1_024); } export function getEvalTournamentMaxMatches(): number { return getPositiveNumber("EVAL_TOURNAMENT_MAX_MATCHES", 50); } export function getEvalTournamentMinCases(): number { return getPositiveNumber("EVAL_TOURNAMENT_MIN_CASES", 10); } export function getPromptVariantId(): string | undefined { return process.env["PROMPT_VARIANT_ID"]?.trim() || undefined; } export function getAgentAbstentionEnabled(): boolean { return getBoolean("AGENT_ABSTENTION_ENABLED", false); } export function getAgentAbstentionThreshold(): number { return getRatioNumber("AGENT_ABSTENTION_THRESHOLD", 0.35); } export function getAgentAbstentionClarifyThreshold(): number { return getRatioNumber("AGENT_ABSTENTION_CLARIFY_THRESHOLD", 0.45); } export function getAgentToolRetryMax(): number { return getPositiveNumber("AGENT_TOOL_RETRY_MAX", 1); } export function getAgentToolLoopMaxHops(): number { return getPositiveNumber("AGENT_TOOL_LOOP_MAX_HOPS", 3); } export function getAgentProgrammaticToolCalling(): boolean { return getBoolean("AGENT_PROGRAMMATIC_TOOL_CALLING", false); } export function getAgentSkillMdMode(): boolean { return getBoolean("AGENT_SKILL_MD_MODE", false); } export function getAgentRouterMode(): | "off" | "static" | "learned-v1" | "learned-v2" { const raw = process.env["AGENT_ROUTER_MODE"]?.trim(); if ( raw === "off" || raw === "static" || raw === "learned-v1" || raw === "learned-v2" ) { return raw; } return "static"; } export function getAgentRouterWeightsPath(): string | undefined { return process.env["AGENT_ROUTER_WEIGHTS_PATH"]?.trim() || undefined; } export function getAgentUserMemoryEnabled(): boolean { return getBoolean("AGENT_USER_MEMORY_ENABLED", false); } export function getAgentUserMemoryTtlDays(): number { return getPositiveNumber("AGENT_USER_MEMORY_TTL_DAYS", 30); } export function getAgentTrustMinTier(): "T1" | "T2" | "T3" | "T4" { const raw = process.env["AGENT_TRUST_MIN_TIER"]?.trim(); if (raw === "T1" || raw === "T2" || raw === "T3" || raw === "T4") { return raw; } return "T2"; } export function getAgentToolSearchEnabled(): boolean { return getBoolean("AGENT_TOOL_SEARCH_ENABLED", false); } export function getAgentToolSearchThreshold(): number { return getPositiveNumber("AGENT_TOOL_SEARCH_THRESHOLD", 10); } export function getAgentCriticMaxIterations(): number { return getPositiveNumber("AGENT_CRITIC_MAX_ITERATIONS", 1); } 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 getLlmJudgeModel(): string { return process.env["LLM_JUDGE_MODEL"]?.trim() || "gpt-5.3-codex-spark"; } export function getLlmJudgeMaxTokens(): number { return getPositiveNumber("LLM_JUDGE_MAX_TOKENS", 128); } export function getEvalProcessLlmJudgeEnabled(): boolean { return getBoolean("EVAL_PROCESS_LLM_JUDGE_ENABLED", false); } export function getEvalProcessLlmJudgeSamplingRate(): number { return getRatioNumber("EVAL_PROCESS_LLM_JUDGE_SAMPLING_RATE", 0.1); } export function getEvalProcessLlmJudgeMaxTokens(): number { return getPositiveNumber("EVAL_PROCESS_LLM_JUDGE_MAX_TOKENS", 256); } export function getEvalPrmEnabled(): boolean { return getBoolean("EVAL_PRM_ENABLED", false); } export function getEvalPrmWeightsPath(): string | undefined { return process.env["EVAL_PRM_WEIGHTS_PATH"]?.trim() || undefined; } export function getEvalPrmMinLabels(): number { return getPositiveNumber("EVAL_PRM_MIN_LABELS", 500); } export function getEvalAttributionTickMs(): number { return getPositiveNumber("EVAL_ATTRIBUTION_TICK_MS", 6 * 60 * 60 * 1000); } export function getSafetyMarginMs(): number { return getPositiveNumber("SAFETY_MARGIN_MS", 500); } export function getDeadlineNearThresholdMin(): number { return getPositiveNumber("DEADLINE_NEAR_THRESHOLD_MIN", 30); } export function getOpenRouterEnabled(): boolean { return Boolean(process.env["OPENROUTER_API_KEY"]?.trim()); } export function getOpenRouterApiUrl(): string { return ( process.env["OPENROUTER_API_URL"]?.trim() || "https://openrouter.ai/api/v1" ); } export function getTier0Model(): string { return ( process.env["TIER0_MODEL"]?.trim() || process.env["CLI_PROXY_LLM_MODEL"]?.trim() || "gpt-5.3-codex-spark" ); } export function getTier1PlannerModel(): string { return ( process.env["TIER1_PLANNER_MODEL"]?.trim() || process.env["CLI_PROXY_LLM_MODEL"]?.trim() || "gpt-5.4" ); } export function getTier1ResponderModel(): string { return ( process.env["TIER1_RESPONDER_MODEL"]?.trim() || process.env["CLI_PROXY_LLM_MODEL"]?.trim() || "gpt-5.3-codex-spark" ); } export function getTier2CriticModel(): string { return ( process.env["TIER2_CRITIC_MODEL"]?.trim() || process.env["CLI_PROXY_LLM_MODEL"]?.trim() || "gpt-5.4" ); } export function getOpenRouterModels(): string[] { const raw = process.env["OPENROUTER_MODEL"]?.trim(); if (!raw) { return ["openai/gpt-5.3-codex-spark"]; } const models = raw .split(",") .map((value) => value.trim()) .filter((value) => value.length > 0); return models.length > 0 ? models : ["openai/gpt-5.3-codex-spark"]; } export function getLlmMaxTokens(): number { return getPositiveNumber("LLM_MAX_TOKENS", 768); } export function getTier0MaxTokens(): number { return getPositiveNumber("TIER0_MAX_TOKENS", 384); } export function getTier1MaxTokens(): number { return getPositiveNumber("TIER1_MAX_TOKENS", 512); } export function getTier2MaxTokens(): number { return getPositiveNumber("TIER2_MAX_TOKENS", 512); } export function getPlannerMaxTokens(): number { return getPositiveNumber("PLANNER_MAX_TOKENS", 256); } export function getCriticMaxTokens(): number { return getPositiveNumber("CRITIC_MAX_TOKENS", 512); } export function getTier0EstimatedCallMs(): number { return getPositiveNumber("TIER0_ESTIMATED_CALL_MS", 600); } export function getTier1EstimatedCallMs(): number { return getPositiveNumber("TIER1_ESTIMATED_CALL_MS", 1200); } export function getTier2EstimatedCallMs(): number { return getPositiveNumber("TIER2_ESTIMATED_CALL_MS", 1400); } 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); } export function getShadowEvalSamplingRate(tier: 0 | 1 | 2): number { switch (tier) { case 0: return getRatioNumber( "SHADOW_EVAL_SAMPLING_RATE_TIER0", getNodeEnv() === "prod" ? 0.1 : 1.0, ); case 1: return getRatioNumber( "SHADOW_EVAL_SAMPLING_RATE_TIER1", getNodeEnv() === "prod" ? 0.5 : 1.0, ); case 2: return getRatioNumber("SHADOW_EVAL_SAMPLING_RATE_TIER2", 1.0); } } export function getAlertThresholdP95LatencyMs(skill?: string): number { return getPositiveNumberForSkill( "ALERT_THRESHOLD_P95_LATENCY_MS", skill, 3_000, ); } export function getAlertThresholdEvalScoreDropPct(skill?: string): number { return getPositiveNumberForSkill( "ALERT_THRESHOLD_EVAL_SCORE_DROP_PCT", skill, 10, ); } export function getAlertThresholdLlmErrorRate(skill?: string): number { return getRatioNumberForSkill("ALERT_THRESHOLD_LLM_ERROR_RATE", skill, 0.1); } export function getAlertThresholdDriftPct(skill?: string): number { return getPositiveNumberForSkill("ALERT_THRESHOLD_DRIFT_PCT", skill, 15); } export function getAlertRateLimitSec(): number { return getPositiveNumber("ALERT_RATE_LIMIT_SEC", 300); } export function getSlackAlertWebhookUrl(): string | undefined { return process.env["SLACK_ALERT_WEBHOOK_URL"]?.trim() || undefined; } export function getSlackWebhookTimeoutMs(): number { return getPositiveNumber("SLACK_WEBHOOK_TIMEOUT_MS", 3_000); }