Error Codes
All services use the Result pattern (neverthrow). Errors are typed with a code field and descriptive message. Here is the complete error code reference.
Pipeline Errors
| Code | Retryable | Description |
|---|---|---|
ALREADY_RUNNING | No | Another pipeline run is in progress |
DAILY_LIMIT_REACHED | No | MAX_POSTS_PER_DAY exceeded |
NO_POSTS_AVAILABLE | No | No posts match filters across all subreddits |
FETCH_FAILED | Yes | Reddit scraping failed after retries |
LLM_REWRITE_FAILED | Yes | LLM conversation generation failed |
MESSAGE_RENDER_FAILED | Yes | iMessage video rendering failed |
TTS_FAILED | Yes | Speech synthesis failed |
VIDEO_FAILED | Yes | Video composition failed |
PUBLISH_FAILED | Yes | TikTok upload failed |
Reddit Errors
| Code | Description |
|---|---|
BROWSER_NOT_READY | Camoufox not initialized |
NAVIGATION_FAILED | Failed to load subreddit page |
SCRAPING_FAILED | DOM parsing error |
NO_POSTS_FOUND | No posts match filters |
PERSISTENCE_FAILED | Database write error |
LLM Errors
| Code | Description |
|---|---|
REQUEST_FAILED | HTTP request to LLM endpoint failed |
PARSE_FAILED | LLM response is not valid JSON |
VALIDATION_FAILED | JSON doesn't match Conversation schema |
TIMEOUT | Request exceeded LLM_TIMEOUT_MS |
TTS Errors
| Code | Description |
|---|---|
MODEL_LOAD_FAILED | Kokoro ONNX model initialization error |
SYNTHESIS_FAILED | Audio generation error |
CHUNKING_FAILED | Text splitting error |
CONCATENATION_FAILED | Audio chunk joining error |
ALIGNMENT_FAILED | Whisper timestamp extraction error |
Video Errors
| Code | Description |
|---|---|
NO_BACKGROUNDS | No background videos in library |
BACKGROUND_PROBE_FAILED | FFprobe failed |
SUBTITLE_GENERATION_FAILED | ASS file generation error |
FFMPEG_FAILED | Video composition error |
OUTPUT_MISSING | FFmpeg succeeded but output file not found |
INVALID_INPUT | Missing required word timestamps |
Message Renderer Errors
| Code | Description |
|---|---|
FRAME_GENERATION_FAILED | PNG frame rendering error |
FFMPEG_FAILED | Video composition error |
TEMPLATE_LOAD_FAILED | iMessage template asset missing |
NARRATION_FAILED | TTS synthesis or alignment failure |
Publisher Errors
| Code | Description |
|---|---|
UPLOAD_FAILED | General upload error |
LOGIN_REQUIRED | Session expired |
CAPTCHA_DETECTED | CAPTCHA challenge (non-retryable) |
BROWSER_NOT_READY | Camoufox not initialized |
TIMEOUT | Upload exceeded timeout |
SESSION_EXPIRED | Cookie session invalid |
FILE_NOT_FOUND | Video file missing |
NAVIGATION_FAILED | TikTok page load error |
Browser Errors
| Code | Description |
|---|---|
LAUNCH_FAILED | Camoufox binary not found |
NOT_READY | Browser not initialized |
PAGE_CREATION_FAILED | Could not create page |
BROWSER_CRASHED | Browser process exited |