From bf05b9449e52aab72eb4c3ff8b53bb11f0b37b68 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 15 Feb 2026 05:25:06 +0000 Subject: [PATCH] Document default baseURL behavior when omitted Co-authored-by: Eric Allam --- docs/tasks/streams.mdx | 3 ++- packages/ai/CHANGELOG.md | 1 + packages/ai/README.md | 1 + 3 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/tasks/streams.mdx b/docs/tasks/streams.mdx index 3393ca559..421ba0f40 100644 --- a/docs/tasks/streams.mdx +++ b/docs/tasks/streams.mdx @@ -653,7 +653,8 @@ the failure is surfaced through `onError` with phase `reconnect`. Subsequent reconnect calls will retry stale inactive-state cleanup until it succeeds. If `onError` is omitted, reconnect still returns `null` and continues without callback reporting. -`baseURL` supports optional path prefixes and trailing slashes; both trigger and stream URLs +`baseURL` defaults to `https://api.trigger.dev` when omitted. +It supports optional path prefixes and trailing slashes; both trigger and stream URLs are normalized consistently, surrounding whitespace is trimmed before normalization, and the resulting value must not be empty. The value must also be a valid absolute URL using the `http` or `https` protocol, without query parameters, hash fragments, or embedded diff --git a/packages/ai/CHANGELOG.md b/packages/ai/CHANGELOG.md index 1e4cd5586..190445329 100644 --- a/packages/ai/CHANGELOG.md +++ b/packages/ai/CHANGELOG.md @@ -29,3 +29,4 @@ - Documented that `HTTP://` and `HTTPS://` are accepted (case-insensitive protocol matching). - Added deterministic validation ordering for multi-issue baseURL values (protocol → query/hash → credentials). +- Documented explicit default `baseURL` value (`https://api.trigger.dev`) when omitted. diff --git a/packages/ai/README.md b/packages/ai/README.md index 88baea253..bd75c9ccf 100644 --- a/packages/ai/README.md +++ b/packages/ai/README.md @@ -157,6 +157,7 @@ both cleanup steps (`set` inactive state and `delete`) even if one of them fails ## Base URL behavior +- `baseURL` defaults to `https://api.trigger.dev` when omitted. - `baseURL` supports optional path prefixes (for example reverse-proxy mounts). - Trailing slashes are normalized automatically before trigger/stream requests. - Surrounding whitespace is trimmed before normalization.