feat: [STG-1808] Deprecate Browserbase project ID

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-7182c741edd5e22cda9bd855d31ca7e60a97a409222bb887edf87b9ce15dd493.yml
-openapi_spec_hash: 174581867a9191c491b22855b64c4f19
-config_hash: a962ae71493deb11a1c903256fb25386
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-f10429ab9f004c9a7f9f362d7fa82915e0dc04b1ba08a7bc9fd442ed5854cc77.yml
+openapi_spec_hash: 818f2e6e7eb5eb6f21f346b0b9828dce
+config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

README.md

@@ -397,7 +397,7 @@ See this table for the available options:
 | Property               | Environment variable     | Required | Default value                             |
 | ---------------------- | ------------------------ | -------- | ----------------------------------------- |
 | `BrowserbaseApiKey`    | `BROWSERBASE_API_KEY`    | true     | -                                         |
-| `BrowserbaseProjectID` | `BROWSERBASE_PROJECT_ID` | true     | -                                         |
+| `BrowserbaseProjectID` | `BROWSERBASE_PROJECT_ID` | false    | -                                         |
 | `ModelApiKey`          | `MODEL_API_KEY`          | true     | -                                         |
 | `BaseUrl`              | `STAGEHAND_API_URL`     | true     | `"https://api.stagehand.browserbase.com"` |
 

src/Stagehand/Core/ClientOptions.cs

@@ -107,20 +107,18 @@ public string BrowserbaseApiKey
     }
 
     /// <summary>
-    /// Your [Browserbase Project ID](https://www.browserbase.com/settings)
+    /// Deprecated. Browserbase API keys are now project-scoped, so this value is
+    /// no longer required.
     /// </summary>
-    Lazy<string> _browserbaseProjectID = new(() =>
+    Lazy<string?> _browserbaseProjectID = new(() =>
         Environment.GetEnvironmentVariable("BROWSERBASE_PROJECT_ID")
-        ?? throw new StagehandInvalidDataException(
-            string.Format("{0} cannot be null", nameof(BrowserbaseProjectID)),
-            new ArgumentNullException(nameof(BrowserbaseProjectID))
-        )
     );
 
     /// <summary>
-    /// Your [Browserbase Project ID](https://www.browserbase.com/settings)
+    /// Deprecated. Browserbase API keys are now project-scoped, so this value is
+    /// no longer required.
     /// </summary>
-    public string BrowserbaseProjectID
+    public string? BrowserbaseProjectID
     {
         readonly get { return _browserbaseProjectID.Value; }
         set { _browserbaseProjectID = new(() => value); }

src/Stagehand/IStagehandClient.cs

@@ -42,9 +42,10 @@ public interface IStagehandClient : IDisposable
     string BrowserbaseApiKey { get; init; }
 
     /// <summary>
-    /// Your [Browserbase Project ID](https://www.browserbase.com/settings)
+    /// Deprecated. Browserbase API keys are now project-scoped, so this value is
+    /// no longer required.
     /// </summary>
-    string BrowserbaseProjectID { get; init; }
+    string? BrowserbaseProjectID { get; init; }
 
     /// <summary>
     /// Your LLM provider API key (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)
@@ -93,9 +94,10 @@ public interface IStagehandClientWithRawResponse : IDisposable
     string BrowserbaseApiKey { get; init; }
 
     /// <summary>
-    /// Your [Browserbase Project ID](https://www.browserbase.com/settings)
+    /// Deprecated. Browserbase API keys are now project-scoped, so this value is
+    /// no longer required.
     /// </summary>
-    string BrowserbaseProjectID { get; init; }
+    string? BrowserbaseProjectID { get; init; }
 
     /// <summary>
     /// Your LLM provider API key (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, etc.)

src/Stagehand/Models/Sessions/SessionStartParams.cs

@@ -1451,6 +1451,11 @@ public bool? KeepAlive
         }
     }
 
+    /// <summary>
+    /// Deprecated. Browserbase API keys are now project-scoped, so this field is
+    /// no longer required.
+    /// </summary>
+    [System::Obsolete("deprecated")]
     public string? ProjectID
     {
         get

src/Stagehand/StagehandClient.cs

@@ -59,7 +59,7 @@ public string BrowserbaseApiKey
     }
 
     /// <inheritdoc/>
-    public string BrowserbaseProjectID
+    public string? BrowserbaseProjectID
     {
         get { return this._options.BrowserbaseProjectID; }
         init { this._options.BrowserbaseProjectID = value; }
@@ -168,7 +168,7 @@ public string BrowserbaseApiKey
     }
 
     /// <inheritdoc/>
-    public string BrowserbaseProjectID
+    public string? BrowserbaseProjectID
     {
         get { return this._options.BrowserbaseProjectID; }
         init { this._options.BrowserbaseProjectID = value; }