@intuned/runtime-dev 1.3.28-dev1 → 1.3.32

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # UNRELEASED
 
+- add Math captcha auto-solver via LLM image recognition (image-based arithmetic captchas configured by CSS selectors)
+- add Temu captcha auto-solver via SadCaptcha API (semantic shapes challenge type)
+
+# 1.3.29
+
+- add TikTok captcha auto-solver via SadCaptcha API (puzzle and rotate challenge types)
+- fix headless browser user agent mismatch when running in stealth browser
+
+# 1.3.28
+
+- accept and log captcha event messages from the browser extension, including Cloudflare Waiting Room progress
+- add DataDome captcha solver configuration and event type support
+
 # 1.3.27
 
 - add profile templates support

package/dist/commands/common/utils/settings.d.ts

@@ -1,2 +1,7 @@
 import { IntunedSettings } from "../../../common/settingsSchema";
+/**
+ * Assembles runtime settings from config supplied via the interface (no longer
+ * reads Intuned.json). Only captcha-solver config is consumed by the runtime;
+ * authSessions/stealthMode are handled by the caller (CLI/UDAS) and default here.
+ */
 export declare function getSettings(): Promise<IntunedSettings>;

package/dist/commands/common/utils/settings.js

@@ -4,28 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getSettings = getSettings;
-var _fileUtils = require("./fileUtils");
 var _settingsSchema = require("../../../common/settingsSchema");
-var _promises = require("fs/promises");
+var _asyncLocalStorage = require("../../../common/asyncLocalStorage");
 async function getSettings() {
-  const settingsFilePath = (0, _fileUtils.getFullPathInProject)("Intuned.json");
-  const settings = await (0, _promises.readFile)(settingsFilePath, {
-    encoding: "utf-8"
-  });
-  if (settings) {
-    const parsed = _settingsSchema.settingsSchema.safeParse(JSON.parse(settings));
-    if (parsed.success) {
-      return parsed.data;
-    } else {
-      throw new Error(parsed.error.message);
-    }
-  }
-  return {
+  return _settingsSchema.settingsSchema.parse({
     authSessions: {
       enabled: false
     },
     stealthMode: {
       enabled: false
-    }
-  };
+    },
+    captchaSolver: (0, _asyncLocalStorage.getCaptchaSolverConfig)()
+  });
 }

package/dist/common/asyncLocalStorage/index.d.ts

@@ -11,6 +11,17 @@ export interface InternalRunInfo extends RunInfo {
     timeoutInfo?: TimeoutInfo;
     store?: Record<string, any>;
     getAuthSessionParameters?: () => Promise<any>;
+    /**
+     * Captcha-solver config forwarded by the caller (CLI/UDAS) through the
+     * interface. Consumed by the Intuned browser extension setup. Replaces the
+     * previous read from Intuned.json.
+     */
+    captchaSolver?: Record<string, any>;
 }
 export declare function getExecutionContext(): InternalRunInfo | undefined;
+/**
+ * Captcha-solver config supplied via the interface, or undefined when running
+ * outside an execution context.
+ */
+export declare function getCaptchaSolverConfig(): Record<string, any> | undefined;
 export {};

package/dist/common/asyncLocalStorage/index.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.asyncLocalStorage = void 0;
+exports.getCaptchaSolverConfig = getCaptchaSolverConfig;
 exports.getExecutionContext = getExecutionContext;
 exports.runWithContext = runWithContext;
 var _nodeAsync_hooks = require("node:async_hooks");
@@ -14,4 +15,7 @@ function runWithContext(contextData, callback, ...args) {
 function getExecutionContext() {
   const contextData = asyncLocalStorage.getStore();
   return contextData;
+}
+function getCaptchaSolverConfig() {
+  return getExecutionContext()?.captchaSolver;
 }

package/dist/common/extension/intunedExtensionServer.js

@@ -75,6 +75,9 @@ class ExtensionServer {
             details: result.error.flatten().fieldErrors
           });
         }
+        if (result.data.message) {
+          console.info(`Captcha event: tab=${result.data.tabId} type=${result.data.type} status=${result.data.status} message=${result.data.message}`);
+        }
         await this.handleUpsertCaptcha(result.data);
         return reply.code(200).send({});
       } catch (error) {

package/dist/common/extension/types.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const captchaTypeSchema: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+export declare const captchaTypeSchema: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
 export type CaptchaType = z.infer<typeof captchaTypeSchema>;
 export declare const captchaStatusSchema: z.ZodEnum<["attached", "solving", "solved", "error", "detached"]>;
 export type CaptchaStatus = z.infer<typeof captchaStatusSchema>;
@@ -19,46 +19,53 @@ export type CaptchaError = z.infer<typeof captchaErrorSchema>;
 declare const captchaBaseSchema: z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>;
 export type CaptchaBase = z.infer<typeof captchaBaseSchema>;
 declare const captchaNonErrorSchema: z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodEnum<["attached", "solving", "solved", "detached"]>;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "attached" | "solving" | "solved" | "detached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "attached" | "solving" | "solved" | "detached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>;
 export type CaptchaNonError = z.infer<typeof captchaNonErrorSchema>;
 declare const captchaErrorStatusSchema: z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"error">;
     error: z.ZodObject<{
@@ -76,104 +83,119 @@ declare const captchaErrorStatusSchema: z.ZodObject<{
         code: "HIT_LIMIT" | "MAX_RETRIES" | "UNEXPECTED_SERVER_RESPONSE" | "UNEXPECTED_ERROR";
         error?: unknown;
     };
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "error";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
     error: {
         code: "HIT_LIMIT" | "MAX_RETRIES" | "UNEXPECTED_SERVER_RESPONSE" | "UNEXPECTED_ERROR";
         error?: unknown;
     };
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "error";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>;
 export type CaptchaErrorStatus = z.infer<typeof captchaErrorStatusSchema>;
 export declare const captchaSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"attached">;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "attached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "attached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"solving">;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "solving";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "solving";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"solved">;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "solved";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "solved";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"detached">;
 }, "strip", z.ZodTypeAny, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "detached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "detached";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>, z.ZodObject<{
     id: z.ZodString;
     tabId: z.ZodNumber;
-    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]>;
+    type: z.ZodEnum<["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]>;
     retryCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
 } & {
     status: z.ZodLiteral<"error">;
     error: z.ZodObject<{
@@ -191,20 +213,22 @@ export declare const captchaSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObje
         code: "HIT_LIMIT" | "MAX_RETRIES" | "UNEXPECTED_SERVER_RESPONSE" | "UNEXPECTED_ERROR";
         error?: unknown;
     };
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "error";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }, {
     error: {
         code: "HIT_LIMIT" | "MAX_RETRIES" | "UNEXPECTED_SERVER_RESPONSE" | "UNEXPECTED_ERROR";
         error?: unknown;
     };
-    type: "aws" | "cloudflare" | "customcaptcha" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "recaptcha" | "textcaptcha";
+    type: "aws" | "cloudflare" | "customcaptcha" | "datadome" | "funcaptcha" | "geetest" | "hcaptcha" | "lemincaptcha" | "mathcaptcha" | "recaptcha" | "textcaptcha" | "tiktok" | "temu";
     status: "error";
     id: string;
     tabId: number;
+    message?: string | undefined;
     retryCount?: number | undefined;
 }>]>;
 export type Captcha = z.infer<typeof captchaSchema>;

package/dist/common/extension/types.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.captchaTypeSchema = exports.captchaStatusSchema = exports.captchaSchema = exports.captchaErrorSchema = exports.captchaErrorCodeSchema = exports.TimeoutError = exports.CaptchaSolveError = void 0;
 var _zod = require("zod");
-const captchaTypeSchema = exports.captchaTypeSchema = _zod.z.enum(["aws", "cloudflare", "customcaptcha", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "recaptcha", "textcaptcha"]);
+const captchaTypeSchema = exports.captchaTypeSchema = _zod.z.enum(["aws", "cloudflare", "customcaptcha", "datadome", "funcaptcha", "geetest", "hcaptcha", "lemincaptcha", "mathcaptcha", "recaptcha", "textcaptcha", "tiktok", "temu"]);
 const captchaStatusSchema = exports.captchaStatusSchema = _zod.z.enum(["attached", "solving", "solved", "error", "detached"]);
 const captchaErrorCodeSchema = exports.captchaErrorCodeSchema = _zod.z.enum(["HIT_LIMIT", "MAX_RETRIES", "UNEXPECTED_SERVER_RESPONSE", "UNEXPECTED_ERROR"]);
 const captchaErrorSchema = exports.captchaErrorSchema = _zod.z.object({
@@ -16,7 +16,8 @@ const captchaBaseSchema = _zod.z.object({
   id: _zod.z.string().min(1),
   tabId: _zod.z.number().int().positive(),
   type: captchaTypeSchema,
-  retryCount: _zod.z.number().int().nonnegative().optional()
+  retryCount: _zod.z.number().int().nonnegative().optional(),
+  message: _zod.z.string().optional()
 });
 const captchaNonErrorSchema = captchaBaseSchema.extend({
   status: captchaStatusSchema.exclude(["error"])

package/dist/common/launchBrowser.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="node" />
 import * as playwright from "playwright";
 import { Result } from "neverthrow";
-import type { ProfileMode } from "@intuned/runtime-interface";
 export declare function getEncryptedProfileChromeArgs({ encryptedProfile, platform, disableMacKeychainPrompts, }: {
     encryptedProfile?: boolean;
     platform?: NodeJS.Platform;
@@ -31,21 +30,29 @@ export type LaunchChromiumStandaloneOptions = {
     ignoreHttpErrors?: boolean;
     profileTemplatePath?: string;
     encryptedProfile?: boolean;
-    profileMode?: ProfileMode;
     timeout?: number;
+    /** Extra Chrome args supplied by the caller (e.g. `--stealth-mode`). */
+    browserArgs?: string[];
+    /** Browser window size supplied by the caller; defaults to 1280x800. */
+    browserSize?: {
+        width: number;
+        height: number;
+    };
 };
 export type LaunchChromiumCdpOptions = {
     cdpAddress: string;
     cdpTargetId?: string;
     profileTemplatePath?: string;
     encryptedProfile?: boolean;
-    profileMode?: ProfileMode;
     timeout?: number;
 };
 export declare function launchChromium(options: LaunchChromiumStandaloneOptions): Promise<LaunchBrowserResult>;
 export declare function launchChromium(options: LaunchChromiumCdpOptions): Promise<LaunchBrowserResult>;
 export declare function getBrowserExecutablePath(): Promise<string | undefined>;
-export declare function launchBrowser(options: Omit<LaunchChromiumStandaloneOptions, "executablePath"> | LaunchChromiumCdpOptions): Promise<LaunchBrowserResult>;
+export declare function launchBrowser(options: (Omit<LaunchChromiumStandaloneOptions, "executablePath"> & {
+    /** Browser executable path supplied by the caller (e.g. the Intuned stealth browser). */
+    browserPath?: string;
+}) | LaunchChromiumCdpOptions): Promise<LaunchBrowserResult>;
 export declare function getLocalCdpAddress(port: number): string;
 export declare function getCdpWebSocketUrl(cdpAddress: string): Promise<Result<string, string>>;
 export declare function getHeadlessUserAgent({ executablePath, args, ignoreDefaultArgs, }: {

package/dist/common/launchBrowser.js

@@ -22,10 +22,13 @@ var _intunedExtensionServer = require("./extension/intunedExtensionServer");
 var _util = require("util");
 var _neverthrow = require("neverthrow");
 var _zod = require("zod");
-var _intunedJson = require("./intunedJson");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 const execAsync = (0, _util.promisify)(_child_process.exec);
+const DEFAULT_BROWSER_SIZE = {
+  width: 1280,
+  height: 800
+};
 function getEncryptedProfileChromeArgs({
   encryptedProfile,
   platform = process.platform,
@@ -50,21 +53,7 @@ const DEFAULT_USER_PREFERENCES = {
     password_manager_enabled: false
   }
 };
-async function createUserDirWithPreferences(profileTemplatePath, profileMode = "persistent") {
-  if (profileMode === "persistent" && profileTemplatePath && (await fs.pathExists(profileTemplatePath))) {
-    const defaultDir = (0, _path.join)(profileTemplatePath, "Default");
-    const preferencesPath = (0, _path.join)(defaultDir, "Preferences");
-    await (0, _fsExtra.mkdir)(defaultDir, {
-      recursive: true
-    });
-    if (!(await fs.pathExists(preferencesPath))) {
-      await (0, _fsExtra.writeFile)(preferencesPath, JSON.stringify(DEFAULT_USER_PREFERENCES));
-    }
-    return {
-      userDir: profileTemplatePath,
-      ephemeral: false
-    };
-  }
+async function createUserDirWithPreferences(profileTemplatePath) {
   const playwrightTempDir = await (0, _fsExtra.mkdtemp)("/tmp/pw-");
   const userDir = (0, _path.join)(playwrightTempDir, "userdir");
   const defaultDir = (0, _path.join)(userDir, "Default");
@@ -87,19 +76,13 @@ async function createUserDirWithPreferences(profileTemplatePath, profileMode = "
     }
     const mergedPreferences = mergePreferences(templatePreferences, DEFAULT_USER_PREFERENCES);
     await (0, _fsExtra.writeFile)(preferencesPath, JSON.stringify(mergedPreferences));
-    return {
-      userDir,
-      ephemeral: true
-    };
+    return userDir;
   }
   await (0, _fsExtra.mkdir)(defaultDir, {
     recursive: true
   });
   await (0, _fsExtra.writeFile)(preferencesPath, JSON.stringify(DEFAULT_USER_PREFERENCES));
-  return {
-    userDir,
-    ephemeral: true
-  };
+  return userDir;
 }
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -172,8 +155,9 @@ async function launchChromium(options) {
     ignoreHttpErrors: ignoreHttpErrorsParam,
     profileTemplatePath,
     encryptedProfile,
-    profileMode,
-    timeout
+    timeout,
+    browserArgs,
+    browserSize: browserSizeOption
   } = options;
   let {
     executablePath
@@ -185,14 +169,10 @@ async function launchChromium(options) {
     encryptedProfile
   });
   extraArgs.push(...encryptedProfileArgs);
-  const stealthConfig = await (0, _intunedJson.getStealthModeConfig)();
-  if (stealthConfig.enabled) {
-    extraArgs.push("--stealth-mode");
+  if (browserArgs) {
+    extraArgs.push(...browserArgs);
   }
-  const {
-    userDir: userDataDir,
-    ephemeral: shouldCleanupUserDir
-  } = await createUserDirWithPreferences(profileTemplatePath, profileMode);
+  const userDataDir = await createUserDirWithPreferences(profileTemplatePath);
   if ((0, _extensionsHelpers.isIntunedExtensionLoaded)()) {
     const extensionsList = (0, _extensionsHelpers.buildExtensionsList)();
     const extensions = extensionsList.join(",");
@@ -215,17 +195,14 @@ async function launchChromium(options) {
   if (appModeInitialUrl) {
     extraArgs.push(`--app=${appModeInitialUrl}`);
   }
-  if (stealthConfig.enabled) {
-    const stealthExecutablePath = await getIntunedBrowserExecutablePath();
-    executablePath = stealthExecutablePath;
-  } else if (executablePath) {
+  if (executablePath) {
     executablePath = await fs.realpath(executablePath);
     if (!(await fs.exists(executablePath))) {
       console.log(`Warning: Executable path ${executablePath} does not exist. Falling back to default.`);
       executablePath = undefined;
     }
   }
-  const browserSize = await (0, _intunedJson.getBrowserSizeConfig)();
+  const browserSize = browserSizeOption ?? DEFAULT_BROWSER_SIZE;
   extraArgs.push(`--window-size=${browserSize.width},${browserSize.height}`);
   const viewport = null;
   const userAgent = process.env.__PLAYWRIGHT_USER_AGENT_OVERRIDE ?? (await getHeadlessUserAgent({
@@ -248,14 +225,12 @@ async function launchChromium(options) {
   }
   context.once("close", async () => {
     try {
-      if (shouldCleanupUserDir) {
-        await (0, _fsExtra.rm)(userDataDir, {
-          recursive: true,
-          force: true,
-          retryDelay: 1000,
-          maxRetries: 5
-        });
-      }
+      await (0, _fsExtra.rm)(userDataDir, {
+        recursive: true,
+        force: true,
+        retryDelay: 1000,
+        maxRetries: 5
+      });
       if (await (0, _extensionsHelpers.isIntunedExtensionEnabled)()) {
         await (0, _intunedExtensionServer.cleanIntunedExtensionServer)();
       }
@@ -276,13 +251,6 @@ async function launchChromium(options) {
     context
   };
 }
-async function getIntunedBrowserExecutablePath() {
-  const intunedPath = process.env.INTUNED_STEALTH_CHROMIUM_PATH;
-  if (intunedPath && (await fs.exists(intunedPath))) {
-    return intunedPath;
-  }
-  return undefined;
-}
 async function getBrowserExecutablePath() {
   const browserType = getBrowserType();
   if (browserType === "brave") {
@@ -293,9 +261,13 @@ async function launchBrowser(options) {
   if ("cdpAddress" in options) {
     return launchChromium(options);
   }
+  const {
+    browserPath,
+    ...standaloneOptions
+  } = options;
   return launchChromium({
-    ...options,
-    executablePath: await getBrowserExecutablePath()
+    ...standaloneOptions,
+    executablePath: browserPath ?? (await getBrowserExecutablePath())
   });
 }
 function getBrowserType() {

package/dist/common/playwrightContext.d.ts

@@ -1,7 +1,7 @@
 import type * as playwright from "playwright";
 import { Err, Ok } from "neverthrow";
 import { type Proxy } from "./launchBrowser";
-import { ImportFunction, RunAutomationError, RunApiSession, type ProfileMode } from "@intuned/runtime-interface";
+import { ImportFunction, RunAutomationError, RunApiSession } from "@intuned/runtime-interface";
 type WithPlaywrightContextParameters = {
     importFunction: ImportFunction;
     apiName: string;
@@ -20,14 +20,18 @@ export declare function withPlaywrightContext<R>(options: {
     ignoreHttpErrors?: boolean;
     profileTemplatePath?: string;
     encryptedProfile?: boolean;
-    profileMode?: ProfileMode;
+    browserPath?: string;
+    browserArgs?: string[];
+    browserSize?: {
+        width: number;
+        height: number;
+    };
 } & WithPlaywrightContextParameters, fn: WithPlaywrightContextWrappedFunction<R>): Promise<Ok<R, any> | Err<any, RunAutomationError>>;
 export declare function withPlaywrightContext<R>(options: {
     cdpAddress: string;
     cdpTargetId?: string;
     profileTemplatePath?: string;
     encryptedProfile?: boolean;
-    profileMode?: ProfileMode;
 } & WithPlaywrightContextParameters, fn: WithPlaywrightContextWrappedFunction<R>): Promise<Ok<R, any> | Err<any, RunAutomationError>>;
 export declare function loadSessionToContext({ context, session, }: {
     context: playwright.BrowserContext;

package/dist/common/playwrightContext.js

@@ -23,7 +23,9 @@ async function withPlaywrightContext({
   ignoreHttpErrors: cliIgnoreHttpErrors,
   profileTemplatePath,
   encryptedProfile,
-  profileMode,
+  browserPath,
+  browserArgs,
+  browserSize,
   importFunction,
   apiName,
   apiParameters
@@ -48,8 +50,7 @@ async function withPlaywrightContext({
           cdpAddress,
           cdpTargetId,
           profileTemplatePath,
-          encryptedProfile,
-          profileMode
+          encryptedProfile
         }));
       } else {
         ({
@@ -62,7 +63,9 @@ async function withPlaywrightContext({
           ignoreHttpErrors,
           profileTemplatePath,
           encryptedProfile,
-          profileMode
+          browserPath,
+          browserArgs,
+          browserSize
         }));
       }
       return await fn(context, page);
@@ -77,8 +80,7 @@ async function withPlaywrightContext({
         cdpAddress,
         cdpTargetId,
         profileTemplatePath,
-        encryptedProfile,
-        profileMode
+        encryptedProfile
       }));
     } else {
       const port = await (0, _portfinder.getPort)({
@@ -95,7 +97,9 @@ async function withPlaywrightContext({
         ignoreHttpErrors,
         profileTemplatePath,
         encryptedProfile,
-        profileMode
+        browserPath,
+        browserArgs,
+        browserSize
       }));
       hookCdpUrl = (0, _launchBrowser.getLocalCdpAddress)(port);
     }