Skip to content

feat: fallback url when hitting cold starts#1113

Merged
homanp merged 2 commits into
mainfrom
feat/fallback-url
Feb 3, 2026
Merged

feat: fallback url when hitting cold starts#1113
homanp merged 2 commits into
mainfrom
feat/fallback-url

Conversation

@homanp
Copy link
Copy Markdown
Collaborator

@homanp homanp commented Feb 3, 2026

Description

Add a fallback endpoint for cold starts

Fixes #1108

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update

Checklist

  • Code follows project style guidelines
  • Tests pass locally
  • Documentation updated (if needed)

homanp and others added 2 commits February 3, 2026 08:26
Add automatic fallback to always-on endpoint when primary Cloud Run
endpoints experience cold starts.

- Add timeout-based fallback (default 5s) using AbortController (TS) / asyncio (Python)
- Add DEFAULT_FALLBACK_URL constant pointing to https://superagent.sh/api/fallback
- Add getFallbackUrl() helper with priority: client option > env var > default
- Add FallbackOptions interface/dataclass for configuration
- Add enableFallback, fallbackTimeoutMs/fallback_timeout, fallbackUrl options to ClientConfig
- Support SUPERAGENT_FALLBACK_URL environment variable override
- Add unit tests for fallback configuration and logic
- Bump version to 0.1.4

Co-authored-by: Cursor <cursoragent@cursor.com>
- cli: 0.1.3 → 0.1.4
- mcp: 0.1.2 → 0.1.3
- Update safety-agent dependency to ^0.1.4

Co-authored-by: Cursor <cursoragent@cursor.com>
@homanp homanp self-assigned this Feb 3, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Feb 3, 2026 7:32am

Request Review

@homanp homanp changed the title Feat/fallback url feat: fallback url when hitting cold starts Feb 3, 2026
@homanp homanp merged commit 2398fc4 into main Feb 3, 2026
3 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: superagent guard intermittently failing to fetch model

1 participant