Added docs and made getters return undefined if mode is LOCAL

Author: monadoid

packages/core/lib/v3/v3.ts

@@ -137,15 +137,15 @@ export class V3 {
   private readonly domSettleTimeoutMs?: number;
   private _isClosing = false;
   public browserbaseSessionId?: string;
-  private browserbaseSessionUrl = "";
-  private browserbaseDebugUrl = "";
+  private browserbaseSessionUrl?: string;
+  private browserbaseDebugUrl?: string;
   public get browserbaseSessionID(): string | undefined {
     return this.browserbaseSessionId;
   }
-  public get browserbaseSessionURL(): string {
+  public get browserbaseSessionURL(): string | undefined {
     return this.browserbaseSessionUrl;
   }
-  public get browserbaseDebugURL(): string {
+  public get browserbaseDebugURL(): string | undefined {
     return this.browserbaseDebugUrl;
   }
   private _onCdpClosed = (why: string) => {
@@ -862,7 +862,7 @@ export class V3 {
           }
           const sessionUrl = `https://www.browserbase.com/sessions/${sessionId}`;
           this.browserbaseSessionUrl = sessionUrl;
-          this.browserbaseDebugUrl = debugUrl ?? "";
+          this.browserbaseDebugUrl = debugUrl;
 
           try {
             this.logger({
@@ -940,8 +940,8 @@ export class V3 {
 
   private resetBrowserbaseSessionMetadata(): void {
     this.browserbaseSessionId = undefined;
-    this.browserbaseSessionUrl = "";
-    this.browserbaseDebugUrl = "";
+    this.browserbaseSessionUrl = undefined;
+    this.browserbaseDebugUrl = undefined;
   }
 
   /**

packages/core/tests/browserbase-session-accessors.test.ts

@@ -89,8 +89,8 @@ describe("browserbase accessors", () => {
     await v3.init();
     await v3.close();
 
-    expect(v3.browserbaseSessionURL).toBe("");
-    expect(v3.browserbaseDebugURL).toBe("");
+    expect(v3.browserbaseSessionURL).toBeUndefined();
+    expect(v3.browserbaseDebugURL).toBeUndefined();
   });
 });
 
@@ -107,8 +107,8 @@ describe("local accessors", () => {
 
     try {
       await v3.init();
-      expect(v3.browserbaseSessionURL).toBe("");
-      expect(v3.browserbaseDebugURL).toBe("");
+      expect(v3.browserbaseSessionURL).toBeUndefined();
+      expect(v3.browserbaseDebugURL).toBeUndefined();
     } finally {
       await v3.close().catch(() => {});
     }

packages/docs/v3/references/stagehand.mdx

@@ -379,6 +379,36 @@ interface HistoryEntry {
 }
 ```
 
+### browserbaseSessionID
+
+Browserbase session identifier for the active Browserbase run.
+
+```typescript
+const sessionId = stagehand.browserbaseSessionID;
+```
+
+**Type:** `string | undefined` — undefined for LOCAL runs or before `init()`.
+
+### browserbaseSessionURL
+
+Shareable link to the active Browserbase session dashboard.
+
+```typescript
+const sessionUrl = stagehand.browserbaseSessionURL;
+```
+
+**Type:** `string | undefined` — undefined until a Browserbase session is active.
+
+### browserbaseDebugURL
+
+Debugger URL returned by Browserbase for direct CDP inspection.
+
+```typescript
+const debugUrl = stagehand.browserbaseDebugURL;
+```
+
+**Type:** `string | undefined` — undefined for LOCAL runs or if Browserbase doesn’t provide one.
+
 ## Code Examples
 
 <Tabs>