adspower-browser 2.1.2 → 2.1.3

package/README.MD

@@ -142,6 +142,8 @@ ads close-browser <profile_id>                   # Or JSON: profile_id? | profil
 ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id + account field required; proxy optional (defaults to no_proxy; proxyid takes priority over user_proxy_config when both given)
 ads update-browser '{"profile_id":"...",...}'    # profile_id required
 ads delete-browser '{"profile_id":["..."]}'     # profile_id required
+ads get-recycle-bin-list '{}'                   # page?, limit? (1-100). Omit either to use the Local API backend default. Last 30 days only
+ads restore-recycle-bin '{"profile_id":"...","group_id":"123"}'  # profile_id or profile_no, group_id required
 ads get-browser-list '{}'                       # CLI defaults to page=1,limit=200. Or group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
 ads get-opened-browser                          # No params
 ```
@@ -171,12 +173,12 @@ ads get-group-list '{}'                         # group_name?, page_size?, page?
 ### Member
 
 ```bash
-ads create-member '{"user_group_id":"...","email":"alice@example.com","password":"password1","identity":4}'  # identity: 2 admin, 3 manager, 4 staff
-ads update-member '{"user_id":"...","name":"Alice"}'   # omit authorized_group to keep groups; [] + group_update_type 1 clears
+ads create-member '{"user_group_id":"...","email":"alice@example.com","password":"password1","identity":4}'  # identity: 2 admin, 3 manager, 4 staff; manager optional; member only for identity 3
+ads update-member '{"user_id":"...","name":"Alice"}'   # omit to keep; empty name/manager/remark/member/authorized_group can clear; do not empty email or identity
 ads reset-member-password '{"user_id":"..."}'          # unbind_phone?: 0|1; new_password is in the response
-ads delete-member '{"user_id":"..."}'
-ads get-member-list '{}'                               # user_group_id?, user_id[]?, email[]?, page?, limit? (default 1)
-ads get-member-group-list '{}'                         # page?, limit? (default 1)
+ads delete-member '{"user_id":"..."}'                  # permanent, not recoverable
+ads get-member-list '{}'                               # user_group_id?, user_id[]?, email[]?, page?, limit? (default 50, max 200)
+ads get-member-group-list '{}'                         # page?, limit? (default 50, max 200)
 ```
 
 ### Application (categories)

package/cli/index.js

@@ -610,6 +610,23 @@ var LOCAL_API_CONTRACTS = {
       profile_id: { apiName: "profile_id", location: "body" }
     }
   },
+  "get-recycle-bin-list": {
+    method: "POST",
+    path: "/api/v2/browser-profile/recycle-bin/list",
+    params: {
+      page: { apiName: "page", location: "body" },
+      limit: { apiName: "limit", location: "body" }
+    }
+  },
+  "restore-recycle-bin": {
+    method: "POST",
+    path: "/api/v2/browser-profile/recycle-bin/restore",
+    params: {
+      profile_id: { apiName: "profile_id", location: "body" },
+      profile_no: { apiName: "profile_no", location: "body" },
+      group_id: { apiName: "group_id", location: "body" }
+    }
+  },
   "get-browser-list": {
     method: "POST",
     path: "/api/v2/browser-profile/list",
@@ -948,6 +965,8 @@ var API_ENDPOINTS = {
   GET_BROWSER_LIST: LOCAL_API_CONTRACTS["get-browser-list"].path,
   UPDATE_BROWSER: LOCAL_API_CONTRACTS["update-browser"].path,
   DELETE_BROWSER: LOCAL_API_CONTRACTS["delete-browser"].path,
+  GET_RECYCLE_BIN_LIST: LOCAL_API_CONTRACTS["get-recycle-bin-list"].path,
+  RESTORE_RECYCLE_BIN: LOCAL_API_CONTRACTS["restore-recycle-bin"].path,
   GET_PROFILE_COOKIES: LOCAL_API_CONTRACTS["get-profile-cookies"].path,
   GET_PROFILE_UA: LOCAL_API_CONTRACTS["get-profile-ua"].path,
   CLOSE_ALL_PROFILES: LOCAL_API_CONTRACTS["close-all-profiles"].path,
@@ -1032,6 +1051,18 @@ var TOOL_INTENT_BY_NAME = {
     triggersEn: "remove profile, delete account, trash browser",
     triggersZh: "\u5220\u9664\u73AF\u5883,\u79FB\u9664profile,\u5220\u6389\u6D4F\u89C8\u5668\u8D26\u53F7"
   },
+  "get-recycle-bin-list": {
+    intentEn: "List browser profiles in the recycle bin from the last 30 days.",
+    intentZh: "\u67E5\u8BE2\u8FD1 30 \u5929\u56DE\u6536\u7AD9\u4E2D\u7684\u6D4F\u89C8\u5668\u73AF\u5883\u3002",
+    triggersEn: "recycle bin, deleted profiles, trash list, recently deleted",
+    triggersZh: "\u56DE\u6536\u7AD9,\u5DF2\u5220\u9664\u73AF\u5883,\u6700\u8FD1\u5220\u9664,\u5783\u573E\u6876\u5217\u8868"
+  },
+  "restore-recycle-bin": {
+    intentEn: "Restore one deleted browser profile from the recycle bin into a target group.",
+    intentZh: "\u628A\u56DE\u6536\u7AD9\u91CC\u7684\u4E00\u4E2A\u73AF\u5883\u6062\u590D\u5230\u6307\u5B9A\u5206\u7EC4\u3002",
+    triggersEn: "restore profile, recover deleted browser, undelete environment",
+    triggersZh: "\u6062\u590D\u73AF\u5883,\u8FD8\u539F\u56DE\u6536\u7AD9,\u627E\u56DE\u5DF2\u5220\u9664\u73AF\u5883"
+  },
   "get-browser-list": {
     intentEn: "List or search browser profiles (pagination, filters).",
     intentZh: "\u5206\u9875/\u6761\u4EF6\u67E5\u8BE2\u6D4F\u89C8\u5668 profile \u5217\u8868\u3002",
@@ -1135,10 +1166,10 @@ var TOOL_INTENT_BY_NAME = {
     triggersZh: "\u91CD\u7F6E\u5BC6\u7801,\u6539\u5BC6\u7801,\u89E3\u7ED1\u624B\u673A"
   },
   "delete-member": {
-    intentEn: "Delete a team member by user_id.",
-    intentZh: "\u6309 user_id \u5220\u9664\u56E2\u961F\u6210\u5458\u3002",
-    triggersEn: "remove member, delete user, delete staff",
-    triggersZh: "\u5220\u9664\u6210\u5458,\u79FB\u9664\u7528\u6237,\u5220\u5458\u5DE5"
+    intentEn: "Permanently delete a team member by user_id. Hard delete, not recoverable.",
+    intentZh: "\u6309 user_id \u5F7B\u5E95\u5220\u9664\u56E2\u961F\u6210\u5458\uFF0C\u4E0D\u53EF\u6062\u590D\u3002",
+    triggersEn: "remove member, delete user, delete staff, hard delete",
+    triggersZh: "\u5220\u9664\u6210\u5458,\u79FB\u9664\u7528\u6237,\u5220\u5458\u5DE5,\u5F7B\u5E95\u5220\u9664"
   },
   "get-member-list": {
     intentEn: "List or search team members (pagination, user_id, email).",
@@ -1535,6 +1566,26 @@ var browserHandlers = {
     }
     throw new Error(response.data.msg);
   },
+  async getRecycleBinList(params) {
+    const response = await getApiClient().post(
+      `${getLocalApiBase()}${API_ENDPOINTS.GET_RECYCLE_BIN_LIST}`,
+      buildRequestBodyFor("get-recycle-bin-list", params)
+    );
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async restoreRecycleBin(params) {
+    const response = await getApiClient().post(
+      `${getLocalApiBase()}${API_ENDPOINTS.RESTORE_RECYCLE_BIN}`,
+      buildRequestBodyFor("restore-recycle-bin", params)
+    );
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
   async getBrowserList(params) {
     const requestBody = buildRequestBodyFor("get-browser-list", params);
     const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.GET_BROWSER_LIST}`, requestBody);
@@ -2514,6 +2565,17 @@ var schemas = {
   deleteBrowserSchema: import_zod.z.object({
     profile_id: import_zod.z.array(import_zod.z.string()).describe("The profile ids of the browsers to delete, it is required when you want to delete the browser")
   }).strict(),
+  getRecycleBinListSchema: import_zod.z.object({
+    page: import_zod.z.number().int().min(1).optional().describe("Page number. Omit to use the Local API backend default. Only profiles deleted in the last 30 days and visible to the caller are returned."),
+    limit: import_zod.z.number().int().min(1).max(100).optional().describe("Profiles per page, range 1-100. Omit to use the Local API backend default.")
+  }).strict(),
+  restoreRecycleBinSchema: import_zod.z.object({
+    profile_id: import_zod.z.string().optional().describe("Profile ID in the recycle bin. Either profile_id or profile_no is required. If both are provided, profile_id takes priority."),
+    profile_no: import_zod.z.string().regex(/^\d+$/, "Profile number must be a numeric string").optional().describe("Profile serial number in the recycle bin. Either profile_id or profile_no is required. If both are provided, profile_id takes priority."),
+    group_id: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").describe('Target group ID after restore. Use get-group-list to find a group the caller can use. "0" is ungrouped.')
+  }).strict().refine((data) => data.profile_id || data.profile_no, {
+    message: "Either profile_id or profile_no must be provided"
+  }),
   getBrowserListSchema: import_zod.z.object({
     group_id: import_zod.z.string().regex(/^\d+$/, "Group ID must be a numeric string").optional().describe("Query by group ID; searches all groups if empty"),
     limit: import_zod.z.number().min(1).max(200).optional().describe("Profiles per page, range 1 ~ 200. If omitted the CLI sends limit=200; the Local API itself defaults to only 1, so always rely on this CLI default or pass an explicit value"),
@@ -2580,8 +2642,8 @@ var schemas = {
     email: import_zod.z.string().max(70).describe("Member email, max 70 characters"),
     password: import_zod.z.string().min(8).max(50).describe("Login password in plaintext, 8 to 50 characters. The Local API hashes it before storing"),
     identity: import_zod.z.union([import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)]).describe("Role type: 2 admin, 3 manager, 4 staff"),
-    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Required when identity is 4 (staff)"),
-    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Used when identity is 2 or 3"),
+    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Optional even when identity is 4 (staff); omit for no manager. Only staff may send this field"),
+    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Only for identity 3 (manager). Do not send for admin (2); the Local API will reject it"),
     authorized_group: import_zod.z.array(import_zod.z.string()).max(1500).optional().describe("Authorized browser group ids, max 1500. Empty array means no groups"),
     profile_limit: import_zod.z.number().optional().describe("Profile quota for this member"),
     remark: import_zod.z.string().max(100).optional().describe("Remark, max 100 characters")
@@ -2589,33 +2651,33 @@ var schemas = {
   updateMemberSchema: import_zod.z.object({
     user_id: import_zod.z.string().max(50).describe("Member user_id to update"),
     user_group_id: import_zod.z.string().max(50).optional().describe("Member group / role id"),
-    name: import_zod.z.string().max(50).optional().describe("Member display name, max 50 characters. Empty string clears the name"),
-    email: import_zod.z.string().max(70).optional().describe("Member email, max 70 characters"),
-    identity: import_zod.z.union([import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)]).optional().describe("Role type: 2 admin, 3 manager, 4 staff"),
-    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Empty string clears the manager"),
-    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Empty array clears subordinates"),
+    name: import_zod.z.string().max(50).optional().describe("Member display name, max 50 characters. Empty string clears the name. Omit to keep unchanged"),
+    email: import_zod.z.string().max(70).optional().describe("Member email, max 70 characters. Omit to keep unchanged. Do not send empty string; it will fail validation"),
+    identity: import_zod.z.union([import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)]).optional().describe("Role type: 2 admin, 3 manager, 4 staff. Omit to keep unchanged. Do not send empty; it will fail validation"),
+    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Empty string clears the manager. Omit to keep unchanged. Only staff may send this field"),
+    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Only for identity 3 (manager). Empty array clears subordinates. Do not send for admin (2)"),
     authorized_group: import_zod.z.array(import_zod.z.string()).max(1500).optional().describe("Authorized browser group ids, max 1500. Omit to keep current groups. Empty array plus group_update_type 1 (default) replaces/clears; 2 appends/keeps"),
     group_update_type: import_zod.z.union([import_zod.z.literal(1), import_zod.z.literal(2)]).optional().describe("How authorized_group is applied: 1 replace (default), 2 append"),
     profile_limit: import_zod.z.number().optional().describe("Profile quota for this member"),
-    remark: import_zod.z.string().max(100).optional().describe("Remark, max 100 characters. Empty string clears the remark")
+    remark: import_zod.z.string().max(100).optional().describe("Remark, max 100 characters. Empty string clears the remark. Omit to keep unchanged")
   }).strict(),
   resetMemberPasswordSchema: import_zod.z.object({
     user_id: import_zod.z.string().max(50).describe("Member user_id whose password will be reset"),
     unbind_phone: import_zod.z.union([import_zod.z.literal(0), import_zod.z.literal(1)]).optional().describe("Whether to unbind the member phone: 1 unbind, 0 keep. Default 0")
   }).strict(),
   deleteMemberSchema: import_zod.z.object({
-    user_id: import_zod.z.string().max(50).describe("Member user_id to delete")
+    user_id: import_zod.z.string().max(50).describe("Member user_id to permanently delete. Hard delete, not recoverable, does not go to recycle bin")
   }).strict(),
   getMemberListSchema: import_zod.z.object({
     user_group_id: import_zod.z.string().max(50).optional().describe("Filter by member group / role id"),
     user_id: import_zod.z.array(import_zod.z.string()).max(50).optional().describe('Filter by member user_id list, max 50. Example: ["1001","1002"]'),
     email: import_zod.z.array(import_zod.z.string()).max(50).optional().describe('Filter by member email list, max 50. Example: ["a@b.com"]'),
-    page: import_zod.z.number().int().min(1).max(1e7).optional().describe("Page number, default 1"),
-    limit: import_zod.z.number().int().min(1).max(2e3).optional().describe("Page size, default 1, max 2000")
+    page: import_zod.z.number().int().min(1).max(2e4).optional().describe("Page number, default 1, max 20000"),
+    limit: import_zod.z.number().int().min(1).max(200).optional().describe("Page size, default 50, max 200. Omitting limit returns 50 rows")
   }).strict(),
   getMemberGroupListSchema: import_zod.z.object({
-    page: import_zod.z.number().int().min(1).max(1e7).optional().describe("Page number, default 1"),
-    limit: import_zod.z.number().int().min(1).max(2e3).optional().describe("Page size, default 1, max 2000")
+    page: import_zod.z.number().int().min(1).max(2e4).optional().describe("Page number, default 1, max 20000"),
+    limit: import_zod.z.number().int().min(1).max(200).optional().describe("Page size, default 50, max 200. Omitting limit returns 50 rows")
   }).strict(),
   getApplicationListSchema: import_zod.z.object({
     category_id: import_zod.z.string().optional().describe("Extension category_id"),
@@ -2826,6 +2888,16 @@ var STATELESS_HANDLERS = {
     description: buildCliCommandDescription("delete-browser", "Delete the browser"),
     paramsDescription: schemaParamsDescription(schemas.deleteBrowserSchema, "delete-browser")
   },
+  "get-recycle-bin-list": {
+    fn: browserHandlers.getRecycleBinList,
+    description: buildCliCommandDescription("get-recycle-bin-list", "List browser profiles in the recycle bin from the last 30 days"),
+    paramsDescription: schemaParamsDescription(schemas.getRecycleBinListSchema, "get-recycle-bin-list")
+  },
+  "restore-recycle-bin": {
+    fn: browserHandlers.restoreRecycleBin,
+    description: buildCliCommandDescription("restore-recycle-bin", "Restore a deleted browser profile from the recycle bin into a group"),
+    paramsDescription: schemaParamsDescription(schemas.restoreRecycleBinSchema, "restore-recycle-bin")
+  },
   "get-browser-list": {
     fn: browserHandlers.getBrowserList,
     description: buildCliCommandDescription("get-browser-list", "Get the list of browsers"),
@@ -2934,7 +3006,7 @@ var STATELESS_HANDLERS = {
   },
   "delete-member": {
     fn: memberHandlers.deleteMember,
-    description: buildCliCommandDescription("delete-member", "Delete a team member"),
+    description: buildCliCommandDescription("delete-member", "Permanently delete a team member"),
     paramsDescription: schemaParamsDescription(schemas.deleteMemberSchema, "delete-member")
   },
   "get-member-list": {