@mobilerun/sdk 5.5.0 → 5.6.0

package/resources/workflows/workflows.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/resources/workflows/workflows.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,8EAAqD;AACrD,wDAK0B;AAC1B,+DAAsC;AACtC,wCAMkB;AAClB,uEAA8C;AAC9C,gDAQsB;AACtB,qEAA4C;AAC5C,8CAA8D;AAC9D,mEAA0C;AAC1C,4CAYoB;AACpB,yEAAgD;AAChD,kDAU2B;AAC3B,mEAA0C;AAC1C,4CAiBuB;AAEvB,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;CAAA;AARD,8BAQC;AAED,SAAS,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC9B,SAAS,CAAC,aAAa,GAAG,8BAAa,CAAC;AACxC,SAAS,CAAC,OAAO,GAAG,iBAAO,CAAC;AAC5B,SAAS,CAAC,KAAK,GAAG,aAAK,CAAC;AACxB,SAAS,CAAC,MAAM,GAAG,eAAM,CAAC;AAC1B,SAAS,CAAC,UAAU,GAAG,uBAAU,CAAC;AAClC,SAAS,CAAC,SAAS,GAAG,qBAAS,CAAC"}
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/resources/workflows/workflows.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,8EAAqD;AACrD,wDAK0B;AAC1B,+DAAsC;AACtC,wCAMkB;AAClB,qEAA4C;AAC5C,8CAA8D;AAC9D,mEAA0C;AAC1C,4CAYoB;AACpB,yEAAgD;AAChD,kDAU2B;AAC3B,kFAAyD;AACzD,2DAQiC;AACjC,mEAA0C;AAC1C,4CA4BuB;AAEvB,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;CAAA;AARD,8BAQC;AAED,SAAS,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC9B,SAAS,CAAC,aAAa,GAAG,8BAAa,CAAC;AACxC,SAAS,CAAC,OAAO,GAAG,iBAAO,CAAC;AAC5B,SAAS,CAAC,KAAK,GAAG,aAAK,CAAC;AACxB,SAAS,CAAC,MAAM,GAAG,eAAM,CAAC;AAC1B,SAAS,CAAC,UAAU,GAAG,uBAAU,CAAC;AAClC,SAAS,CAAC,SAAS,GAAG,qBAAS,CAAC"}

package/resources/workflows/workflows.mjs

@@ -4,14 +4,14 @@ import * as ActionCatalogAPI from "./action-catalog.mjs";
 import { ActionCatalog, } from "./action-catalog.mjs";
 import * as EventsAPI from "./events.mjs";
 import { Events, } from "./events.mjs";
-import * as ExecutionsAPI from "./executions.mjs";
-import { Executions, } from "./executions.mjs";
 import * as TimezonesAPI from "./timezones.mjs";
 import { Timezones } from "./timezones.mjs";
 import * as TriggersAPI from "./triggers.mjs";
 import { Triggers, } from "./triggers.mjs";
 import * as ActionsAPI from "./actions/actions.mjs";
 import { Actions, } from "./actions/actions.mjs";
+import * as ExecutionsAPI from "./executions/executions.mjs";
+import { Executions, } from "./executions/executions.mjs";
 import * as FlowsAPI from "./flows/flows.mjs";
 import { Flows, } from "./flows/flows.mjs";
 export class Workflows extends APIResource {

package/resources/workflows/workflows.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.mjs","sourceRoot":"","sources":["../../src/resources/workflows/workflows.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,6BAAyB;AACrD,OAAO,EACL,aAAa,GAId,6BAAyB;AAC1B,OAAO,KAAK,SAAS,qBAAiB;AACtC,OAAO,EAKL,MAAM,GACP,qBAAiB;AAClB,OAAO,KAAK,aAAa,yBAAqB;AAC9C,OAAO,EAOL,UAAU,GACX,yBAAqB;AACtB,OAAO,KAAK,YAAY,wBAAoB;AAC5C,OAAO,EAAwB,SAAS,EAAE,wBAAoB;AAC9D,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAWL,QAAQ,GACT,uBAAmB;AACpB,OAAO,KAAK,UAAU,8BAA0B;AAChD,OAAO,EASL,OAAO,GACR,8BAA0B;AAC3B,OAAO,KAAK,QAAQ,0BAAsB;AAC1C,OAAO,EAgBL,KAAK,GACN,0BAAsB;AAEvB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;CAAA;AAED,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;AACxC,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;AAC5B,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;AACxB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;AAC1B,SAAS,CAAC,UAAU,GAAG,UAAU,CAAC;AAClC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC"}
+{"version":3,"file":"workflows.mjs","sourceRoot":"","sources":["../../src/resources/workflows/workflows.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,6BAAyB;AACrD,OAAO,EACL,aAAa,GAId,6BAAyB;AAC1B,OAAO,KAAK,SAAS,qBAAiB;AACtC,OAAO,EAKL,MAAM,GACP,qBAAiB;AAClB,OAAO,KAAK,YAAY,wBAAoB;AAC5C,OAAO,EAAwB,SAAS,EAAE,wBAAoB;AAC9D,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAWL,QAAQ,GACT,uBAAmB;AACpB,OAAO,KAAK,UAAU,8BAA0B;AAChD,OAAO,EASL,OAAO,GACR,8BAA0B;AAC3B,OAAO,KAAK,aAAa,oCAAgC;AACzD,OAAO,EAOL,UAAU,GACX,oCAAgC;AACjC,OAAO,KAAK,QAAQ,0BAAsB;AAC1C,OAAO,EA2BL,KAAK,GACN,0BAAsB;AAEvB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjG,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,WAAM,GAAqB,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,eAAU,GAA6B,IAAI,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;CAAA;AAED,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC;AACxC,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;AAC5B,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;AACxB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;AAC1B,SAAS,CAAC,UAAU,GAAG,UAAU,CAAC;AAClC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC"}

package/src/client.ts

@@ -57,6 +57,8 @@ import {
 } from './resources/files';
 import { ModelListResponse, Models } from './resources/models';
 import {
+  NotificationApplyPreferencesPresetParams,
+  NotificationApplyPreferencesPresetResponse,
   NotificationCatalogResponse,
   NotificationGetPreferencesResponse,
   NotificationUpdatePreferencesParams,
@@ -112,6 +114,8 @@ import {
   DeviceRetrieveResponse,
   DeviceSetNameParams,
   DeviceSetNameResponse,
+  DeviceSummaryParams,
+  DeviceSummaryResponse,
   DeviceTerminateParams,
   DeviceWaitReadyResponse,
   Devices,
@@ -121,6 +125,7 @@ import {
   MailboxCreateParams,
   MailboxCreateResponse,
   MailboxDeleteResponse,
+  MailboxDisconnectResponse,
   MailboxListParams,
   MailboxListResponse,
   MailboxOtpParams,
@@ -133,7 +138,12 @@ import {
   MailboxUpdateResponse,
   Mailboxes,
 } from './resources/mailboxes/mailboxes';
-import { MessageListParams, MessageListResponse, Messages } from './resources/messages/messages';
+import {
+  MessageListParams,
+  MessageListResponse,
+  MessageRetrieveResponse,
+  Messages,
+} from './resources/messages/messages';
 import {
   NumberCapacityParams,
   NumberCapacityResponse,
@@ -336,6 +346,7 @@ export class Mobilerun {
     }
 
     this._options = options;
+    this.idempotencyHeader = 'Idempotency-Key';
 
     this.apiKey = apiKey;
   }
@@ -995,11 +1006,13 @@ export declare namespace Mobilerun {
     type DeviceFingerprintResponse as DeviceFingerprintResponse,
     type DeviceRetrieveCapabilitiesResponse as DeviceRetrieveCapabilitiesResponse,
     type DeviceSetNameResponse as DeviceSetNameResponse,
+    type DeviceSummaryResponse as DeviceSummaryResponse,
     type DeviceWaitReadyResponse as DeviceWaitReadyResponse,
     type DeviceCreateParams as DeviceCreateParams,
     type DeviceListParams as DeviceListParams,
     type DeviceFingerprintParams as DeviceFingerprintParams,
     type DeviceSetNameParams as DeviceSetNameParams,
+    type DeviceSummaryParams as DeviceSummaryParams,
     type DeviceTerminateParams as DeviceTerminateParams,
   };
 
@@ -1073,6 +1086,7 @@ export declare namespace Mobilerun {
     type MailboxListResponse as MailboxListResponse,
     type MailboxDeleteResponse as MailboxDeleteResponse,
     type MailboxCapacityResponse as MailboxCapacityResponse,
+    type MailboxDisconnectResponse as MailboxDisconnectResponse,
     type MailboxOtpResponse as MailboxOtpResponse,
     type MailboxRestartResponse as MailboxRestartResponse,
     type MailboxUncancelResponse as MailboxUncancelResponse,
@@ -1107,14 +1121,17 @@ export declare namespace Mobilerun {
 
   export {
     Notifications as Notifications,
+    type NotificationApplyPreferencesPresetResponse as NotificationApplyPreferencesPresetResponse,
     type NotificationCatalogResponse as NotificationCatalogResponse,
     type NotificationGetPreferencesResponse as NotificationGetPreferencesResponse,
     type NotificationUpdatePreferencesResponse as NotificationUpdatePreferencesResponse,
+    type NotificationApplyPreferencesPresetParams as NotificationApplyPreferencesPresetParams,
     type NotificationUpdatePreferencesParams as NotificationUpdatePreferencesParams,
   };
 
   export {
     Messages as Messages,
+    type MessageRetrieveResponse as MessageRetrieveResponse,
     type MessageListResponse as MessageListResponse,
     type MessageListParams as MessageListParams,
   };

package/src/resources/apps.ts

@@ -123,8 +123,11 @@ export class Apps extends APIResource {
   }
 
   /**
-   * Returns the user’s total storage quota, bytes used, and remaining bytes — the
-   * reliable maximum size for the next upload.
+   * Returns the user’s storage allowance from Autumn storage_mb (decimal bytes):
+   * bytes used, bytes included in the plan, the hard maximum (included + max
+   * purchasable overage; null = unlimited) and whether usage above the included
+   * amount is billed as overage. With storage billing off there is no limit: only
+   * usedBytes is set.
    *
    * @example
    * ```ts
@@ -473,7 +476,7 @@ export namespace AppListResponse {
 
       sizeBytes: number | null;
 
-      source: 'user' | 'system' | 'portal' | 'store' | 'catalog';
+      source: 'user' | 'system' | 'portal' | 'store';
 
       status: 'queued' | 'available' | 'failed';
 
@@ -804,7 +807,7 @@ export namespace AppListVersionsResponse {
 
     sizeBytes: number | null;
 
-    source: 'user' | 'system' | 'portal' | 'store' | 'catalog';
+    source: 'user' | 'system' | 'portal' | 'store';
 
     status: 'queued' | 'available' | 'failed';
 
@@ -836,26 +839,26 @@ export interface AppStorageUsageResponse {
 export namespace AppStorageUsageResponse {
   export interface Data {
     /**
-     * Remaining bytes — the reliable maximum TOTAL size for the next upload. Advisory
-     * snapshot: the quota is enforced under a lock at confirm, so concurrent uploads
-     * may reduce actual headroom.
+     * Bytes included in the plan (Autumn granted). Null when unlimited, unknown, or
+     * storage billing is off.
      */
-    availableBytes: number;
+    includedBytes: number | null;
 
     /**
-     * Per-file upload cap in bytes (env.MAX_UPLOAD_FILE_BYTES). A single file larger
-     * than this is rejected at confirm even when it fits the remaining quota. Source
-     * of truth for the client-side per-file limit.
+     * Hard admission bound in bytes: included + max purchasable overage, or included
+     * when overage is not allowed. Null = unlimited, unknown, or storage billing is
+     * off.
      */
-    maxFileBytes: number;
+    maxBytes: number | null;
 
     /**
-     * Total storage allowance for the user, in bytes
+     * True when usage above includedBytes is billed as overage instead of blocked
      */
-    quotaBytes: number;
+    overageAllowed: boolean;
 
     /**
-     * Bytes currently consumed across all of the user’s app versions
+     * Bytes currently used (decimal: Autumn storage_mb × 1,000,000; the local sum of
+     * the user’s app versions when storage billing is off)
      */
     usedBytes: number;
   }

package/src/resources/assistant/conversations.ts

@@ -12,18 +12,11 @@ export class Conversations extends APIResource {
    * Creates a titled agent session. Setup may occur on the first prompt. Idempotent
    * via the `Idempotency-Key` header — a duplicate submit by the same authenticated
    * caller within the 24-hour idempotency window returns the already-created session
-   * instead of a second one.
+   * instead of a second one. Reusing the same key with a different request body is a
+   * 422 `idempotency_key_reused`.
    */
-  create(params: ConversationCreateParams, options?: RequestOptions): APIPromise<ConversationCreateResponse> {
-    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
-    return this._client.post('/assistant/chat/sessions', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-        options?.headers,
-      ]),
-    });
+  create(body: ConversationCreateParams, options?: RequestOptions): APIPromise<ConversationCreateResponse> {
+    return this._client.post('/assistant/chat/sessions', { body, ...options });
   }
 
   /**
@@ -167,6 +160,8 @@ export namespace ConversationCreateResponse {
 
     createdAt: string;
 
+    creditsUsed: number | null;
+
     description: string | null;
 
     lastActiveAt: string;
@@ -209,6 +204,8 @@ export namespace ConversationUpdateResponse {
 
     createdAt: string;
 
+    creditsUsed: number | null;
+
     description: string | null;
 
     lastActiveAt: string;
@@ -251,6 +248,8 @@ export namespace ConversationListResponse {
 
     createdAt: string;
 
+    creditsUsed: number | null;
+
     description: string | null;
 
     episode: number;
@@ -295,6 +294,8 @@ export namespace ConversationListResponse {
 
     createdAt: string;
 
+    creditsUsed: number | null;
+
     description: string | null;
 
     episode: number;
@@ -429,27 +430,11 @@ export interface ConversationSendResponse {
 export type ConversationStreamResponse = string;
 
 export interface ConversationCreateParams {
-  /**
-   * Body param
-   */
   title: string;
 
-  /**
-   * Body param
-   */
   agent?: string;
 
-  /**
-   * Body param
-   */
   description?: string;
-
-  /**
-   * Header param: Optional client key. Reusing the same key with the same request
-   * body by the same authenticated caller within 24 hours returns the
-   * already-created session instead of a second one.
-   */
-  'Idempotency-Key'?: string;
 }
 
 export interface ConversationUpdateParams {

package/src/resources/connect/connect.ts

@@ -8,12 +8,15 @@ import {
   Proxies,
   ProxyBuyParams,
   ProxyBuyResponse,
+  ProxyEnsureHealthyResponse,
   ProxyListConnectionsParams,
   ProxyListConnectionsResponse,
   ProxyListParams,
   ProxyListResponse,
   ProxyPingResponse,
   ProxyRetrieveResponse,
+  ProxyUpdateParams,
+  ProxyUpdateResponse,
 } from './proxies';
 import * as UsersAPI from './users';
 import {
@@ -49,10 +52,13 @@ export declare namespace Connect {
   export {
     Proxies as Proxies,
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyUpdateResponse as ProxyUpdateResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyBuyResponse as ProxyBuyResponse,
+    type ProxyEnsureHealthyResponse as ProxyEnsureHealthyResponse,
     type ProxyListConnectionsResponse as ProxyListConnectionsResponse,
     type ProxyPingResponse as ProxyPingResponse,
+    type ProxyUpdateParams as ProxyUpdateParams,
     type ProxyListParams as ProxyListParams,
     type ProxyBuyParams as ProxyBuyParams,
     type ProxyListConnectionsParams as ProxyListConnectionsParams,

package/src/resources/connect/index.ts

@@ -5,10 +5,13 @@ export { Countries, type CountryListResponse, type CountryListParams } from './c
 export {
   Proxies,
   type ProxyRetrieveResponse,
+  type ProxyUpdateResponse,
   type ProxyListResponse,
   type ProxyBuyResponse,
+  type ProxyEnsureHealthyResponse,
   type ProxyListConnectionsResponse,
   type ProxyPingResponse,
+  type ProxyUpdateParams,
   type ProxyListParams,
   type ProxyBuyParams,
   type ProxyListConnectionsParams,

package/src/resources/connect/proxies.ts

@@ -15,6 +15,13 @@ export class Proxies extends APIResource {
     return this._client.get(path`/connect/proxies/${id}`, options);
   }
 
+  /**
+   * Renames the proxy identified by the path ID.
+   */
+  update(id: string, body: ProxyUpdateParams, options?: RequestOptions): APIPromise<ProxyUpdateResponse> {
+    return this._client.patch(path`/connect/proxies/${id}`, { body, ...options });
+  }
+
   /**
    * Returns proxies owned by the calling tenant (the X-Owner-Id header, falling back
    * to X-User-ID). Credentials are omitted from the list.
@@ -29,16 +36,8 @@ export class Proxies extends APIResource {
   /**
    * Provisions a proxy of the requested type for the caller in the selected country.
    */
-  buy(params: ProxyBuyParams, options?: RequestOptions): APIPromise<ProxyBuyResponse> {
-    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
-    return this._client.post('/connect/proxies', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-        options?.headers,
-      ]),
-    });
+  buy(body: ProxyBuyParams, options?: RequestOptions): APIPromise<ProxyBuyResponse> {
+    return this._client.post('/connect/proxies', { body, ...options });
   }
 
   /**
@@ -52,6 +51,20 @@ export class Proxies extends APIResource {
     });
   }
 
+  /**
+   * Checks right now that the proxy's upstream accepts a connection through its
+   * current session. If the upstream refuses the session and the proxy is a rotating
+   * (sticky-session) proxy, the proxy is moved onto a fresh session that has been
+   * checked to work; its credentials and country stay the same, its exit IP changes.
+   * Intended for callers that are about to depend on the proxy (e.g. while
+   * provisioning a phone). After `rotated`, the gateway uses the new session within
+   * about 30 seconds. A `refused` or `unreachable` result is not an error: the
+   * response describes the proxy's state.
+   */
+  ensureHealthy(id: string, options?: RequestOptions): APIPromise<ProxyEnsureHealthyResponse> {
+    return this._client.post(path`/connect/proxies/${id}/ensure-healthy`, options);
+  }
+
   /**
    * Returns the connection history recorded for this proxy, one item per connection
    * (aggregated across the connection's lifetime). Supports filtering on every
@@ -92,6 +105,13 @@ export interface ProxyRetrieveResponse {
 
   host: string;
 
+  /**
+   * Display name for the proxy. Set it on create or change it with PATCH; when no
+   * name has been set, a label generated from the proxy's country, type, and id is
+   * returned instead — so this is never empty.
+   */
+  name: string;
+
   password: string;
 
   port: number;
@@ -119,6 +139,47 @@ export interface ProxyRetrieveResponse {
   paymentUrl?: string | null;
 }
 
+/**
+ * A provisioned proxy without its credentials.
+ */
+export interface ProxyUpdateResponse {
+  id: string;
+
+  /**
+   * ISO 3166-1 alpha-2 country code (lowercase).
+   */
+  country: string;
+
+  createdAt: string;
+
+  host: string;
+
+  /**
+   * Display name for the proxy. Set it on create or change it with PATCH; when no
+   * name has been set, a label generated from the proxy's country, type, and id is
+   * returned instead — so this is never empty.
+   */
+  name: string;
+
+  port: number;
+
+  /**
+   * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+   * identity is being resolved — clients should poll until a `paymentUrl` or a later
+   * status appears — then `provisioning` — or `pending_payment` until the customer
+   * completes checkout — and becomes `active` once its upstream is assigned.
+   * `cancelling` retains full access through the paid period; when the subscription
+   * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
+   */
+  status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+
+  type: 'dedicated_residential' | 'residential' | 'mobile';
+
+  username: string;
+
+  billingMode?: 'included' | 'standalone_paid';
+}
+
 /**
  * A page of proxies.
  */
@@ -147,6 +208,13 @@ export namespace ProxyListResponse {
 
     host: string;
 
+    /**
+     * Display name for the proxy. Set it on create or change it with PATCH; when no
+     * name has been set, a label generated from the proxy's country, type, and id is
+     * returned instead — so this is never empty.
+     */
+    name: string;
+
     port: number;
 
     /**
@@ -217,6 +285,13 @@ export interface ProxyBuyResponse {
 
   host: string;
 
+  /**
+   * Display name for the proxy. Set it on create or change it with PATCH; when no
+   * name has been set, a label generated from the proxy's country, type, and id is
+   * returned instead — so this is never empty.
+   */
+  name: string;
+
   password: string;
 
   port: number;
@@ -244,6 +319,22 @@ export interface ProxyBuyResponse {
   paymentUrl?: string | null;
 }
 
+/**
+ * The outcome of an ensure-healthy check.
+ */
+export interface ProxyEnsureHealthyResponse {
+  proxyId: string;
+
+  /**
+   * `healthy`: the upstream accepted the current session. `rotated`: the session was
+   * refused and the proxy now uses a fresh, checked session; retry through the
+   * proxy. `refused`: the session was refused and could not be replaced.
+   * `unreachable`: the upstream could not be reached; the session was left
+   * unchanged.
+   */
+  status: 'healthy' | 'rotated' | 'refused' | 'unreachable';
+}
+
 /**
  * A page of connections.
  */
@@ -446,6 +537,16 @@ export namespace ProxyPingResponse {
   }
 }
 
+export interface ProxyUpdateParams {
+  /**
+   * New display name, up to 64 characters excluding surrounding whitespace, and
+   * containing no NUL. Send null (or an empty/whitespace-only string) to drop a
+   * custom name and go back to the generated label. Omit to leave the name
+   * unchanged.
+   */
+  name?: string | null;
+}
+
 export interface ProxyListParams {
   /**
    * Filter to proxies in this country (ISO 3166-1 alpha-2, lowercase).
@@ -465,22 +566,18 @@ export interface ProxyListParams {
 
 export interface ProxyBuyParams {
   /**
-   * Body param: ISO 3166-1 alpha-2 country code to provision the proxy in.
+   * ISO 3166-1 alpha-2 country code to provision the proxy in.
    */
   country: string;
 
-  /**
-   * Body param
-   */
   type: 'dedicated_residential' | 'residential' | 'mobile';
 
   /**
-   * Header param: Optional idempotency key, unique per owner (1-128 characters after
-   * trimming; surrounding whitespace is ignored). Reusing a key returns the
-   * originally created proxy with its original credentials, regardless of changed
-   * request parameters.
+   * Display name for the proxy, up to 64 characters excluding surrounding
+   * whitespace, and containing no NUL. Omit it (or send only whitespace) to get a
+   * generated label built from the country, type, and id.
    */
-  'Idempotency-Key'?: string;
+  name?: string;
 }
 
 export interface ProxyListConnectionsParams {
@@ -615,10 +712,13 @@ export interface ProxyListConnectionsParams {
 export declare namespace Proxies {
   export {
     type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyUpdateResponse as ProxyUpdateResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyBuyResponse as ProxyBuyResponse,
+    type ProxyEnsureHealthyResponse as ProxyEnsureHealthyResponse,
     type ProxyListConnectionsResponse as ProxyListConnectionsResponse,
     type ProxyPingResponse as ProxyPingResponse,
+    type ProxyUpdateParams as ProxyUpdateParams,
     type ProxyListParams as ProxyListParams,
     type ProxyBuyParams as ProxyBuyParams,
     type ProxyListConnectionsParams as ProxyListConnectionsParams,

package/src/resources/devices/browser.ts

@@ -8,9 +8,15 @@ import { path } from '../../internal/utils/path';
 
 export class Browser extends APIResource {
   /**
-   * Evaluates a JavaScript expression in the device's foreground Chrome tab via the
-   * Chrome DevTools Protocol and returns its JSON-serialized result. Devices without
-   * browser support return an unsupported-feature error.
+   * Evaluates a JavaScript expression exactly once in the device's single, confirmed
+   * foreground Chrome tab via the Chrome DevTools Protocol and returns its
+   * JSON-serialized result. A responsive browser state without exactly one visible
+   * page returns DEVICE_NO_BROWSER_TARGET (400). Transient discovery, page-dial, or
+   * visibility-probe transport failures return CDP_TRANSPORT_UNAVAILABLE (503) with
+   * Retry-After and an executionOutcome; the service may start Chrome once and retry
+   * selection before Runtime.evaluate, but dial or probe recovery is skipped for a
+   * backgrounded Chrome, and a user script is never retried after its write or read.
+   * Devices without browser support return an unsupported-feature error.
    */
   executeScript(
     deviceID: string,