feat: Add start_url to browser session updates

Stainless-Generated-From: 59b07331e3bf5513100765ecff61bb79536e7b55

Author: kernel-internal[bot]

src/resources/browser-pools.ts

@@ -477,7 +477,7 @@ export interface BrowserPoolAcquireResponse {
   proxy_id?: string;
 
   /**
-   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * URL the session was most recently asked to navigate to, if any. Recorded for
    * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
    * without waiting for it to load, and any errors (DNS failure, bad status,
    * timeout) are silently dropped. Captures what was requested, not what the browser

src/resources/browsers/browsers.ts

@@ -607,7 +607,7 @@ export interface BrowserCreateResponse {
   proxy_id?: string;
 
   /**
-   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * URL the session was most recently asked to navigate to, if any. Recorded for
    * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
    * without waiting for it to load, and any errors (DNS failure, bad status,
    * timeout) are silently dropped. Captures what was requested, not what the browser
@@ -778,7 +778,7 @@ export interface BrowserRetrieveResponse {
   proxy_id?: string;
 
   /**
-   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * URL the session was most recently asked to navigate to, if any. Recorded for
    * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
    * without waiting for it to load, and any errors (DNS failure, bad status,
    * timeout) are silently dropped. Captures what was requested, not what the browser
@@ -949,7 +949,7 @@ export interface BrowserUpdateResponse {
   proxy_id?: string;
 
   /**
-   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * URL the session was most recently asked to navigate to, if any. Recorded for
    * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
    * without waiting for it to load, and any errors (DNS failure, bad status,
    * timeout) are silently dropped. Captures what was requested, not what the browser
@@ -1120,7 +1120,7 @@ export interface BrowserListResponse {
   proxy_id?: string;
 
   /**
-   * URL the session was asked to navigate to on creation, if any. Recorded for
+   * URL the session was most recently asked to navigate to, if any. Recorded for
    * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
    * without waiting for it to load, and any errors (DNS failure, bad status,
    * timeout) are silently dropped. Captures what was requested, not what the browser
@@ -1482,6 +1482,14 @@ export interface BrowserUpdateParams {
    */
   proxy_id?: string | null;
 
+  /**
+   * Optional URL to navigate the browser to after applying this update. When a
+   * profile is loaded in the same update, this overrides the profile's restored
+   * tabs. Navigation is best-effort, so failures do not fail the update. Omit or set
+   * to an empty string to leave the current page unchanged.
+   */
+  start_url?: string;
+
   /**
    * User-defined key-value tags for the browser session. Omit to leave unchanged.
    * Provide a map to replace the entire tag set (full replace, not a merge). Set to

src/resources/invocations.ts

@@ -566,7 +566,7 @@ export namespace InvocationListBrowsersResponse {
     proxy_id?: string;
 
     /**
-     * URL the session was asked to navigate to on creation, if any. Recorded for
+     * URL the session was most recently asked to navigate to, if any. Recorded for
      * debugging. Navigation is fire-and-forget — the URL is dispatched to the browser
      * without waiting for it to load, and any errors (DNS failure, bad status,
      * timeout) are silently dropped. Captures what was requested, not what the browser

src/resources/vaults/items.ts

@@ -433,9 +433,17 @@ export namespace CardVaultItemSpec {
   }
 }
 
+/**
+ * Issued Link cards retain encrypted card material for the fill operation. Link
+ * cards do not expose aliases or support egress substitution.
+ */
 export type CardVaultItemState = CardVaultItemState.LinkCardState | CardVaultItemState.AgentCardCardState;
 
 export namespace CardVaultItemState {
+  /**
+   * Issued Link cards retain encrypted card material for the fill operation. Link
+   * cards do not expose aliases or support egress substitution.
+   */
   export interface LinkCardState {
     provider: 'link';
 
@@ -455,8 +463,6 @@ export namespace CardVaultItemState {
       | 'declined'
       | 'recovery_required';
 
-    aliases?: ItemsAPI.VaultCardAliases;
-
     domains?: Array<string>;
 
     masks?: LinkCardState.Masks;
@@ -895,10 +901,9 @@ export interface CredentialVaultItemUpdateRequest {
  *
  * Fill in request order and stop on the first failure. This operation is not
  * atomic: previously filled fields are not rolled back. Never submit the form or
- * click buttons, though input/change events may trigger site behavior. Fill is the
- * preferred browser-checkout path. Aliases remain an alternative for explicitly
- * chosen egress-substitution integrations. Do not automatically retry or fall back
- * to aliases after a failed or indeterminate operation.
+ * click buttons, though input/change events may trigger site behavior. Link cards
+ * use fill for browser checkout and do not expose aliases or support egress
+ * substitution. Do not automatically retry a failed or indeterminate operation.
  *
  * Secret values are never returned or included in operation logs, traces, audit
  * events, or error details. This does not prevent an agent with unrestricted
@@ -1203,6 +1208,10 @@ export namespace VaultItem {
      */
     spec: ItemsAPI.CardVaultItemSpec;
 
+    /**
+     * Issued Link cards retain encrypted card material for the fill operation. Link
+     * cards do not expose aliases or support egress substitution.
+     */
     state: ItemsAPI.CardVaultItemState;
 
     type: 'card';
@@ -1397,6 +1406,10 @@ export namespace VaultItemOperationResponse {
      */
     spec: ItemsAPI.CardVaultItemSpec;
 
+    /**
+     * Issued Link cards retain encrypted card material for the fill operation. Link
+     * cards do not expose aliases or support egress substitution.
+     */
     state: ItemsAPI.CardVaultItemState;
 
     type: 'card';