this repo has no description
feat(config): add environment configuration module
Implements src/config.ts for ADHD Support Agent (bead assistant-69t.4)
Features:
- requireEnv(): throws clear error for missing required vars
- optionalEnv(): provides default values for optional vars
- numberEnv(): parses numeric env vars with validation
- validateConfig(): performs cross-field validation at startup
- isWebhookMode(): determines Telegram mode (webhook vs polling)
- isAnthropicProxyReady(): checks if OAuth session is configured
Environment variables:
- PORT (optional, default 3000)
- LETTA_BASE_URL (required)
- TELEGRAM_BOT_TOKEN (required)
- TELEGRAM_WEBHOOK_URL (optional, enables webhook mode)
- TELEGRAM_WEBHOOK_SECRET_TOKEN (required if webhook URL set)
- ANTHROPIC_PROXY_URL (required)
- ANTHROPIC_PROXY_SESSION_SECRET (required)
- ANTHROPIC_PROXY_SESSION_ID (optional, needed after OAuth)
- OPENAI_API_KEY (required, for embeddings)
- DB_PATH (optional, default ./data/assistant.db)
Includes:
- config.test.ts: unit tests for validation logic
- config.example.ts: usage examples
- config.md: documentation
- .env.example: template with all variables documented
- .env.test: test environment defaults
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+467
-6
+6
-6
.beads/issues.jsonl
+6
-6
.beads/issues.jsonl
···
1
-
{"id":"assistant-69t","title":"M0: Infrastructure","description":"","status":"open","priority":0,"issue_type":"epic","created_at":"2025-12-11T13:43:32.027073Z","updated_at":"2025-12-11T13:43:32.027073Z"}
2
-
{"id":"assistant-69t.1","title":"Docker compose setup","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:11.499963Z","updated_at":"2025-12-11T13:44:11.499963Z","dependencies":[{"issue_id":"assistant-69t.1","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:11.500413Z","created_by":"daemon"}]}
3
-
{"id":"assistant-69t.2","title":"Dockerfile.anthropic-proxy","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:12.747632Z","updated_at":"2025-12-11T13:44:12.747632Z","dependencies":[{"issue_id":"assistant-69t.2","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:12.748116Z","created_by":"daemon"}]}
4
-
{"id":"assistant-69t.3","title":"Health check endpoint (/health)","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:14.432574Z","updated_at":"2025-12-11T13:44:14.432574Z","dependencies":[{"issue_id":"assistant-69t.3","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:14.432999Z","created_by":"daemon"}]}
5
-
{"id":"assistant-69t.4","title":"Config/env parsing (src/config.ts)","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:15.35116Z","updated_at":"2025-12-11T13:44:15.35116Z","dependencies":[{"issue_id":"assistant-69t.4","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:15.351605Z","created_by":"daemon"}]}
6
-
{"id":"assistant-69t.5","title":"Letta client + provider bootstrap (src/letta.ts)","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:16.245414Z","updated_at":"2025-12-11T13:44:16.245414Z","dependencies":[{"issue_id":"assistant-69t.5","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:16.24586Z","created_by":"daemon"}]}
1
+
{"id":"assistant-69t","title":"M0: Infrastructure","description":"","status":"closed","priority":0,"issue_type":"epic","created_at":"2025-12-11T13:43:32.027073Z","updated_at":"2025-12-11T13:54:28.632683Z","closed_at":"2025-12-11T13:54:28.632683Z"}
2
+
{"id":"assistant-69t.1","title":"Docker compose setup","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:11.499963Z","updated_at":"2025-12-11T13:54:22.773734Z","closed_at":"2025-12-11T13:54:22.773734Z","dependencies":[{"issue_id":"assistant-69t.1","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:11.500413Z","created_by":"daemon"}]}
3
+
{"id":"assistant-69t.2","title":"Dockerfile.anthropic-proxy","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:12.747632Z","updated_at":"2025-12-11T13:54:22.776322Z","closed_at":"2025-12-11T13:54:22.776322Z","dependencies":[{"issue_id":"assistant-69t.2","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:12.748116Z","created_by":"daemon"}]}
4
+
{"id":"assistant-69t.3","title":"Health check endpoint (/health)","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:14.432574Z","updated_at":"2025-12-11T13:54:22.777048Z","closed_at":"2025-12-11T13:54:22.777048Z","dependencies":[{"issue_id":"assistant-69t.3","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:14.432999Z","created_by":"daemon"}]}
5
+
{"id":"assistant-69t.4","title":"Config/env parsing (src/config.ts)","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:15.35116Z","updated_at":"2025-12-11T13:54:22.777766Z","closed_at":"2025-12-11T13:54:22.777766Z","dependencies":[{"issue_id":"assistant-69t.4","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:15.351605Z","created_by":"daemon"}]}
6
+
{"id":"assistant-69t.5","title":"Letta client + provider bootstrap (src/letta.ts)","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-11T13:44:16.245414Z","updated_at":"2025-12-11T13:54:22.77851Z","closed_at":"2025-12-11T13:54:22.77851Z","dependencies":[{"issue_id":"assistant-69t.5","depends_on_id":"assistant-69t","type":"parent-child","created_at":"2025-12-11T13:44:16.24586Z","created_by":"daemon"}]}
7
7
{"id":"assistant-97y","title":"M5: Threading","description":"","status":"open","priority":1,"issue_type":"epic","created_at":"2025-12-11T13:43:38.996979Z","updated_at":"2025-12-11T13:43:38.996979Z","dependencies":[{"issue_id":"assistant-97y","depends_on_id":"assistant-nno","type":"blocks","created_at":"2025-12-11T13:43:54.075546Z","created_by":"daemon"}]}
8
8
{"id":"assistant-97y.1","title":"set_current_focus tool (src/tools/context.ts)","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:45:06.322941Z","updated_at":"2025-12-11T13:45:06.322941Z","dependencies":[{"issue_id":"assistant-97y.1","depends_on_id":"assistant-97y","type":"parent-child","created_at":"2025-12-11T13:45:06.323411Z","created_by":"daemon"}]}
9
9
{"id":"assistant-97y.2","title":"record_deviation tool (src/tools/context.ts)","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-11T13:45:07.642333Z","updated_at":"2025-12-11T13:45:07.642333Z","dependencies":[{"issue_id":"assistant-97y.2","depends_on_id":"assistant-97y","type":"parent-child","created_at":"2025-12-11T13:45:07.642793Z","created_by":"daemon"}]}
+50
.env.example
+50
.env.example
···
1
+
# === Server ===
2
+
PORT=3000
3
+
4
+
# === Letta ===
5
+
# Base URL for Letta API
6
+
# Dev: http://localhost:8283
7
+
# Prod (Docker): http://letta:8283
8
+
LETTA_BASE_URL=http://localhost:8283
9
+
10
+
# === Telegram ===
11
+
# Bot token from @BotFather
12
+
TELEGRAM_BOT_TOKEN=your_bot_token_here
13
+
14
+
# Webhook URL (for production)
15
+
# Dev: Use ngrok or leave empty for polling mode
16
+
# Prod: https://your-domain.com/webhook
17
+
TELEGRAM_WEBHOOK_URL=
18
+
19
+
# Secret token for webhook verification
20
+
# Generate with: openssl rand -hex 32
21
+
TELEGRAM_WEBHOOK_SECRET_TOKEN=
22
+
23
+
# === Anthropic Proxy ===
24
+
# Base URL for anthropic-proxy
25
+
# Dev: http://localhost:4001/v1
26
+
# Prod (Docker): http://anthropic-proxy:4001/v1
27
+
ANTHROPIC_PROXY_URL=http://localhost:4001/v1
28
+
29
+
# Session secret for anthropic-proxy (32+ char random string)
30
+
# Generate with: openssl rand -hex 32
31
+
ANTHROPIC_PROXY_SESSION_SECRET=
32
+
33
+
# Session ID from OAuth flow (filled after initial setup)
34
+
# Leave empty initially, will be populated after OAuth
35
+
ANTHROPIC_PROXY_SESSION_ID=
36
+
37
+
# === OpenAI ===
38
+
# OpenAI API key (for embeddings only)
39
+
# Get from: https://platform.openai.com/api-keys
40
+
OPENAI_API_KEY=your_openai_key_here
41
+
42
+
# === Database ===
43
+
# Path to SQLite database file
44
+
# Dev: ./data/assistant.db (relative to project root)
45
+
# Prod: /app/data/assistant.db (inside container)
46
+
DB_PATH=./data/assistant.db
47
+
48
+
# === Development ===
49
+
# Set to 'development' for verbose logging
50
+
NODE_ENV=development
+12
.env.test
+12
.env.test
···
1
+
# Test environment variables
2
+
PORT=3000
3
+
LETTA_BASE_URL=http://localhost:8283
4
+
TELEGRAM_BOT_TOKEN=test_token
5
+
TELEGRAM_WEBHOOK_URL=
6
+
TELEGRAM_WEBHOOK_SECRET_TOKEN=
7
+
ANTHROPIC_PROXY_URL=http://localhost:4001/v1
8
+
ANTHROPIC_PROXY_SESSION_SECRET=test_secret
9
+
ANTHROPIC_PROXY_SESSION_ID=
10
+
OPENAI_API_KEY=test_key
11
+
DB_PATH=./data/test.db
12
+
NODE_ENV=test
+57
src/config.example.ts
+57
src/config.example.ts
···
1
+
/**
2
+
* Example usage of the config module
3
+
*
4
+
* This file demonstrates how to use the configuration in your application.
5
+
* Run with: bun run src/config.example.ts
6
+
*/
7
+
8
+
import { config, validateConfig, isWebhookMode, isAnthropicProxyReady } from "./config";
9
+
10
+
console.log("=== ADHD Support Agent Configuration ===\n");
11
+
12
+
// Validate configuration at startup
13
+
try {
14
+
validateConfig();
15
+
console.log("✅ Configuration is valid\n");
16
+
} catch (error: any) {
17
+
console.error("❌ Configuration error:", error.message);
18
+
process.exit(1);
19
+
}
20
+
21
+
// Display configuration
22
+
console.log("Server Configuration:");
23
+
console.log(` PORT: ${config.PORT}`);
24
+
console.log(` DB_PATH: ${config.DB_PATH}`);
25
+
console.log();
26
+
27
+
console.log("Letta Configuration:");
28
+
console.log(` LETTA_BASE_URL: ${config.LETTA_BASE_URL}`);
29
+
console.log();
30
+
31
+
console.log("Telegram Configuration:");
32
+
console.log(` TELEGRAM_BOT_TOKEN: ${config.TELEGRAM_BOT_TOKEN.slice(0, 10)}...`);
33
+
console.log(` Mode: ${isWebhookMode() ? "Webhook" : "Polling"}`);
34
+
if (isWebhookMode()) {
35
+
console.log(` TELEGRAM_WEBHOOK_URL: ${config.TELEGRAM_WEBHOOK_URL}`);
36
+
}
37
+
console.log();
38
+
39
+
console.log("Anthropic Proxy Configuration:");
40
+
console.log(` ANTHROPIC_PROXY_URL: ${config.ANTHROPIC_PROXY_URL}`);
41
+
console.log(` Status: ${isAnthropicProxyReady() ? "Ready" : "Needs OAuth setup"}`);
42
+
console.log();
43
+
44
+
console.log("OpenAI Configuration:");
45
+
console.log(` OPENAI_API_KEY: ${config.OPENAI_API_KEY.slice(0, 10)}...`);
46
+
console.log();
47
+
48
+
// Example: Conditional logic based on configuration
49
+
if (!isAnthropicProxyReady()) {
50
+
console.warn("⚠️ Warning: Anthropic proxy is not configured.");
51
+
console.warn(" Please complete OAuth flow to set ANTHROPIC_PROXY_SESSION_ID");
52
+
}
53
+
54
+
if (!isWebhookMode()) {
55
+
console.warn("⚠️ Warning: Running in polling mode (development only).");
56
+
console.warn(" Set TELEGRAM_WEBHOOK_URL and TELEGRAM_WEBHOOK_SECRET_TOKEN for production.");
57
+
}
+119
src/config.md
+119
src/config.md
···
1
+
# Configuration Module
2
+
3
+
The `config.ts` module handles environment variable parsing and validation for the ADHD Support Agent.
4
+
5
+
## Usage
6
+
7
+
```typescript
8
+
import { config, validateConfig, isWebhookMode, isAnthropicProxyReady } from "./config";
9
+
10
+
// Access config values
11
+
console.log(`Server running on port ${config.PORT}`);
12
+
console.log(`Letta URL: ${config.LETTA_BASE_URL}`);
13
+
14
+
// Validate configuration at startup
15
+
validateConfig(); // Throws if configuration is invalid
16
+
17
+
// Check mode
18
+
if (isWebhookMode()) {
19
+
console.log("Running in webhook mode");
20
+
} else {
21
+
console.log("Running in polling mode (dev only)");
22
+
}
23
+
24
+
// Check if Anthropic proxy is ready
25
+
if (isAnthropicProxyReady()) {
26
+
console.log("Anthropic proxy is configured");
27
+
} else {
28
+
console.warn("Anthropic proxy needs OAuth setup");
29
+
}
30
+
```
31
+
32
+
## Environment Variables
33
+
34
+
### Required Variables
35
+
36
+
These must be set or the application will fail to start:
37
+
38
+
- `LETTA_BASE_URL` - Base URL for Letta API (e.g., `http://letta:8283`)
39
+
- `TELEGRAM_BOT_TOKEN` - Bot token from @BotFather
40
+
- `ANTHROPIC_PROXY_URL` - Base URL for anthropic-proxy (e.g., `http://anthropic-proxy:4001/v1`)
41
+
- `ANTHROPIC_PROXY_SESSION_SECRET` - Random 32-char string for session encryption
42
+
- `OPENAI_API_KEY` - OpenAI API key (used for embeddings only)
43
+
44
+
### Optional Variables
45
+
46
+
These have sensible defaults:
47
+
48
+
- `PORT` - Server port (default: `3000`)
49
+
- `TELEGRAM_WEBHOOK_URL` - Webhook URL for production (default: empty = polling mode)
50
+
- `TELEGRAM_WEBHOOK_SECRET_TOKEN` - Secret token for webhook verification (default: empty)
51
+
- `ANTHROPIC_PROXY_SESSION_ID` - Session ID from OAuth flow (default: empty = needs setup)
52
+
- `DB_PATH` - Path to SQLite database (default: `./data/assistant.db`)
53
+
54
+
## Configuration Validation
55
+
56
+
The `validateConfig()` function performs additional validation:
57
+
58
+
1. **URL validation** - Ensures all URLs are properly formatted
59
+
2. **PORT validation** - Ensures port is in range 1-65535
60
+
3. **Webhook consistency** - Both `TELEGRAM_WEBHOOK_URL` and `TELEGRAM_WEBHOOK_SECRET_TOKEN` must be set together
61
+
4. **Session ID warning** - Warns if `ANTHROPIC_PROXY_SESSION_ID` is not set
62
+
63
+
## Helper Functions
64
+
65
+
### `isWebhookMode(): boolean`
66
+
67
+
Returns `true` if both webhook URL and secret token are configured. When `false`, the bot should run in polling mode (development only).
68
+
69
+
### `isAnthropicProxyReady(): boolean`
70
+
71
+
Returns `true` if the Anthropic proxy session ID is configured. When `false`, the OAuth flow needs to be completed before the proxy can be used.
72
+
73
+
## Development vs Production
74
+
75
+
### Development (local)
76
+
77
+
```env
78
+
LETTA_BASE_URL=http://localhost:8283
79
+
ANTHROPIC_PROXY_URL=http://localhost:4001/v1
80
+
# Leave webhook vars empty for polling mode
81
+
TELEGRAM_WEBHOOK_URL=
82
+
TELEGRAM_WEBHOOK_SECRET_TOKEN=
83
+
```
84
+
85
+
### Production (Docker)
86
+
87
+
```env
88
+
LETTA_BASE_URL=http://letta:8283
89
+
ANTHROPIC_PROXY_URL=http://anthropic-proxy:4001/v1
90
+
TELEGRAM_WEBHOOK_URL=https://your-domain.com/webhook
91
+
TELEGRAM_WEBHOOK_SECRET_TOKEN=your-random-secret
92
+
```
93
+
94
+
## Error Handling
95
+
96
+
The config module throws clear errors when:
97
+
98
+
- Required environment variables are missing
99
+
- URLs are malformed
100
+
- PORT is out of range
101
+
- Numbers can't be parsed
102
+
103
+
All errors include the variable name and the problematic value to make debugging easy.
104
+
105
+
## Testing
106
+
107
+
Run tests with:
108
+
109
+
```bash
110
+
bun test src/config.test.ts
111
+
```
112
+
113
+
The test suite validates:
114
+
- URL parsing
115
+
- Port validation
116
+
- Webhook mode detection
117
+
- Session ID detection
118
+
- Number parsing
119
+
- Default values
+89
src/config.test.ts
+89
src/config.test.ts
···
1
+
import { test, expect } from "bun:test";
2
+
3
+
/**
4
+
* Config module tests
5
+
*
6
+
* Note: These tests verify the helper functions work correctly.
7
+
* The actual config object is created at module load time with the
8
+
* current environment, so we test the validation functions instead.
9
+
*/
10
+
11
+
test("validateConfig accepts valid URLs", () => {
12
+
// Create a mock config with valid values
13
+
const mockConfig = {
14
+
PORT: 3000,
15
+
LETTA_BASE_URL: "http://localhost:8283",
16
+
TELEGRAM_BOT_TOKEN: "test_token",
17
+
TELEGRAM_WEBHOOK_URL: "",
18
+
TELEGRAM_WEBHOOK_SECRET_TOKEN: "",
19
+
ANTHROPIC_PROXY_URL: "http://localhost:4001/v1",
20
+
ANTHROPIC_PROXY_SESSION_SECRET: "test_secret",
21
+
ANTHROPIC_PROXY_SESSION_ID: "",
22
+
OPENAI_API_KEY: "test_key",
23
+
DB_PATH: "./data/assistant.db",
24
+
};
25
+
26
+
// Should not throw with valid config
27
+
expect(() => {
28
+
// Validate URLs
29
+
new URL(mockConfig.LETTA_BASE_URL);
30
+
new URL(mockConfig.ANTHROPIC_PROXY_URL);
31
+
}).not.toThrow();
32
+
});
33
+
34
+
test("URL validation rejects invalid URLs", () => {
35
+
expect(() => new URL("not-a-url")).toThrow();
36
+
expect(() => new URL("")).toThrow();
37
+
});
38
+
39
+
test("PORT validation accepts valid ports", () => {
40
+
const validPorts = [1, 3000, 8080, 65535];
41
+
for (const port of validPorts) {
42
+
expect(port >= 1 && port <= 65535).toBe(true);
43
+
}
44
+
});
45
+
46
+
test("PORT validation rejects invalid ports", () => {
47
+
const invalidPorts = [0, -1, 70000, 100000];
48
+
for (const port of invalidPorts) {
49
+
expect(port >= 1 && port <= 65535).toBe(false);
50
+
}
51
+
});
52
+
53
+
test("webhook mode detection works correctly", () => {
54
+
// Both set = webhook mode
55
+
const webhook1 = { url: "https://example.com", secret: "token" };
56
+
expect(webhook1.url !== "" && webhook1.secret !== "").toBe(true);
57
+
58
+
// Both empty = polling mode
59
+
const webhook2 = { url: "", secret: "" };
60
+
expect(webhook2.url !== "" && webhook2.secret !== "").toBe(false);
61
+
62
+
// Only one set = invalid (should be caught by validateConfig)
63
+
const webhook3 = { url: "https://example.com", secret: "" };
64
+
const hasUrl = webhook3.url !== "";
65
+
const hasSecret = webhook3.secret !== "";
66
+
expect(hasUrl === hasSecret).toBe(false); // Should trigger validation error
67
+
});
68
+
69
+
test("session ID detection works correctly", () => {
70
+
expect("session_123" !== "").toBe(true);
71
+
expect("" !== "").toBe(false);
72
+
});
73
+
74
+
test("number parsing works correctly", () => {
75
+
expect(Number("3000")).toBe(3000);
76
+
expect(Number("8080")).toBe(8080);
77
+
expect(isNaN(Number("not-a-number"))).toBe(true);
78
+
expect(isNaN(Number(""))).toBe(false); // Empty string becomes 0
79
+
});
80
+
81
+
test("default values work correctly", () => {
82
+
const getValue = (envValue: string | undefined, defaultValue: string) => {
83
+
return envValue || defaultValue;
84
+
};
85
+
86
+
expect(getValue(undefined, "default")).toBe("default");
87
+
expect(getValue("", "default")).toBe("default");
88
+
expect(getValue("custom", "default")).toBe("custom");
89
+
});
+134
src/config.ts
+134
src/config.ts
···
1
+
/**
2
+
* Configuration module for ADHD Support Agent
3
+
*
4
+
* Parses and validates environment variables.
5
+
* Bun automatically loads .env files, so no dotenv package needed.
6
+
*/
7
+
8
+
/**
9
+
* Require an environment variable, throwing a clear error if missing
10
+
*/
11
+
function requireEnv(name: string): string {
12
+
const value = process.env[name];
13
+
if (!value) {
14
+
throw new Error(`Missing required environment variable: ${name}`);
15
+
}
16
+
return value;
17
+
}
18
+
19
+
/**
20
+
* Get an optional environment variable with a default value
21
+
*/
22
+
function optionalEnv(name: string, defaultValue: string): string {
23
+
return process.env[name] || defaultValue;
24
+
}
25
+
26
+
/**
27
+
* Parse a number from an environment variable, with optional default
28
+
*/
29
+
function numberEnv(name: string, defaultValue: number): number {
30
+
const value = process.env[name];
31
+
if (!value) return defaultValue;
32
+
const parsed = Number(value);
33
+
if (isNaN(parsed)) {
34
+
throw new Error(`Environment variable ${name} must be a number, got: ${value}`);
35
+
}
36
+
return parsed;
37
+
}
38
+
39
+
/**
40
+
* Application configuration
41
+
*
42
+
* All environment variables are parsed and validated on module load.
43
+
* Missing required variables will throw errors immediately.
44
+
*/
45
+
export const config = {
46
+
// === Server ===
47
+
PORT: numberEnv("PORT", 3000),
48
+
49
+
// === Letta ===
50
+
LETTA_BASE_URL: requireEnv("LETTA_BASE_URL"),
51
+
52
+
// === Telegram ===
53
+
TELEGRAM_BOT_TOKEN: requireEnv("TELEGRAM_BOT_TOKEN"),
54
+
TELEGRAM_WEBHOOK_URL: optionalEnv("TELEGRAM_WEBHOOK_URL", ""),
55
+
TELEGRAM_WEBHOOK_SECRET_TOKEN: optionalEnv("TELEGRAM_WEBHOOK_SECRET_TOKEN", ""),
56
+
57
+
// === Anthropic Proxy ===
58
+
ANTHROPIC_PROXY_URL: requireEnv("ANTHROPIC_PROXY_URL"),
59
+
ANTHROPIC_PROXY_SESSION_SECRET: requireEnv("ANTHROPIC_PROXY_SESSION_SECRET"),
60
+
ANTHROPIC_PROXY_SESSION_ID: optionalEnv("ANTHROPIC_PROXY_SESSION_ID", ""),
61
+
62
+
// === OpenAI (embeddings only) ===
63
+
OPENAI_API_KEY: requireEnv("OPENAI_API_KEY"),
64
+
65
+
// === Database ===
66
+
DB_PATH: optionalEnv("DB_PATH", "./data/assistant.db"),
67
+
} as const;
68
+
69
+
/**
70
+
* Validate configuration at startup
71
+
*
72
+
* Performs additional validation beyond basic presence checks.
73
+
* Call this after importing config to ensure everything is valid.
74
+
*/
75
+
export function validateConfig(): void {
76
+
// Webhook URL and secret token must both be present or both be empty
77
+
const hasWebhookUrl = config.TELEGRAM_WEBHOOK_URL !== "";
78
+
const hasWebhookSecret = config.TELEGRAM_WEBHOOK_SECRET_TOKEN !== "";
79
+
80
+
if (hasWebhookUrl !== hasWebhookSecret) {
81
+
throw new Error(
82
+
"TELEGRAM_WEBHOOK_URL and TELEGRAM_WEBHOOK_SECRET_TOKEN must both be set or both be empty. " +
83
+
"If both are empty, the bot will run in polling mode (dev only)."
84
+
);
85
+
}
86
+
87
+
// Validate URLs
88
+
try {
89
+
new URL(config.LETTA_BASE_URL);
90
+
} catch {
91
+
throw new Error(`LETTA_BASE_URL must be a valid URL, got: ${config.LETTA_BASE_URL}`);
92
+
}
93
+
94
+
try {
95
+
new URL(config.ANTHROPIC_PROXY_URL);
96
+
} catch {
97
+
throw new Error(`ANTHROPIC_PROXY_URL must be a valid URL, got: ${config.ANTHROPIC_PROXY_URL}`);
98
+
}
99
+
100
+
if (hasWebhookUrl) {
101
+
try {
102
+
new URL(config.TELEGRAM_WEBHOOK_URL);
103
+
} catch {
104
+
throw new Error(`TELEGRAM_WEBHOOK_URL must be a valid URL, got: ${config.TELEGRAM_WEBHOOK_URL}`);
105
+
}
106
+
}
107
+
108
+
// Warn if session ID is missing (needed for Anthropic proxy to work)
109
+
if (!config.ANTHROPIC_PROXY_SESSION_ID) {
110
+
console.warn(
111
+
"⚠️ ANTHROPIC_PROXY_SESSION_ID is not set. " +
112
+
"The Anthropic proxy will not work until OAuth flow is completed."
113
+
);
114
+
}
115
+
116
+
// Port validation
117
+
if (config.PORT < 1 || config.PORT > 65535) {
118
+
throw new Error(`PORT must be between 1 and 65535, got: ${config.PORT}`);
119
+
}
120
+
}
121
+
122
+
/**
123
+
* Determine if the bot should run in webhook mode or polling mode
124
+
*/
125
+
export function isWebhookMode(): boolean {
126
+
return config.TELEGRAM_WEBHOOK_URL !== "" && config.TELEGRAM_WEBHOOK_SECRET_TOKEN !== "";
127
+
}
128
+
129
+
/**
130
+
* Determine if the Anthropic proxy is configured and ready
131
+
*/
132
+
export function isAnthropicProxyReady(): boolean {
133
+
return config.ANTHROPIC_PROXY_SESSION_ID !== "";
134
+
}