anchorbrowser 1.0.0-dev.0 → 1.0.0-dev.2

package/resources/tasks/tasks.d.mts

@@ -0,0 +1,310 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as GenerationsAPI from "./generations.mjs";
+import { GenerationGetStatusResponse, Generations } from "./generations.mjs";
+import * as RunsAPI from "./runs.mjs";
+import { RunGetStatusResponse, Runs } from "./runs.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Tasks extends APIResource {
+    runs: RunsAPI.Runs;
+    generations: GenerationsAPI.Generations;
+    /**
+     * Initiates asynchronous task generation. Use the returned task ID to poll for
+     * completion, then execute the task.
+     *
+     * @example
+     * ```ts
+     * const response = await client.tasks.generate({
+     *   description: 'Download a specific file from a URL',
+     *   name: 'file-downloader',
+     *   user_task: 'Create a task that downloads a specific file from a given URL.',
+     *   input_schema: [
+     *     {
+     *       display_name: 'URL',
+     *       type: 'string',
+     *       required: true,
+     *       description: 'URL of the file to download',
+     *     },
+     *     {
+     *       display_name: 'File Name',
+     *       type: 'string',
+     *       required: true,
+     *       description: 'Name of the file to download',
+     *     },
+     *   ],
+     *   output_schema: [
+     *     {
+     *       display_name: 'Success',
+     *       type: 'boolean',
+     *       description: 'Whether the download succeeded',
+     *     },
+     *     {
+     *       display_name: 'Message',
+     *       type: 'string',
+     *       description: 'Status or error message',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    generate(body: TaskGenerateParams, options?: RequestOptions): APIPromise<TaskGenerateResponse>;
+    /**
+     * Triggers execution of a task by ID using the V2 tasks API.
+     *
+     * @example
+     * ```ts
+     * const response = await client.tasks.run('taskId', {
+     *   input_params: {
+     *     'File Name': 'invoice-2026-02.pdf',
+     *     Operation: 'extract_text',
+     *   },
+     * });
+     * ```
+     */
+    run(taskID: string, body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse>;
+}
+/**
+ * Response when task generation has been started (generation is asynchronous).
+ */
+export interface TaskGenerateResponse {
+    /**
+     * The ID of the created task (use with generation-status and run endpoints)
+     */
+    id: string;
+    /**
+     * Whether the task is still generating, ready to run, or failed.
+     */
+    status: 'generating';
+}
+export interface TaskRunResponse {
+    /**
+     * The ID of the task run
+     */
+    run_id: string;
+    /**
+     * Current task run status
+     */
+    status: 'queued' | 'running' | 'success' | 'failure' | 'timeout' | 'cancelled';
+    /**
+     * Error message when the run fails
+     */
+    error?: string;
+    /**
+     * Task output when available
+     */
+    result?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Session ID used for this task run
+     */
+    session_id?: string;
+}
+export interface TaskGenerateParams {
+    /**
+     * Description of the task
+     */
+    description: string;
+    /**
+     * Name of the task
+     */
+    name: string;
+    /**
+     * Natural language description of what the task should do (used for AI generation)
+     */
+    user_task: string;
+    /**
+     * Optional application (connection) ID to associate with the task
+     */
+    application_id?: string;
+    /**
+     * Optional list of input parameters for the task. Defaults to empty array.
+     */
+    input_schema?: Array<TaskGenerateParams.InputSchema>;
+    /**
+     * Optional list of output parameters for the task. Defaults to empty array.
+     */
+    output_schema?: Array<TaskGenerateParams.OutputSchema>;
+    /**
+     * Optional default browser/session configuration when running this task
+     */
+    task_browser_default_configuration?: TaskGenerateParams.TaskBrowserDefaultConfiguration;
+}
+export declare namespace TaskGenerateParams {
+    /**
+     * A single input or output parameter for a generated task.
+     */
+    interface InputSchema {
+        /**
+         * Human-readable name for the parameter
+         */
+        display_name: string;
+        /**
+         * Data type of the parameter
+         */
+        type: 'string' | 'number' | 'boolean' | 'date';
+        /**
+         * Optional default value as a string
+         */
+        default_value?: string;
+        /**
+         * Optional description of the parameter
+         */
+        description?: string;
+        /**
+         * Whether the parameter is required
+         */
+        required?: boolean;
+    }
+    /**
+     * A single input or output parameter for a generated task.
+     */
+    interface OutputSchema {
+        /**
+         * Human-readable name for the parameter
+         */
+        display_name: string;
+        /**
+         * Data type of the parameter
+         */
+        type: 'string' | 'number' | 'boolean' | 'date';
+        /**
+         * Optional default value as a string
+         */
+        default_value?: string;
+        /**
+         * Optional description of the parameter
+         */
+        description?: string;
+        /**
+         * Whether the parameter is required
+         */
+        required?: boolean;
+    }
+    /**
+     * Optional default browser/session configuration when running this task
+     */
+    interface TaskBrowserDefaultConfiguration {
+        /**
+         * The URL to navigate to when the browser session starts. If not provided, the
+         * browser will load an empty page.
+         */
+        initial_url?: string;
+        /**
+         * Configuration for live viewing the browser session.
+         */
+        live_view?: TaskBrowserDefaultConfiguration.LiveView;
+        /**
+         * Proxy Documentation available at [Proxy Documentation](/advanced/proxy)
+         */
+        proxy?: TaskBrowserDefaultConfiguration.AnchorProxy | TaskBrowserDefaultConfiguration.CustomProxy;
+        /**
+         * Configuration for session recording.
+         */
+        recording?: TaskBrowserDefaultConfiguration.Recording;
+        /**
+         * Timeout configurations for the browser session.
+         */
+        timeout?: TaskBrowserDefaultConfiguration.Timeout;
+    }
+    namespace TaskBrowserDefaultConfiguration {
+        /**
+         * Configuration for live viewing the browser session.
+         */
+        interface LiveView {
+            /**
+             * Enable or disable read-only mode for live viewing. Defaults to `false`.
+             */
+            read_only?: boolean;
+        }
+        interface AnchorProxy {
+            active: boolean;
+            /**
+             * City name for precise geographic targeting. Supported for anchor_proxy only. Can
+             * only be used when region is also provided.
+             */
+            city?: string;
+            /**
+             * Supported country codes ISO 2 lowercase
+             */
+            country_code?: 'af' | 'al' | 'dz' | 'ad' | 'ao' | 'as' | 'ag' | 'ar' | 'am' | 'aw' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bb' | 'by' | 'be' | 'bz' | 'bj' | 'bm' | 'bo' | 'ba' | 'br' | 'bg' | 'bf' | 'cm' | 'ca' | 'cv' | 'td' | 'cl' | 'co' | 'cg' | 'cr' | 'ci' | 'hr' | 'cu' | 'cy' | 'cz' | 'dk' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'ee' | 'et' | 'fo' | 'fi' | 'fr' | 'gf' | 'pf' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gd' | 'gp' | 'gt' | 'gg' | 'gn' | 'gw' | 'gy' | 'ht' | 'hn' | 'hu' | 'is' | 'in' | 'ir' | 'iq' | 'ie' | 'il' | 'it' | 'jm' | 'jp' | 'jo' | 'kz' | 'kw' | 'kg' | 'lv' | 'lb' | 'ly' | 'li' | 'lt' | 'lu' | 'mk' | 'ml' | 'mt' | 'mq' | 'mr' | 'mx' | 'md' | 'mc' | 'me' | 'ma' | 'nl' | 'nz' | 'ni' | 'ng' | 'no' | 'pk' | 'pa' | 'py' | 'pe' | 'ph' | 'pl' | 'pt' | 'pr' | 'qa' | 'ro' | 'lc' | 'sm' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sk' | 'si' | 'so' | 'za' | 'kr' | 'es' | 'sr' | 'se' | 'ch' | 'sy' | 'st' | 'tw' | 'tj' | 'tg' | 'tt' | 'tn' | 'tr' | 'tc' | 'ua' | 'ae' | 'us' | 'uy' | 'uz' | 've' | 'ye';
+            /**
+             * Region code for more specific geographic targeting. The city parameter can only
+             * be used when region is also provided.
+             */
+            region?: string;
+            /**
+             * Create a session with a proxy to access websites as if you're browsing from a
+             * computer in that country.
+             */
+            type?: 'anchor_proxy';
+        }
+        interface CustomProxy {
+            active: boolean;
+            /**
+             * Proxy password
+             */
+            password: string;
+            /**
+             * Proxy address in **PROTOCOL://HOST:PORT** format (e.g.,
+             * https://proxy.example.com:443). See [proxy page](/advanced/proxy#custom-proxy).
+             */
+            server: string;
+            type: 'custom';
+            /**
+             * Proxy username
+             */
+            username: string;
+        }
+        /**
+         * Configuration for session recording.
+         */
+        interface Recording {
+            /**
+             * Enable or disable video recording of the browser session. Defaults to `true`.
+             */
+            active?: boolean;
+        }
+        /**
+         * Timeout configurations for the browser session.
+         */
+        interface Timeout {
+            /**
+             * The amount of time (in minutes) the browser session waits for new connections
+             * after all others are closed before stopping. Defaults to `5`.
+             */
+            idle_timeout?: number;
+            /**
+             * Maximum amount of time (in minutes) for the browser to run before terminating.
+             * Defaults to `20`.
+             */
+            max_duration?: number;
+        }
+    }
+}
+export interface TaskRunParams {
+    /**
+     * Key-value pairs of input parameters for the task
+     */
+    input_params: {
+        [key: string]: string;
+    };
+    /**
+     * Whether to clean up sessions after execution
+     */
+    cleanup_sessions?: boolean;
+    /**
+     * Optional identity ID to use for the task
+     */
+    identity_id?: string;
+    /**
+     * Optional session ID to run the task in
+     */
+    session_id?: string;
+}
+export declare namespace Tasks {
+    export { type TaskGenerateResponse as TaskGenerateResponse, type TaskRunResponse as TaskRunResponse, type TaskGenerateParams as TaskGenerateParams, type TaskRunParams as TaskRunParams, };
+    export { Runs as Runs, type RunGetStatusResponse as RunGetStatusResponse };
+    export { Generations as Generations, type GenerationGetStatusResponse as GenerationGetStatusResponse };
+}
+//# sourceMappingURL=tasks.d.mts.map

package/resources/tasks/tasks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.mts","sourceRoot":"","sources":["../../src/resources/tasks/tasks.ts"],"names":[],"mappings":"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CT,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;YAET;;;eAGG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;;eAGG;YACH,IAAI,CAAC,EAAE,cAAc,CAAC;SACvB;QAED,UAAiB,WAAW;YAC1B,MAAM,EAAE,OAAO,CAAC;YAEhB;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YAEjB;;;eAGG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf,IAAI,EAAE,QAAQ,CAAC;YAEf;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;SAClB;QAED;;WAEG;QACH,UAAiB,SAAS;YACxB;;eAEG;YACH,MAAM,CAAC,EAAE,OAAO,CAAC;SAClB;QAED;;WAEG;QACH,UAAiB,OAAO;YACtB;;;eAGG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;YAEtB;;;eAGG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB;KACF;CACF;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,aAAa,IAAI,aAAa,GACpC,CAAC;IAEF,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;IAE3E,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;CACxG"}

package/resources/tasks/tasks.d.ts

@@ -0,0 +1,310 @@
+import { APIResource } from "../../core/resource.js";
+import * as GenerationsAPI from "./generations.js";
+import { GenerationGetStatusResponse, Generations } from "./generations.js";
+import * as RunsAPI from "./runs.js";
+import { RunGetStatusResponse, Runs } from "./runs.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Tasks extends APIResource {
+    runs: RunsAPI.Runs;
+    generations: GenerationsAPI.Generations;
+    /**
+     * Initiates asynchronous task generation. Use the returned task ID to poll for
+     * completion, then execute the task.
+     *
+     * @example
+     * ```ts
+     * const response = await client.tasks.generate({
+     *   description: 'Download a specific file from a URL',
+     *   name: 'file-downloader',
+     *   user_task: 'Create a task that downloads a specific file from a given URL.',
+     *   input_schema: [
+     *     {
+     *       display_name: 'URL',
+     *       type: 'string',
+     *       required: true,
+     *       description: 'URL of the file to download',
+     *     },
+     *     {
+     *       display_name: 'File Name',
+     *       type: 'string',
+     *       required: true,
+     *       description: 'Name of the file to download',
+     *     },
+     *   ],
+     *   output_schema: [
+     *     {
+     *       display_name: 'Success',
+     *       type: 'boolean',
+     *       description: 'Whether the download succeeded',
+     *     },
+     *     {
+     *       display_name: 'Message',
+     *       type: 'string',
+     *       description: 'Status or error message',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    generate(body: TaskGenerateParams, options?: RequestOptions): APIPromise<TaskGenerateResponse>;
+    /**
+     * Triggers execution of a task by ID using the V2 tasks API.
+     *
+     * @example
+     * ```ts
+     * const response = await client.tasks.run('taskId', {
+     *   input_params: {
+     *     'File Name': 'invoice-2026-02.pdf',
+     *     Operation: 'extract_text',
+     *   },
+     * });
+     * ```
+     */
+    run(taskID: string, body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse>;
+}
+/**
+ * Response when task generation has been started (generation is asynchronous).
+ */
+export interface TaskGenerateResponse {
+    /**
+     * The ID of the created task (use with generation-status and run endpoints)
+     */
+    id: string;
+    /**
+     * Whether the task is still generating, ready to run, or failed.
+     */
+    status: 'generating';
+}
+export interface TaskRunResponse {
+    /**
+     * The ID of the task run
+     */
+    run_id: string;
+    /**
+     * Current task run status
+     */
+    status: 'queued' | 'running' | 'success' | 'failure' | 'timeout' | 'cancelled';
+    /**
+     * Error message when the run fails
+     */
+    error?: string;
+    /**
+     * Task output when available
+     */
+    result?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Session ID used for this task run
+     */
+    session_id?: string;
+}
+export interface TaskGenerateParams {
+    /**
+     * Description of the task
+     */
+    description: string;
+    /**
+     * Name of the task
+     */
+    name: string;
+    /**
+     * Natural language description of what the task should do (used for AI generation)
+     */
+    user_task: string;
+    /**
+     * Optional application (connection) ID to associate with the task
+     */
+    application_id?: string;
+    /**
+     * Optional list of input parameters for the task. Defaults to empty array.
+     */
+    input_schema?: Array<TaskGenerateParams.InputSchema>;
+    /**
+     * Optional list of output parameters for the task. Defaults to empty array.
+     */
+    output_schema?: Array<TaskGenerateParams.OutputSchema>;
+    /**
+     * Optional default browser/session configuration when running this task
+     */
+    task_browser_default_configuration?: TaskGenerateParams.TaskBrowserDefaultConfiguration;
+}
+export declare namespace TaskGenerateParams {
+    /**
+     * A single input or output parameter for a generated task.
+     */
+    interface InputSchema {
+        /**
+         * Human-readable name for the parameter
+         */
+        display_name: string;
+        /**
+         * Data type of the parameter
+         */
+        type: 'string' | 'number' | 'boolean' | 'date';
+        /**
+         * Optional default value as a string
+         */
+        default_value?: string;
+        /**
+         * Optional description of the parameter
+         */
+        description?: string;
+        /**
+         * Whether the parameter is required
+         */
+        required?: boolean;
+    }
+    /**
+     * A single input or output parameter for a generated task.
+     */
+    interface OutputSchema {
+        /**
+         * Human-readable name for the parameter
+         */
+        display_name: string;
+        /**
+         * Data type of the parameter
+         */
+        type: 'string' | 'number' | 'boolean' | 'date';
+        /**
+         * Optional default value as a string
+         */
+        default_value?: string;
+        /**
+         * Optional description of the parameter
+         */
+        description?: string;
+        /**
+         * Whether the parameter is required
+         */
+        required?: boolean;
+    }
+    /**
+     * Optional default browser/session configuration when running this task
+     */
+    interface TaskBrowserDefaultConfiguration {
+        /**
+         * The URL to navigate to when the browser session starts. If not provided, the
+         * browser will load an empty page.
+         */
+        initial_url?: string;
+        /**
+         * Configuration for live viewing the browser session.
+         */
+        live_view?: TaskBrowserDefaultConfiguration.LiveView;
+        /**
+         * Proxy Documentation available at [Proxy Documentation](/advanced/proxy)
+         */
+        proxy?: TaskBrowserDefaultConfiguration.AnchorProxy | TaskBrowserDefaultConfiguration.CustomProxy;
+        /**
+         * Configuration for session recording.
+         */
+        recording?: TaskBrowserDefaultConfiguration.Recording;
+        /**
+         * Timeout configurations for the browser session.
+         */
+        timeout?: TaskBrowserDefaultConfiguration.Timeout;
+    }
+    namespace TaskBrowserDefaultConfiguration {
+        /**
+         * Configuration for live viewing the browser session.
+         */
+        interface LiveView {
+            /**
+             * Enable or disable read-only mode for live viewing. Defaults to `false`.
+             */
+            read_only?: boolean;
+        }
+        interface AnchorProxy {
+            active: boolean;
+            /**
+             * City name for precise geographic targeting. Supported for anchor_proxy only. Can
+             * only be used when region is also provided.
+             */
+            city?: string;
+            /**
+             * Supported country codes ISO 2 lowercase
+             */
+            country_code?: 'af' | 'al' | 'dz' | 'ad' | 'ao' | 'as' | 'ag' | 'ar' | 'am' | 'aw' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bb' | 'by' | 'be' | 'bz' | 'bj' | 'bm' | 'bo' | 'ba' | 'br' | 'bg' | 'bf' | 'cm' | 'ca' | 'cv' | 'td' | 'cl' | 'co' | 'cg' | 'cr' | 'ci' | 'hr' | 'cu' | 'cy' | 'cz' | 'dk' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'ee' | 'et' | 'fo' | 'fi' | 'fr' | 'gf' | 'pf' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gd' | 'gp' | 'gt' | 'gg' | 'gn' | 'gw' | 'gy' | 'ht' | 'hn' | 'hu' | 'is' | 'in' | 'ir' | 'iq' | 'ie' | 'il' | 'it' | 'jm' | 'jp' | 'jo' | 'kz' | 'kw' | 'kg' | 'lv' | 'lb' | 'ly' | 'li' | 'lt' | 'lu' | 'mk' | 'ml' | 'mt' | 'mq' | 'mr' | 'mx' | 'md' | 'mc' | 'me' | 'ma' | 'nl' | 'nz' | 'ni' | 'ng' | 'no' | 'pk' | 'pa' | 'py' | 'pe' | 'ph' | 'pl' | 'pt' | 'pr' | 'qa' | 'ro' | 'lc' | 'sm' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sk' | 'si' | 'so' | 'za' | 'kr' | 'es' | 'sr' | 'se' | 'ch' | 'sy' | 'st' | 'tw' | 'tj' | 'tg' | 'tt' | 'tn' | 'tr' | 'tc' | 'ua' | 'ae' | 'us' | 'uy' | 'uz' | 've' | 'ye';
+            /**
+             * Region code for more specific geographic targeting. The city parameter can only
+             * be used when region is also provided.
+             */
+            region?: string;
+            /**
+             * Create a session with a proxy to access websites as if you're browsing from a
+             * computer in that country.
+             */
+            type?: 'anchor_proxy';
+        }
+        interface CustomProxy {
+            active: boolean;
+            /**
+             * Proxy password
+             */
+            password: string;
+            /**
+             * Proxy address in **PROTOCOL://HOST:PORT** format (e.g.,
+             * https://proxy.example.com:443). See [proxy page](/advanced/proxy#custom-proxy).
+             */
+            server: string;
+            type: 'custom';
+            /**
+             * Proxy username
+             */
+            username: string;
+        }
+        /**
+         * Configuration for session recording.
+         */
+        interface Recording {
+            /**
+             * Enable or disable video recording of the browser session. Defaults to `true`.
+             */
+            active?: boolean;
+        }
+        /**
+         * Timeout configurations for the browser session.
+         */
+        interface Timeout {
+            /**
+             * The amount of time (in minutes) the browser session waits for new connections
+             * after all others are closed before stopping. Defaults to `5`.
+             */
+            idle_timeout?: number;
+            /**
+             * Maximum amount of time (in minutes) for the browser to run before terminating.
+             * Defaults to `20`.
+             */
+            max_duration?: number;
+        }
+    }
+}
+export interface TaskRunParams {
+    /**
+     * Key-value pairs of input parameters for the task
+     */
+    input_params: {
+        [key: string]: string;
+    };
+    /**
+     * Whether to clean up sessions after execution
+     */
+    cleanup_sessions?: boolean;
+    /**
+     * Optional identity ID to use for the task
+     */
+    identity_id?: string;
+    /**
+     * Optional session ID to run the task in
+     */
+    session_id?: string;
+}
+export declare namespace Tasks {
+    export { type TaskGenerateResponse as TaskGenerateResponse, type TaskRunResponse as TaskRunResponse, type TaskGenerateParams as TaskGenerateParams, type TaskRunParams as TaskRunParams, };
+    export { Runs as Runs, type RunGetStatusResponse as RunGetStatusResponse };
+    export { Generations as Generations, type GenerationGetStatusResponse as GenerationGetStatusResponse };
+}
+//# sourceMappingURL=tasks.d.ts.map

package/resources/tasks/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/resources/tasks/tasks.ts"],"names":[],"mappings":"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CT,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;YAET;;;eAGG;YACH,MAAM,CAAC,EAAE,MAAM,CAAC;YAEhB;;;eAGG;YACH,IAAI,CAAC,EAAE,cAAc,CAAC;SACvB;QAED,UAAiB,WAAW;YAC1B,MAAM,EAAE,OAAO,CAAC;YAEhB;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YAEjB;;;eAGG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf,IAAI,EAAE,QAAQ,CAAC;YAEf;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;SAClB;QAED;;WAEG;QACH,UAAiB,SAAS;YACxB;;eAEG;YACH,MAAM,CAAC,EAAE,OAAO,CAAC;SAClB;QAED;;WAEG;QACH,UAAiB,OAAO;YACtB;;;eAGG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;YAEtB;;;eAGG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB;KACF;CACF;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,aAAa,IAAI,aAAa,GACpC,CAAC;IAEF,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;IAE3E,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,KAAK,2BAA2B,IAAI,2BAA2B,EAAE,CAAC;CACxG"}