adspower-browser 1.0.1 → 1.0.2

package/build/cli.js

@@ -75,7 +75,14 @@ var API_ENDPOINTS = {
   GET_GROUP_LIST: "/api/v1/group/list",
   CREATE_GROUP: "/api/v1/group/create",
   UPDATE_GROUP: "/api/v1/group/update",
-  GET_APPLICATION_LIST: "/api/v2/category/list"
+  GET_APPLICATION_LIST: "/api/v2/category/list",
+  GET_TAG_LIST: "/api/v2/browser-tags/list",
+  CREATE_TAG: "/api/v2/browser-tags/create",
+  UPDATE_TAG: "/api/v2/browser-tags/update",
+  DELETE_TAG: "/api/v2/browser-tags/delete",
+  DOWNLOAD_KERNEL: "/api/v2/browser-profile/download-kernel",
+  GET_KERNEL_LIST: "/api/v2/browser-profile/kernels",
+  UPDATE_PATCH: "/api/v2/browser-profile/update-patch"
 };
 var apiClient = import_axios.default.create({
   headers: API_KEY ? { "Authorization": `Bearer ${API_KEY}` } : {}
@@ -104,7 +111,9 @@ function buildRequestBody(params) {
     ipchecker: "ipchecker",
     categoryId: "category_id",
     launchArgs: "launch_args",
-    profileId: "profile_id"
+    profileId: "profile_id",
+    profileTagIds: "profile_tag_ids",
+    tagsUpdateType: "tags_update_type"
   };
   Object.entries(basicFields).forEach(([paramKey, key]) => {
     const value = params[paramKey];
@@ -216,7 +225,7 @@ var browserHandlers = {
     throw new Error(`Failed to delete browsers: ${response.data.msg}`);
   },
   async getBrowserList(params) {
-    const { groupId, limit, page, profileId, profileNo, sortType, sortOrder } = params;
+    const { groupId, limit, page, profileId, profileNo, sortType, sortOrder, tag_ids, tags_filter, name, name_filter } = params;
     const requestBody = {};
     if (limit !== void 0) {
       requestBody.limit = limit;
@@ -239,6 +248,18 @@ var browserHandlers = {
     if (sortOrder) {
       requestBody.sort_order = sortOrder;
     }
+    if (tag_ids && tag_ids.length > 0) {
+      requestBody.tag_ids = tag_ids;
+    }
+    if (tags_filter) {
+      requestBody.tags_filter = tags_filter;
+    }
+    if (name) {
+      requestBody.name = name;
+    }
+    if (name_filter) {
+      requestBody.name_filter = name_filter;
+    }
     const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_BROWSER_LIST}`, requestBody);
     if (response.data.code === 0) {
       return `Browser list: ${JSON.stringify(response.data.data.list, null, 2)}`;
@@ -530,6 +551,49 @@ var proxyHandlers = {
   }
 };
 
+// ../core/src/handlers/tag.ts
+var tagHandlers = {
+  async getTagList(params) {
+    const { ids, limit, page } = params;
+    const requestBody = {};
+    if (ids && ids.length > 0) {
+      requestBody.ids = ids;
+    }
+    if (limit !== void 0) {
+      requestBody.limit = limit;
+    }
+    if (page !== void 0) {
+      requestBody.page = page;
+    }
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_TAG_LIST}`, requestBody);
+    if (response.data.code === 0) {
+      return `Tag list: ${JSON.stringify(response.data.data.list || response.data.data, null, 2)}`;
+    }
+    throw new Error(`Failed to get tag list: ${response.data.msg}`);
+  },
+  async createTag({ tags }) {
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.CREATE_TAG}`, { tags });
+    if (response.data.code === 0) {
+      return `Tags created successfully: ${JSON.stringify(response.data.data, null, 2)}`;
+    }
+    throw new Error(`Failed to create tags: ${response.data.msg}`);
+  },
+  async updateTag({ tags }) {
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_TAG}`, { tags });
+    if (response.data.code === 0) {
+      return `Tags updated successfully: ${JSON.stringify(response.data.data, null, 2)}`;
+    }
+    throw new Error(`Failed to update tags: ${response.data.msg}`);
+  },
+  async deleteTag({ ids }) {
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DELETE_TAG}`, { ids });
+    if (response.data.code === 0) {
+      return `Tags deleted successfully: ${ids.join(", ")}`;
+    }
+    throw new Error(`Failed to delete tags: ${response.data.msg}`);
+  }
+};
+
 // ../core/src/handlers/automation.ts
 var import_path = __toESM(require("path"));
 var import_os = __toESM(require("os"));
@@ -587,6 +651,46 @@ var browserBase_default = new BrowserBase();
 // ../core/src/handlers/automation.ts
 var defaultDownloadsPath = import_path.default.join(import_os.default.homedir(), "Downloads");
 
+// ../core/src/handlers/kernel.ts
+var kernelHandlers = {
+  async downloadKernel({ kernel_type, kernel_version }) {
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.DOWNLOAD_KERNEL}`, {
+      kernel_type,
+      kernel_version
+    });
+    if (response.data.code === 0) {
+      return `Kernel download/update status: ${JSON.stringify(response.data.data, null, 2)}`;
+    }
+    throw new Error(`Failed to download/update kernel: ${response.data.msg}`);
+  },
+  async getKernelList({ kernel_type }) {
+    const params = new URLSearchParams();
+    if (kernel_type) {
+      params.set("kernel_type", kernel_type);
+    }
+    const response = await apiClient.get(`${LOCAL_API_BASE}${API_ENDPOINTS.GET_KERNEL_LIST}`, { params });
+    if (response.data.code === 0) {
+      return `Kernel list: ${JSON.stringify(response.data.data.list || response.data.data, null, 2)}`;
+    }
+    throw new Error(`Failed to get kernel list: ${response.data.msg}`);
+  }
+};
+
+// ../core/src/handlers/patch.ts
+var patchHandlers = {
+  async updatePatch({ version_type }) {
+    const requestBody = {};
+    if (version_type) {
+      requestBody.version_type = version_type;
+    }
+    const response = await apiClient.post(`${LOCAL_API_BASE}${API_ENDPOINTS.UPDATE_PATCH}`, requestBody);
+    if (response.data.code === 0) {
+      return `Patch update status: ${JSON.stringify(response.data.data, null, 2)}, message: ${response.data.msg}`;
+    }
+    throw new Error(`Failed to update patch: ${response.data.msg}`);
+  }
+};
+
 // ../core/src/types/schemas.ts
 var import_zod = require("zod");
 var userProxyConfigSchema = import_zod.z.object({
@@ -707,19 +811,365 @@ var randomUaConfigSchema = import_zod.z.object({
   ).optional().describe(
     'UA system version. Mac OS X / Windows / iOS / Android / Linux = random any version of that system; omit to random across all systems. e.g. ["Android 9", "iOS 14"] or ["Android", "Mac OS X"]'
   )
-}).optional().describe("The random ua config of the browser, default is ua_version: [], ua_system_version: []");
+}).optional().describe("Random UA config (ua_version, ua_system_version). Ignored when fingerprint ua (custom UA) is set.");
+var TLS_CIPHER_SUITES = {
+  TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384: "0xC02C",
+  TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384: "0xC030",
+  TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256: "0xC02B",
+  TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256: "0xC02F",
+  TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256: "0xCCA9",
+  TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256: "0xCCA8",
+  TLS_DHE_RSA_WITH_AES_256_GCM_SHA384: "0x009F",
+  TLS_DHE_RSA_WITH_AES_128_GCM_SHA256: "0x009E",
+  TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384: "0xC024",
+  TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384: "0xC028",
+  TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA: "0xC00A",
+  TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA: "0xC014",
+  TLS_DHE_RSA_WITH_AES_256_CBC_SHA256: "0x006B",
+  TLS_DHE_RSA_WITH_AES_256_CBC_SHA: "0x0039",
+  TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256: "0xC023",
+  TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256: "0xC027",
+  TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA: "0xC009",
+  TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA: "0xC013",
+  TLS_DHE_RSA_WITH_AES_128_CBC_SHA256: "0x0067",
+  TLS_DHE_RSA_WITH_AES_128_CBC_SHA: "0x0033",
+  TLS_RSA_WITH_AES_256_GCM_SHA384: "0x009D",
+  TLS_RSA_WITH_AES_128_GCM_SHA256: "0x009C",
+  TLS_RSA_WITH_AES_256_CBC_SHA256: "0x003D",
+  TLS_RSA_WITH_AES_128_CBC_SHA256: "0x003C",
+  TLS_RSA_WITH_AES_256_CBC_SHA: "0x0035",
+  TLS_RSA_WITH_AES_128_CBC_SHA: "0x002F",
+  TLS_AES_128_CCM_8_SHA256: "0x1305",
+  TLS_AES_128_CCM_SHA256: "0x1304"
+};
+var TLS_HEX_CODES = Object.values(TLS_CIPHER_SUITES);
+var COUNTRY_CODES = [
+  "ad",
+  "ae",
+  "af",
+  "ag",
+  "ai",
+  "al",
+  "am",
+  "ao",
+  "aq",
+  "ar",
+  "as",
+  "at",
+  "au",
+  "aw",
+  "ax",
+  "az",
+  "ba",
+  "bb",
+  "bd",
+  "be",
+  "bf",
+  "bg",
+  "bh",
+  "bi",
+  "bj",
+  "bl",
+  "bm",
+  "bn",
+  "bo",
+  "bq",
+  "br",
+  "bs",
+  "bt",
+  "bv",
+  "bw",
+  "by",
+  "bz",
+  "ca",
+  "cc",
+  "cd",
+  "cf",
+  "cg",
+  "ch",
+  "ci",
+  "ck",
+  "cl",
+  "cm",
+  "cn",
+  "co",
+  "cr",
+  "cu",
+  "cv",
+  "cx",
+  "cy",
+  "cz",
+  "de",
+  "dj",
+  "dk",
+  "dm",
+  "do",
+  "dz",
+  "ec",
+  "ee",
+  "eg",
+  "eh",
+  "er",
+  "es",
+  "et",
+  "fi",
+  "fj",
+  "fk",
+  "fm",
+  "fo",
+  "fr",
+  "ga",
+  "gb",
+  "gd",
+  "ge",
+  "gf",
+  "gg",
+  "gh",
+  "gi",
+  "gl",
+  "gm",
+  "gn",
+  "gp",
+  "gq",
+  "gr",
+  "gs",
+  "gt",
+  "gu",
+  "gw",
+  "gy",
+  "hk",
+  "hm",
+  "hn",
+  "hr",
+  "ht",
+  "hu",
+  "id",
+  "ie",
+  "il",
+  "im",
+  "in",
+  "io",
+  "iq",
+  "ir",
+  "is",
+  "it",
+  "je",
+  "jm",
+  "jo",
+  "jp",
+  "ke",
+  "kg",
+  "kh",
+  "ki",
+  "km",
+  "kn",
+  "kp",
+  "kr",
+  "kw",
+  "ky",
+  "kz",
+  "la",
+  "lb",
+  "lc",
+  "li",
+  "lk",
+  "lr",
+  "ls",
+  "lt",
+  "lu",
+  "lv",
+  "ly",
+  "ma",
+  "mc",
+  "md",
+  "me",
+  "mf",
+  "mg",
+  "mh",
+  "mk",
+  "ml",
+  "mm",
+  "mn",
+  "mo",
+  "mp",
+  "mq",
+  "mr",
+  "ms",
+  "mt",
+  "mu",
+  "mv",
+  "mw",
+  "mx",
+  "my",
+  "mz",
+  "na",
+  "nc",
+  "ne",
+  "nf",
+  "ng",
+  "ni",
+  "nl",
+  "no",
+  "np",
+  "nr",
+  "nu",
+  "nz",
+  "om",
+  "pa",
+  "pe",
+  "pf",
+  "pg",
+  "ph",
+  "pk",
+  "pl",
+  "pm",
+  "pn",
+  "pr",
+  "ps",
+  "pt",
+  "pw",
+  "py",
+  "qa",
+  "re",
+  "ro",
+  "rs",
+  "ru",
+  "rw",
+  "sa",
+  "sb",
+  "sc",
+  "sd",
+  "se",
+  "sg",
+  "sh",
+  "si",
+  "sj",
+  "sk",
+  "sl",
+  "sm",
+  "sn",
+  "so",
+  "sr",
+  "ss",
+  "st",
+  "sv",
+  "sy",
+  "sz",
+  "tc",
+  "td",
+  "tf",
+  "tg",
+  "th",
+  "tj",
+  "tk",
+  "tl",
+  "tm",
+  "tn",
+  "to",
+  "tr",
+  "tt",
+  "tv",
+  "tw",
+  "tz",
+  "ua",
+  "ug",
+  "um",
+  "us",
+  "uy",
+  "uz",
+  "va",
+  "vc",
+  "ve",
+  "vg",
+  "vi",
+  "vn",
+  "vu",
+  "wf",
+  "ws",
+  "ye",
+  "yt",
+  "za",
+  "zm",
+  "zw"
+];
+var countryCodeSchema = import_zod.z.enum(COUNTRY_CODES);
+var webglConfigSchema = import_zod.z.object({
+  unmasked_vendor: import_zod.z.string().describe('WebGL vendor string, e.g. "Google Inc.". Required when webgl=2, cannot be empty.'),
+  unmasked_renderer: import_zod.z.string().describe('WebGL renderer string, e.g. "ANGLE (Intel(R) HD Graphics 620 Direct3D11 vs_5_0 ps_5_0)". Required when webgl=2, cannot be empty.'),
+  webgpu: import_zod.z.object({
+    webgpu_switch: import_zod.z.enum(["0", "1", "2"]).describe("0: Disabled, 1: WebGL based matching, 2: Real")
+  }).optional().describe("WebGPU setting (V2.6.8.1+)")
+}).describe("Custom WebGL metadata when webgl=2. See AdsPower fingerprint_config webgl_config.");
+var macAddressConfigSchema = import_zod.z.object({
+  model: import_zod.z.enum(["0", "1", "2"]).describe("0: use current computer MAC, 1: match appropriate value, 2: custom (address required)"),
+  address: import_zod.z.string().optional().describe('Custom MAC address when model=2, e.g. "E4-02-9B-3B-E9-27"')
+}).describe("MAC address: model 0/1/2, address when model=2.");
+var DEVICE_COUNT_VALUES = ["1", "2", "3", "4", "5", "6", "7", "8", "9"];
+var mediaDevicesNumSchema = import_zod.z.object({
+  audioinput_num: import_zod.z.enum(DEVICE_COUNT_VALUES).describe("Number of microphones, 1-9"),
+  videoinput_num: import_zod.z.enum(DEVICE_COUNT_VALUES).describe("Number of cameras, 1-9"),
+  audiooutput_num: import_zod.z.enum(DEVICE_COUNT_VALUES).describe("Number of speakers, 1-9")
+}).describe("Device counts when media_devices=2: audioinput_num, videoinput_num, audiooutput_num each 1-9.");
 var fingerprintConfigSchema = import_zod.z.object({
-  automatic_timezone: import_zod.z.enum(["0", "1"]).optional().describe("The automatic timezone of the browser, default is 0"),
-  timezone: import_zod.z.string().optional().describe("The timezone of the browser, eg: Asia/Shanghai"),
-  language: import_zod.z.array(import_zod.z.string()).optional().describe('The language of the browser, eg: ["en-US", "zh-CN"]'),
-  flash: import_zod.z.enum(["block", "allow"]).optional().describe("The flash of the browser, default is disabled"),
-  fonts: import_zod.z.array(import_zod.z.string()).optional().describe('The fonts of the browser, eg: ["Arial", "Times New Roman"]'),
-  webrtc: import_zod.z.enum(["disabled", "forward", "proxy", "local"]).optional().describe("The webrtc of the browser, default is disabled"),
-  browser_kernel_config: browserKernelConfigSchema,
-  random_ua: randomUaConfigSchema,
-  tls_switch: import_zod.z.enum(["0", "1"]).optional().describe("The tls switch of the browser, default is 0"),
-  tls: import_zod.z.string().optional().describe('The tls of the browser, if tls_switch is 1, you can set the tls of the browser, eg: "0xC02C,0xC030"')
-}).optional().describe('The fingerprint config of the browser, default is automatic_timezone: 0, timezone: "", language: [], flash: "", fonts: [], webrtc: disabled, browser_kernel_config: ua_auto, random_ua: ua_version: [], ua_system_version: [], tls_switch: 0, tls: ""');
+  automatic_timezone: import_zod.z.enum(["0", "1"]).optional().describe("Auto timezone by IP: 0 custom, 1 (default) by IP"),
+  timezone: import_zod.z.string().optional().describe("Timezone when automatic_timezone=0, e.g. Asia/Shanghai"),
+  location_switch: import_zod.z.enum(["0", "1"]).optional().describe("Location by IP: 0 custom, 1 (default) by IP"),
+  longitude: import_zod.z.number().min(-180).max(180).optional().describe("Custom longitude when location_switch=0, -180 to 180, up to 6 decimals"),
+  latitude: import_zod.z.number().min(-90).max(90).optional().describe("Custom latitude when location_switch=0, -90 to 90, up to 6 decimals"),
+  accuracy: import_zod.z.number().int().min(10).max(5e3).optional().describe("Location accuracy in meters when location_switch=0, 10-5000, default 1000"),
+  location: import_zod.z.enum(["ask", "allow", "block"]).optional().describe("Site location permission: ask (default), allow, block"),
+  language_switch: import_zod.z.enum(["0", "1"]).optional().describe("Language by IP country: 0 custom, 1 (default) by IP"),
+  language: import_zod.z.array(import_zod.z.string()).optional().describe('Custom languages when language_switch=0, e.g. ["en-US", "zh-CN"]'),
+  page_language_switch: import_zod.z.enum(["0", "1"]).optional().describe("Match UI language to language: 0 off, 1 (default) on; Chrome 109+ Win / 119+ macOS, v2.6.72+"),
+  page_language: import_zod.z.string().optional().describe("Page language when page_language_switch=0, e.g. en-US"),
+  ua: import_zod.z.string().optional().describe("Custom User-Agent string; when set, takes precedence over random_ua (random_ua is not sent). Omit for random UA."),
+  screen_resolution: import_zod.z.union([
+    import_zod.z.enum(["none", "random"]),
+    import_zod.z.string().regex(/^\d+_\d+$/, "Custom resolution format: width_height e.g. 1024_600")
+  ]).optional().describe("Screen resolution: none (default), random, or width_height e.g. 1024_600"),
+  fonts: import_zod.z.array(import_zod.z.string()).optional().describe('Font list e.g. ["Arial", "Times New Roman"] or ["all"]'),
+  canvas: import_zod.z.enum(["0", "1"]).optional().describe("Canvas fingerprint: 0 computer default, 1 (default) add noise"),
+  webgl: import_zod.z.enum(["0", "2", "3"]).optional().describe("WebGL metadata: 0 computer default, 2 custom (use webgl_config), 3 random"),
+  webgl_image: import_zod.z.enum(["0", "1"]).optional().describe("WebGL image fingerprint: 0 default, 1 (default) add noise"),
+  webgl_config: webglConfigSchema.optional().describe("Custom WebGL metadata when webgl=2. Must include unmasked_vendor and unmasked_renderer (non-empty). webgpu.webgpu_switch: 0 Disabled, 1 WebGL based, 2 Real. V2.6.8.1+"),
+  flash: import_zod.z.enum(["block", "allow"]).optional().describe("Flash: block (default) or allow"),
+  webrtc: import_zod.z.enum(["disabled", "forward", "proxy", "local"]).optional().describe("WebRTC: disabled (default), forward, proxy, local"),
+  audio: import_zod.z.enum(["0", "1"]).optional().describe("Audio fingerprint: 0 close, 1 (default) add noise"),
+  do_not_track: import_zod.z.enum(["default", "true", "false"]).optional().describe("Do Not Track: default, true (open), false (close)"),
+  hardware_concurrency: import_zod.z.enum(["2", "4", "6", "8", "16"]).optional().describe("CPU cores: 2, 4 (default if omitted), 6, 8, 16; omit to follow current computer"),
+  device_memory: import_zod.z.enum(["2", "4", "6", "8"]).optional().describe("Device memory (GB): 2, 4, 6, 8 (default if omitted); omit to follow current computer"),
+  scan_port_type: import_zod.z.enum(["0", "1"]).optional().describe("Port scan protection: 0 close, 1 (default) enable"),
+  allow_scan_ports: import_zod.z.array(import_zod.z.string()).optional().describe('Ports allowed when scan_port_type=1, e.g. ["4000","4001"]. Empty to not pass.'),
+  media_devices: import_zod.z.enum(["0", "1", "2"]).optional().describe("Media devices: 0 off (use computer default), 1 noise (count follows local), 2 noise (use media_devices_num). V2.6.4.2+"),
+  media_devices_num: mediaDevicesNumSchema.optional().describe("When media_devices=2: audioinput_num, videoinput_num, audiooutput_num each 1-9. V2.6.4.2+"),
+  client_rects: import_zod.z.enum(["0", "1"]).optional().describe("ClientRects: 0 use computer default, 1 add noise. V3.6.2+"),
+  device_name_switch: import_zod.z.enum(["0", "1", "2"]).optional().describe("Device name: 0 close (use computer name), 1 mask, 2 custom (use device_name). V3.6.25+"),
+  device_name: import_zod.z.string().optional().describe("Custom device name when device_name_switch=2. V2.4.8.1+"),
+  speech_switch: import_zod.z.enum(["0", "1"]).optional().describe("SpeechVoices: 0 use computer default, 1 replace with value. V3.11.10+"),
+  mac_address_config: macAddressConfigSchema.optional().describe("MAC address: model 0/1/2, address when model=2. V4.3.9+"),
+  gpu: import_zod.z.enum(["0", "1", "2"]).optional().describe("GPU: 0 follow Local settings - Hardware acceleration, 1 turn on, 2 turn off"),
+  browser_kernel_config: browserKernelConfigSchema.optional(),
+  random_ua: randomUaConfigSchema.optional().describe("Random UA config; ignored when ua (custom UA) is provided."),
+  tls_switch: import_zod.z.enum(["0", "1"]).optional().describe("TLS custom list: 0 (default) off, 1 on"),
+  tls: import_zod.z.string().optional().refine(
+    (val) => !val || val.split(",").every((hex) => TLS_HEX_CODES.includes(hex.trim())),
+    { message: `tls must be comma-separated hex codes from: ${TLS_HEX_CODES.join(", ")}. e.g. "0xC02C,0xC030"` }
+  ).describe("TLS cipher list when tls_switch=1: comma-separated hex codes. Chrome kernel only.")
+}).optional().superRefine((data, ctx) => {
+  if (!data) return;
+  if (data.browser_kernel_config?.type === "firefox" && data.tls) {
+    ctx.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: "tls is only supported for Chrome kernel", path: ["tls"] });
+  }
+  if (data.webgl === "2") {
+    const wc = data.webgl_config;
+    if (!wc || typeof wc.unmasked_vendor !== "string" || wc.unmasked_vendor.trim() === "") {
+      ctx.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: "When webgl=2, webgl_config.unmasked_vendor is required and cannot be empty", path: ["webgl_config", "unmasked_vendor"] });
+    }
+    if (!wc || typeof wc.unmasked_renderer !== "string" || wc.unmasked_renderer.trim() === "") {
+      ctx.addIssue({ code: import_zod.z.ZodIssueCode.custom, message: "When webgl=2, webgl_config.unmasked_renderer is required and cannot be empty", path: ["webgl_config", "unmasked_renderer"] });
+    }
+  }
+}).describe("Fingerprint config (fingerprint_config). All fields optional. See AdsPower Local API fingerprint_config.");
 var schemas = {
   createBrowserSchema: import_zod.z.object({
     groupId: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").describe('The group id of the browser, must be a numeric string (e.g., "123"). You can use the get-group-list tool to get the group list or create a new group, use 0 for Ungrouped'),
@@ -730,22 +1180,19 @@ var schemas = {
     name: import_zod.z.string().max(100).optional().describe("Account name, max 100 characters"),
     platform: import_zod.z.string().optional().describe("Platform domain, eg: facebook.com"),
     remark: import_zod.z.string().optional().describe("Remarks to describe the account. Maximum 1500 characters."),
-    userProxyConfig: userProxyConfigSchema.optional().describe("Either user_proxy_config or proxyid must be provided. Only one is required."),
-    proxyid: import_zod.z.string().optional().describe("Either user_proxy_config or proxyid must be provided. Only one is required."),
+    userProxyConfig: userProxyConfigSchema.default({ proxy_soft: "no_proxy" }).describe("Proxy configuration. If proxyid is provided, proxyid takes priority and this field is ignored. Defaults to no_proxy when neither proxyid nor a custom proxy is needed."),
+    proxyid: import_zod.z.string().optional().describe("Proxy profile ID. Takes priority over userProxyConfig when provided."),
     repeatConfig: import_zod.z.array(import_zod.z.union([import_zod.z.literal(0), import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)])).optional().describe("Account deduplication settings (0, 2, 3, or 4)"),
     ignoreCookieError: import_zod.z.enum(["0", "1"]).optional().describe("Handle cookie verification failures: 0 (default) return data as-is, 1 filter out incorrectly formatted cookies"),
     tabs: import_zod.z.array(import_zod.z.string()).optional().describe('URLs to open on startup, eg: ["https://www.google.com"]'),
     ip: import_zod.z.string().optional().describe("IP address"),
-    country: import_zod.z.string().optional().describe('Country/Region, eg: "CN"'),
+    country: countryCodeSchema.optional().describe('Country/Region, ISO 3166-1 alpha-2 (lowercase). eg: "cn", "us"'),
     region: import_zod.z.string().optional().describe("Region"),
     city: import_zod.z.string().optional().describe("City"),
     ipchecker: import_zod.z.enum(["ip2location", "ipapi"]).optional().describe("IP query channel"),
     categoryId: import_zod.z.string().optional().describe("The category id of the browser, you can use the get-application-list tool to get the application list"),
-    fingerprintConfig: fingerprintConfigSchema.optional()
-  }).refine((data) => data.userProxyConfig || data.proxyid, {
-    message: "Either userProxyConfig or proxyid must be provided"
-  }).refine((data) => data.username || data.password || data.cookie || data.fakey, {
-    message: "At least one account information field (username, password, cookie, or fakey) must be provided"
+    profileTagIds: import_zod.z.array(import_zod.z.string()).max(30).optional().describe('Tag IDs to assign to the profile, max 30 tags per profile. Example: ["tag1","tag2"]'),
+    fingerprintConfig: fingerprintConfigSchema.optional().default({ random_ua: { ua_system_version: ["Windows"] } })
   }),
   updateBrowserSchema: import_zod.z.object({
     platform: import_zod.z.string().optional().describe("The platform of the browser, eg: facebook.com"),
@@ -758,7 +1205,7 @@ var schemas = {
     groupId: import_zod.z.string().optional().describe('The group id of the browser, must be a numeric string (e.g., "123"). You can use the get-group-list tool to get the group list or create a new group'),
     name: import_zod.z.string().max(100).optional().describe('The Profile name of the browser, eg: "My Browser"'),
     remark: import_zod.z.string().max(1500).optional().describe("Profile remarks, maximum 1500 characters"),
-    country: import_zod.z.string().optional().describe('The country of the browser, eg: "CN"'),
+    country: countryCodeSchema.optional().describe('The country of the browser, ISO 3166-1 alpha-2 (lowercase). eg: "cn", "us"'),
     region: import_zod.z.string().optional().describe("The region of the browser"),
     city: import_zod.z.string().optional().describe("The city of the browser"),
     ip: import_zod.z.string().optional().describe("The IP of the browser"),
@@ -767,6 +1214,8 @@ var schemas = {
     proxyid: import_zod.z.string().optional().describe("Proxy ID"),
     fingerprintConfig: fingerprintConfigSchema.optional(),
     launchArgs: import_zod.z.string().optional().describe("Browser startup parameters"),
+    profileTagIds: import_zod.z.array(import_zod.z.string()).max(30).optional().describe('Tag IDs to set on the profile, max 30 tags per profile. Example: ["tag1","tag2"]'),
+    tagsUpdateType: import_zod.z.enum(["1", "2"]).optional().describe('How to apply profile_tag_ids: "1" (default) replace all existing tags; "2" append tags (truncated to 30 total if exceeded)'),
     profileId: import_zod.z.string().describe("The profile id of the browser to update, it is required when you want to update the browser")
   }),
   openBrowserSchema: import_zod.z.object({
@@ -793,7 +1242,11 @@ var schemas = {
     profileId: import_zod.z.array(import_zod.z.string()).optional().describe('Query by profile ID. Example: ["h1yynkm","h1yynks"]'),
     profileNo: import_zod.z.array(import_zod.z.string()).optional().describe('Query by profile number. Example: ["123","124"]'),
     sortType: import_zod.z.enum(["profile_no", "last_open_time", "created_time"]).optional().describe("Sort results by: profile_no, last_open_time, or created_time"),
-    sortOrder: import_zod.z.enum(["asc", "desc"]).optional().describe('Sort order: "asc" (ascending) or "desc" (descending)')
+    sortOrder: import_zod.z.enum(["asc", "desc"]).optional().describe('Sort order: "asc" (ascending) or "desc" (descending)'),
+    tag_ids: import_zod.z.array(import_zod.z.string()).optional().describe('Tag IDs to filter profiles by tags. Example: ["tag1","tag2"]'),
+    tags_filter: import_zod.z.enum(["include", "exclude"]).optional().describe('Tag matching mode: "include" (default) matches profiles with any of the tags, "exclude" matches profiles without the tags'),
+    name: import_zod.z.string().optional().describe("Profile name keyword to search for"),
+    name_filter: import_zod.z.enum(["include", "exclude"]).optional().describe('Name matching mode: "include" (default) matches profiles containing the name keyword, "exclude" matches profiles not containing the name keyword')
   }).strict(),
   moveBrowserSchema: import_zod.z.object({
     groupId: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").describe('The target group id, must be a numeric string (e.g., "123"). You can use the get-group-list tool to get the group list'),
@@ -865,7 +1318,7 @@ var schemas = {
       password: import_zod.z.string().optional().describe("Proxy password, eg: password"),
       proxy_url: import_zod.z.string().optional().describe("URL used to refresh the proxy, eg: https://www.baidu.com/"),
       remark: import_zod.z.string().optional().describe("Remark/description for the proxy"),
-      ipchecker: import_zod.z.enum(["ipinfo", "ip2location", "ipapi", "ipfoxy", "ipidea"]).optional().describe("IP checker.")
+      ipchecker: import_zod.z.enum(["ipinfo", "ip2location", "ipapi", "ipfoxy"]).optional().describe("IP checker.")
     }).strict()).describe("Array of proxy configurations to create")
   }).strict(),
   updateProxySchema: import_zod.z.object({
@@ -877,7 +1330,7 @@ var schemas = {
     password: import_zod.z.string().optional().describe("Proxy password, eg: password"),
     proxyUrl: import_zod.z.string().optional().describe("URL used to refresh the proxy, eg: https://www.baidu.com/"),
     remark: import_zod.z.string().optional().describe("Remark/description for the proxy"),
-    ipchecker: import_zod.z.enum(["ip2location", "ipapi", "ipfoxy", "ipidea"]).optional().describe("IP checker.")
+    ipchecker: import_zod.z.enum(["ip2location", "ipapi", "ipfoxy"]).optional().describe("IP checker.")
   }).strict(),
   getProxyListSchema: import_zod.z.object({
     limit: import_zod.z.number().optional().describe("Profiles per page. Number of proxies returned per page, range 1 ~ 200, default is 50"),
@@ -887,6 +1340,37 @@ var schemas = {
   deleteProxySchema: import_zod.z.object({
     proxyIds: import_zod.z.array(import_zod.z.string()).describe("The proxy ids of the proxies to delete, it is required when you want to delete the proxy. The maximum is 100. ")
   }).strict(),
+  getTagListSchema: import_zod.z.object({
+    ids: import_zod.z.array(import_zod.z.string()).optional().describe('Tag IDs to query, max 100 per request. Example: ["tag1","tag2"]'),
+    limit: import_zod.z.number().optional().describe("Number of tags returned per page, range 1 ~ 200, default is 50"),
+    page: import_zod.z.number().optional().describe("Page number for results, default is 1")
+  }).strict(),
+  createTagSchema: import_zod.z.object({
+    tags: import_zod.z.array(import_zod.z.object({
+      name: import_zod.z.string().max(50).describe("Tag name, max 50 characters"),
+      color: import_zod.z.enum(["darkBlue", "blue", "purple", "red", "yellow", "orange", "green", "lightGreen"]).optional().describe("Tag color, default is darkBlue")
+    }).strict()).describe("Array of tags to create")
+  }).strict(),
+  updateTagSchema: import_zod.z.object({
+    tags: import_zod.z.array(import_zod.z.object({
+      id: import_zod.z.string().describe("Tag ID to update"),
+      name: import_zod.z.string().max(50).optional().describe("Tag name, max 50 characters"),
+      color: import_zod.z.enum(["darkBlue", "blue", "purple", "red", "yellow", "orange", "green", "lightGreen"]).optional().describe("Tag color")
+    }).strict()).describe("Array of tags to update")
+  }).strict(),
+  deleteTagSchema: import_zod.z.object({
+    ids: import_zod.z.array(import_zod.z.string()).describe("Tag IDs to delete")
+  }).strict(),
+  downloadKernelSchema: import_zod.z.object({
+    kernel_type: import_zod.z.enum(["Chrome", "Firefox"]).describe("Browser kernel type"),
+    kernel_version: import_zod.z.string().describe("Browser kernel version, e.g. 141")
+  }).strict(),
+  getKernelListSchema: import_zod.z.object({
+    kernel_type: import_zod.z.enum(["Chrome", "Firefox"]).optional().describe("Browser kernel type; omit to return all supported kernels")
+  }).strict(),
+  updatePatchSchema: import_zod.z.object({
+    version_type: import_zod.z.enum(["stable", "beta"]).optional().describe("Patch version type to update, default stable")
+  }).strict(),
   emptySchema: import_zod.z.object({}).strict(),
   createAutomationSchema: import_zod.z.object({
     userId: import_zod.z.string().optional().describe("The browser id of the browser to connect"),
@@ -960,7 +1444,14 @@ var STATELESS_HANDLERS = {
   "create-proxy": proxyHandlers.createProxy,
   "update-proxy": proxyHandlers.updateProxy,
   "get-proxy-list": proxyHandlers.getProxyList,
-  "delete-proxy": proxyHandlers.deleteProxy
+  "delete-proxy": proxyHandlers.deleteProxy,
+  "get-tag-list": tagHandlers.getTagList,
+  "create-tag": tagHandlers.createTag,
+  "update-tag": tagHandlers.updateTag,
+  "delete-tag": tagHandlers.deleteTag,
+  "download-kernel": kernelHandlers.downloadKernel,
+  "get-kernel-list": kernelHandlers.getKernelList,
+  "update-patch": patchHandlers.updatePatch
 };
 var SINGLE_PROFILE_ID_COMMANDS = {
   "open-browser": "profileId",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspower-browser",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "main": "build/cli.js",
   "type": "commonjs",
   "bin": {