Files
lolympus-agent/src/config.ts
T

673 lines
18 KiB
TypeScript

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 getPhoenixOtlpEndpoint(): string | undefined {
return process.env["PHOENIX_OTLP_ENDPOINT"]?.trim() || undefined;
}
export function getPhoenixLogPrompts(): boolean {
return getBoolean("PHOENIX_LOG_PROMPTS", false);
}
export function getRagEnabled(): boolean {
return getBoolean("AGENT_RAG_ENABLED", true);
}
export function getEmbeddingProvider(): "openrouter" | "openai" {
const raw = process.env["EMBEDDING_PROVIDER"]?.trim().toLowerCase();
return raw === "openai" ? "openai" : "openrouter";
}
export function getEmbeddingModel(provider = getEmbeddingProvider()): string {
const configured = process.env["EMBEDDING_MODEL"]?.trim();
if (configured) {
return configured;
}
return provider === "openai"
? "text-embedding-3-small"
: "openai/text-embedding-3-small";
}
export function getEmbeddingApiUrl(provider = getEmbeddingProvider()): string {
const configured = process.env["EMBEDDING_API_URL"]?.trim();
if (configured) {
return configured;
}
return provider === "openai"
? "https://api.openai.com/v1"
: "https://openrouter.ai/api/v1";
}
export function getEmbeddingDimensions(): number {
return getPositiveNumber("EMBEDDING_DIMENSIONS", 1536);
}
export function getEmbeddingRequestTimeoutMs(): number {
return getPositiveNumber("EMBEDDING_REQUEST_TIMEOUT_MS", 30_000);
}
export function getKnowledgeSearchCandidateLimit(): number {
return getPositiveNumber("KNOWLEDGE_SEARCH_CANDIDATE_LIMIT", 500);
}
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);
}