@onkernel/sdk 0.11.1 → 0.11.2

package/resources/proxies.d.ts

@@ -0,0 +1,512 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Proxies extends APIResource {
+    /**
+     * Create a new proxy configuration for the caller's organization.
+     */
+    create(body: ProxyCreateParams, options?: RequestOptions): APIPromise<ProxyCreateResponse>;
+    /**
+     * Retrieve a proxy belonging to the caller's organization by ID.
+     */
+    retrieve(id: string, options?: RequestOptions): APIPromise<ProxyRetrieveResponse>;
+    /**
+     * List proxies owned by the caller's organization.
+     */
+    list(options?: RequestOptions): APIPromise<ProxyListResponse>;
+    /**
+     * Soft delete a proxy. Sessions referencing it are not modified.
+     */
+    delete(id: string, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * Configuration for routing traffic through a proxy.
+ */
+export interface ProxyCreateResponse {
+    /**
+     * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
+     * worst: `mobile` > `residential` > `isp` > `datacenter`.
+     */
+    type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
+    id?: string;
+    /**
+     * Configuration specific to the selected proxy `type`.
+     */
+    config?: ProxyCreateResponse.DatacenterProxyConfig | ProxyCreateResponse.IspProxyConfig | ProxyCreateResponse.ResidentialProxyConfig | ProxyCreateResponse.MobileProxyConfig | ProxyCreateResponse.CustomProxyConfig;
+    /**
+     * Readable name of the proxy.
+     */
+    name?: string;
+}
+export declare namespace ProxyCreateResponse {
+    /**
+     * Configuration for a datacenter proxy.
+     */
+    interface DatacenterProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for an ISP proxy.
+     */
+    interface IspProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for residential proxies.
+     */
+    interface ResidentialProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Operating system of the residential device.
+         */
+        os?: 'windows' | 'macos' | 'android';
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for mobile proxies.
+     */
+    interface MobileProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * Mobile carrier.
+         */
+        carrier?: 'a1' | 'aircel' | 'airtel' | 'att' | 'celcom' | 'chinamobile' | 'claro' | 'comcast' | 'cox' | 'digi' | 'dt' | 'docomo' | 'dtac' | 'etisalat' | 'idea' | 'kyivstar' | 'meo' | 'megafon' | 'mtn' | 'mtnza' | 'mts' | 'optus' | 'orange' | 'qwest' | 'reliance_jio' | 'robi' | 'sprint' | 'telefonica' | 'telstra' | 'tmobile' | 'tigo' | 'tim' | 'verizon' | 'vimpelcom' | 'vodacomza' | 'vodafone' | 'vivo' | 'zain' | 'vivabo' | 'telenormyanmar' | 'kcelljsc' | 'swisscom' | 'singtel' | 'asiacell' | 'windit' | 'cellc' | 'ooredoo' | 'drei' | 'umobile' | 'cableone' | 'proximus' | 'tele2' | 'mobitel' | 'o2' | 'bouygues' | 'free' | 'sfr' | 'digicel';
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for a custom proxy (e.g., private proxy server).
+     */
+    interface CustomProxyConfig {
+        /**
+         * Proxy host address or IP.
+         */
+        host: string;
+        /**
+         * Proxy port.
+         */
+        port: number;
+        /**
+         * Whether the proxy has a password.
+         */
+        has_password?: boolean;
+        /**
+         * Username for proxy authentication.
+         */
+        username?: string;
+    }
+}
+/**
+ * Configuration for routing traffic through a proxy.
+ */
+export interface ProxyRetrieveResponse {
+    /**
+     * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
+     * worst: `mobile` > `residential` > `isp` > `datacenter`.
+     */
+    type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
+    id?: string;
+    /**
+     * Configuration specific to the selected proxy `type`.
+     */
+    config?: ProxyRetrieveResponse.DatacenterProxyConfig | ProxyRetrieveResponse.IspProxyConfig | ProxyRetrieveResponse.ResidentialProxyConfig | ProxyRetrieveResponse.MobileProxyConfig | ProxyRetrieveResponse.CustomProxyConfig;
+    /**
+     * Readable name of the proxy.
+     */
+    name?: string;
+}
+export declare namespace ProxyRetrieveResponse {
+    /**
+     * Configuration for a datacenter proxy.
+     */
+    interface DatacenterProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for an ISP proxy.
+     */
+    interface IspProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for residential proxies.
+     */
+    interface ResidentialProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Operating system of the residential device.
+         */
+        os?: 'windows' | 'macos' | 'android';
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for mobile proxies.
+     */
+    interface MobileProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * Mobile carrier.
+         */
+        carrier?: 'a1' | 'aircel' | 'airtel' | 'att' | 'celcom' | 'chinamobile' | 'claro' | 'comcast' | 'cox' | 'digi' | 'dt' | 'docomo' | 'dtac' | 'etisalat' | 'idea' | 'kyivstar' | 'meo' | 'megafon' | 'mtn' | 'mtnza' | 'mts' | 'optus' | 'orange' | 'qwest' | 'reliance_jio' | 'robi' | 'sprint' | 'telefonica' | 'telstra' | 'tmobile' | 'tigo' | 'tim' | 'verizon' | 'vimpelcom' | 'vodacomza' | 'vodafone' | 'vivo' | 'zain' | 'vivabo' | 'telenormyanmar' | 'kcelljsc' | 'swisscom' | 'singtel' | 'asiacell' | 'windit' | 'cellc' | 'ooredoo' | 'drei' | 'umobile' | 'cableone' | 'proximus' | 'tele2' | 'mobitel' | 'o2' | 'bouygues' | 'free' | 'sfr' | 'digicel';
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for a custom proxy (e.g., private proxy server).
+     */
+    interface CustomProxyConfig {
+        /**
+         * Proxy host address or IP.
+         */
+        host: string;
+        /**
+         * Proxy port.
+         */
+        port: number;
+        /**
+         * Whether the proxy has a password.
+         */
+        has_password?: boolean;
+        /**
+         * Username for proxy authentication.
+         */
+        username?: string;
+    }
+}
+export type ProxyListResponse = Array<ProxyListResponse.ProxyListResponseItem>;
+export declare namespace ProxyListResponse {
+    /**
+     * Configuration for routing traffic through a proxy.
+     */
+    interface ProxyListResponseItem {
+        /**
+         * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
+         * worst: `mobile` > `residential` > `isp` > `datacenter`.
+         */
+        type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
+        id?: string;
+        /**
+         * Configuration specific to the selected proxy `type`.
+         */
+        config?: ProxyListResponseItem.DatacenterProxyConfig | ProxyListResponseItem.IspProxyConfig | ProxyListResponseItem.ResidentialProxyConfig | ProxyListResponseItem.MobileProxyConfig | ProxyListResponseItem.CustomProxyConfig;
+        /**
+         * Readable name of the proxy.
+         */
+        name?: string;
+    }
+    namespace ProxyListResponseItem {
+        /**
+         * Configuration for a datacenter proxy.
+         */
+        interface DatacenterProxyConfig {
+            /**
+             * ISO 3166 country code or EU for the proxy exit node.
+             */
+            country: string;
+        }
+        /**
+         * Configuration for an ISP proxy.
+         */
+        interface IspProxyConfig {
+            /**
+             * ISO 3166 country code or EU for the proxy exit node.
+             */
+            country: string;
+        }
+        /**
+         * Configuration for residential proxies.
+         */
+        interface ResidentialProxyConfig {
+            /**
+             * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+             */
+            asn?: string;
+            /**
+             * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+             * provided.
+             */
+            city?: string;
+            /**
+             * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+             * provided.
+             */
+            country?: string;
+            /**
+             * Operating system of the residential device.
+             */
+            os?: 'windows' | 'macos' | 'android';
+            /**
+             * Two-letter state code.
+             */
+            state?: string;
+            /**
+             * US ZIP code.
+             */
+            zip?: string;
+        }
+        /**
+         * Configuration for mobile proxies.
+         */
+        interface MobileProxyConfig {
+            /**
+             * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+             */
+            asn?: string;
+            /**
+             * Mobile carrier.
+             */
+            carrier?: 'a1' | 'aircel' | 'airtel' | 'att' | 'celcom' | 'chinamobile' | 'claro' | 'comcast' | 'cox' | 'digi' | 'dt' | 'docomo' | 'dtac' | 'etisalat' | 'idea' | 'kyivstar' | 'meo' | 'megafon' | 'mtn' | 'mtnza' | 'mts' | 'optus' | 'orange' | 'qwest' | 'reliance_jio' | 'robi' | 'sprint' | 'telefonica' | 'telstra' | 'tmobile' | 'tigo' | 'tim' | 'verizon' | 'vimpelcom' | 'vodacomza' | 'vodafone' | 'vivo' | 'zain' | 'vivabo' | 'telenormyanmar' | 'kcelljsc' | 'swisscom' | 'singtel' | 'asiacell' | 'windit' | 'cellc' | 'ooredoo' | 'drei' | 'umobile' | 'cableone' | 'proximus' | 'tele2' | 'mobitel' | 'o2' | 'bouygues' | 'free' | 'sfr' | 'digicel';
+            /**
+             * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+             * provided.
+             */
+            city?: string;
+            /**
+             * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+             * provided.
+             */
+            country?: string;
+            /**
+             * Two-letter state code.
+             */
+            state?: string;
+            /**
+             * US ZIP code.
+             */
+            zip?: string;
+        }
+        /**
+         * Configuration for a custom proxy (e.g., private proxy server).
+         */
+        interface CustomProxyConfig {
+            /**
+             * Proxy host address or IP.
+             */
+            host: string;
+            /**
+             * Proxy port.
+             */
+            port: number;
+            /**
+             * Whether the proxy has a password.
+             */
+            has_password?: boolean;
+            /**
+             * Username for proxy authentication.
+             */
+            username?: string;
+        }
+    }
+}
+export interface ProxyCreateParams {
+    /**
+     * Proxy type to use. In terms of quality for avoiding bot-detection, from best to
+     * worst: `mobile` > `residential` > `isp` > `datacenter`.
+     */
+    type: 'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom';
+    /**
+     * Configuration specific to the selected proxy `type`.
+     */
+    config?: ProxyCreateParams.DatacenterProxyConfig | ProxyCreateParams.IspProxyConfig | ProxyCreateParams.ResidentialProxyConfig | ProxyCreateParams.MobileProxyConfig | ProxyCreateParams.CreateCustomProxyConfig;
+    /**
+     * Readable name of the proxy.
+     */
+    name?: string;
+}
+export declare namespace ProxyCreateParams {
+    /**
+     * Configuration for a datacenter proxy.
+     */
+    interface DatacenterProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for an ISP proxy.
+     */
+    interface IspProxyConfig {
+        /**
+         * ISO 3166 country code or EU for the proxy exit node.
+         */
+        country: string;
+    }
+    /**
+     * Configuration for residential proxies.
+     */
+    interface ResidentialProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Operating system of the residential device.
+         */
+        os?: 'windows' | 'macos' | 'android';
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for mobile proxies.
+     */
+    interface MobileProxyConfig {
+        /**
+         * Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html
+         */
+        asn?: string;
+        /**
+         * Mobile carrier.
+         */
+        carrier?: 'a1' | 'aircel' | 'airtel' | 'att' | 'celcom' | 'chinamobile' | 'claro' | 'comcast' | 'cox' | 'digi' | 'dt' | 'docomo' | 'dtac' | 'etisalat' | 'idea' | 'kyivstar' | 'meo' | 'megafon' | 'mtn' | 'mtnza' | 'mts' | 'optus' | 'orange' | 'qwest' | 'reliance_jio' | 'robi' | 'sprint' | 'telefonica' | 'telstra' | 'tmobile' | 'tigo' | 'tim' | 'verizon' | 'vimpelcom' | 'vodacomza' | 'vodafone' | 'vivo' | 'zain' | 'vivabo' | 'telenormyanmar' | 'kcelljsc' | 'swisscom' | 'singtel' | 'asiacell' | 'windit' | 'cellc' | 'ooredoo' | 'drei' | 'umobile' | 'cableone' | 'proximus' | 'tele2' | 'mobitel' | 'o2' | 'bouygues' | 'free' | 'sfr' | 'digicel';
+        /**
+         * City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be
+         * provided.
+         */
+        city?: string;
+        /**
+         * ISO 3166 country code or EU for the proxy exit node. Required if `city` is
+         * provided.
+         */
+        country?: string;
+        /**
+         * Two-letter state code.
+         */
+        state?: string;
+        /**
+         * US ZIP code.
+         */
+        zip?: string;
+    }
+    /**
+     * Configuration for a custom proxy (e.g., private proxy server).
+     */
+    interface CreateCustomProxyConfig {
+        /**
+         * Proxy host address or IP.
+         */
+        host: string;
+        /**
+         * Proxy port.
+         */
+        port: number;
+        /**
+         * Password for proxy authentication.
+         */
+        password?: string;
+        /**
+         * Username for proxy authentication.
+         */
+        username?: string;
+    }
+}
+export declare namespace Proxies {
+    export { type ProxyCreateResponse as ProxyCreateResponse, type ProxyRetrieveResponse as ProxyRetrieveResponse, type ProxyListResponse as ProxyListResponse, type ProxyCreateParams as ProxyCreateParams, };
+}
+//# sourceMappingURL=proxies.d.ts.map

package/resources/proxies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.d.ts","sourceRoot":"","sources":["../src/resources/proxies.ts"],"names":[],"mappings":"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"}

package/resources/proxies.js

@@ -0,0 +1,38 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Proxies = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Proxies extends resource_1.APIResource {
+    /**
+     * Create a new proxy configuration for the caller's organization.
+     */
+    create(body, options) {
+        return this._client.post('/proxies', { body, ...options });
+    }
+    /**
+     * Retrieve a proxy belonging to the caller's organization by ID.
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/proxies/${id}`, options);
+    }
+    /**
+     * List proxies owned by the caller's organization.
+     */
+    list(options) {
+        return this._client.get('/proxies', options);
+    }
+    /**
+     * Soft delete a proxy. Sessions referencing it are not modified.
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/proxies/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Proxies = Proxies;
+//# sourceMappingURL=proxies.js.map

package/resources/proxies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.js","sourceRoot":"","sources":["../src/resources/proxies.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,YAAY,EAAE,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA/BD,0BA+BC"}

package/resources/proxies.mjs

@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Proxies extends APIResource {
+    /**
+     * Create a new proxy configuration for the caller's organization.
+     */
+    create(body, options) {
+        return this._client.post('/proxies', { body, ...options });
+    }
+    /**
+     * Retrieve a proxy belonging to the caller's organization by ID.
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/proxies/${id}`, options);
+    }
+    /**
+     * List proxies owned by the caller's organization.
+     */
+    list(options) {
+        return this._client.get('/proxies', options);
+    }
+    /**
+     * Soft delete a proxy. Sessions referencing it are not modified.
+     */
+    delete(id, options) {
+        return this._client.delete(path `/proxies/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=proxies.mjs.map

package/resources/proxies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.mjs","sourceRoot":"","sources":["../src/resources/proxies.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,MAAM,CAAC,IAAuB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,YAAY,EAAE,EAAE,EAAE;YAC/C,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/src/client.ts

@@ -43,6 +43,13 @@ import {
   Invocations,
 } from './resources/invocations';
 import { ProfileCreateParams, ProfileListResponse, Profiles } from './resources/profiles';
+import {
+  Proxies,
+  ProxyCreateParams,
+  ProxyCreateResponse,
+  ProxyListResponse,
+  ProxyRetrieveResponse,
+} from './resources/proxies';
 import {
   BrowserCreateParams,
   BrowserCreateResponse,
@@ -820,6 +827,7 @@ export class Kernel {
   invocations: API.Invocations = new API.Invocations(this);
   browsers: API.Browsers = new API.Browsers(this);
   profiles: API.Profiles = new API.Profiles(this);
+  proxies: API.Proxies = new API.Proxies(this);
 }
 
 Kernel.Deployments = Deployments;
@@ -827,6 +835,7 @@ Kernel.Apps = Apps;
 Kernel.Invocations = Invocations;
 Kernel.Browsers = Browsers;
 Kernel.Profiles = Profiles;
+Kernel.Proxies = Proxies;
 
 export declare namespace Kernel {
   export type RequestOptions = Opts.RequestOptions;
@@ -880,6 +889,14 @@ export declare namespace Kernel {
     type ProfileCreateParams as ProfileCreateParams,
   };
 
+  export {
+    Proxies as Proxies,
+    type ProxyCreateResponse as ProxyCreateResponse,
+    type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyListResponse as ProxyListResponse,
+    type ProxyCreateParams as ProxyCreateParams,
+  };
+
   export type AppAction = API.AppAction;
   export type ErrorDetail = API.ErrorDetail;
   export type ErrorEvent = API.ErrorEvent;

package/src/resources/browsers/browsers.ts

@@ -348,6 +348,12 @@ export interface BrowserCreateParams {
    */
   profile?: BrowserCreateParams.Profile;
 
+  /**
+   * Optional proxy to associate to the browser session. Must reference a proxy
+   * belonging to the caller's org.
+   */
+  proxy_id?: string;
+
   /**
    * If true, launches the browser in stealth mode to reduce detection by anti-bot
    * mechanisms.
@@ -357,7 +363,10 @@ export interface BrowserCreateParams {
   /**
    * The number of seconds of inactivity before the browser session is terminated.
    * Only applicable to non-persistent browsers. Activity includes CDP connections
-   * and live view connections. Defaults to 60 seconds.
+   * and live view connections. Defaults to 60 seconds. Minimum allowed is 10
+   * seconds. Maximum allowed is 86400 (24 hours). We check for inactivity every 5
+   * seconds, so the actual timeout behavior you will see is +/- 5 seconds around the
+   * specified value.
    */
   timeout_seconds?: number;
 }