Trim baseURL whitespace before endpoint normalization

Co-authored-by: Eric Allam <eric@trigger.dev>

Author: cursoragent

docs/tasks/streams.mdx

@@ -654,7 +654,7 @@ Subsequent reconnect calls will retry stale inactive-state cleanup until it succ
 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
-are normalized consistently.
+are normalized consistently, and surrounding whitespace is trimmed before normalization.
 
 For richer TypeScript ergonomics in app code, `@trigger.dev/ai` also exports:
 

packages/ai/CHANGELOG.md

@@ -20,3 +20,4 @@
 - Added reconnect cleanup error reporting for stale inactive state while still returning `null`.
 - Added retry semantics for stale inactive reconnect cleanup on subsequent reconnect attempts.
 - Added consistent baseURL normalization for trigger and stream endpoints (including path prefixes and trailing slashes).
+- Added surrounding-whitespace trimming for `baseURL` before endpoint normalization.

packages/ai/README.md

@@ -159,6 +159,7 @@ both cleanup steps (`set` inactive state and `delete`) even if one of them fails
 
 - `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.
 
 ## `ai.tool(...)` example
 

packages/ai/src/chatTransport.test.ts

@@ -479,6 +479,71 @@ describe("TriggerChatTransport", function () {
     );
   });
 
+  it("trims surrounding whitespace from baseURL values", async function () {
+    let observedTriggerPath: string | undefined;
+    let observedStreamPath: string | undefined;
+
+    const server = await startServer(function (req, res) {
+      if (req.method === "POST") {
+        observedTriggerPath = req.url ?? "";
+      }
+
+      if (req.method === "GET") {
+        observedStreamPath = req.url ?? "";
+      }
+
+      if (req.method === "POST" && req.url === "/api/v1/tasks/chat-task/trigger") {
+        res.writeHead(200, {
+          "content-type": "application/json",
+          "x-trigger-jwt": "pk_run_trimmed_baseurl",
+        });
+        res.end(JSON.stringify({ id: "run_trimmed_baseurl" }));
+        return;
+      }
+
+      if (req.method === "GET" && req.url === "/realtime/v1/streams/run_trimmed_baseurl/chat-stream") {
+        res.writeHead(200, {
+          "content-type": "text/event-stream",
+        });
+        writeSSE(
+          res,
+          "1-0",
+          JSON.stringify({ type: "text-start", id: "trimmed_baseurl_1" })
+        );
+        writeSSE(
+          res,
+          "2-0",
+          JSON.stringify({ type: "text-end", id: "trimmed_baseurl_1" })
+        );
+        res.end();
+        return;
+      }
+
+      res.writeHead(404);
+      res.end();
+    });
+
+    const transport = new TriggerChatTransport({
+      task: "chat-task",
+      accessToken: "pk_trigger",
+      baseURL: `  ${server.url}/   `,
+      stream: "chat-stream",
+    });
+
+    const stream = await transport.sendMessages({
+      trigger: "submit-message",
+      chatId: "chat-trimmed-baseurl",
+      messageId: undefined,
+      messages: [],
+      abortSignal: undefined,
+    });
+
+    const chunks = await readChunks(stream);
+    expect(chunks).toHaveLength(2);
+    expect(observedTriggerPath).toBe("/api/v1/tasks/chat-task/trigger");
+    expect(observedStreamPath).toBe("/realtime/v1/streams/run_trimmed_baseurl/chat-stream");
+  });
+
   it("combines path prefixes with run and stream URL encoding", async function () {
     let observedTriggerPath: string | undefined;
     let observedStreamPath: string | undefined;

packages/ai/src/chatTransport.ts

@@ -460,7 +460,7 @@ function resolvePayloadMapper<
 }
 
 function normalizeBaseUrl(baseURL: string) {
-  return baseURL.replace(/\/+$/, "");
+  return baseURL.trim().replace(/\/+$/, "");
 }
 
 function createTransportRequest<UI_MESSAGE extends UIMessage>(