@roxybrowser/openapi 1.0.12 → 1.0.13-beta.3

package/README.md

@@ -177,8 +177,8 @@ This allows you to build custom UIs, scripts, or other MCP servers that reuse Ro
 - `roxy_list_labels` - Get browser labels/tags for organization
 
 ### Proxy
-- `roxy_list_proxies` - List proxy configurations in a workspace
-- `roxy_store_proxies` - Get list of proxies you've purchased (store)
+- `roxy_list_proxies` - List proxy configurations in a workspace
+- `roxy_store_proxies` - Get list of proxies you've purchased (store)
 - `roxy_create_proxy` - Create a proxy configuration
 - `roxy_batch_create_proxies` - Create multiple proxies in batch
 - `roxy_detect_proxy` - Detect/test proxy availability

package/lib/cli.cjs

@@ -544,12 +544,29 @@ var channelList = [
     value: "http://ipinfo.io"
   }
 ];
+function formatProxySource(dataType) {
+  return dataType === "proxyModule" ? "user-added" : dataType === "buyProxy" ? "proxy store" : dataType || "unknown";
+}
+function formatCheckStatus(checkStatus) {
+  return checkStatus === 1 ? "\u2705 available" : "\u274C unavailable";
+}
+function formatValue(value) {
+  if (value === null || value === void 0 || value === "")
+    return "N/A";
+  if (Array.isArray(value))
+    return value.length > 0 ? value.join(", ") : "N/A";
+  return String(value);
+}
+function formatBool(value, truthy = "yes", falsy = "no") {
+  return value ? truthy : falsy;
+}
+function formatLocation(proxy) {
+  const locationParts = [proxy.lastCity, proxy.lastState, proxy.lastCountry].filter(Boolean);
+  return locationParts.length > 0 ? locationParts.join(", ") : "N/A";
+}
 var ProxyList = class {
   name = "roxy_list_proxies";
-  /**
-   * 仅当用户没有指定商店时调用
-   */
-  description = "Get list of proxy configurations. If you want to get the list of proxies configurations you've bought, please use `roxy_store_proxies`.";
+  description = "Get list of proxy IP List.";
   inputSchema = {
     type: "object",
     properties: {
@@ -557,9 +574,31 @@ var ProxyList = class {
         type: "number",
         description: "Workspace ID"
       },
-      id: {
+      country: {
+        type: "string",
+        description: "Filter by country (us,cn,jp)"
+      },
+      checkStatus: {
         type: "number",
-        description: "Filter by proxy ID"
+        description: "Filter by check status (0: unavailable, 1: available)"
+      },
+      startDate: {
+        type: "string",
+        description: "Filter by detection start date (YYYY-MM-DD)"
+      },
+      endDate: {
+        type: "string",
+        description: "Filter by detection end date (YYYY-MM-DD)"
+      },
+      checker: {
+        type: "string",
+        enum: channelList.map((item) => item.label),
+        description: "Filter by detection channel"
+      },
+      proxyType: {
+        type: "string",
+        enum: ["user-added", "proxy store"],
+        description: "Filter by proxy source type"
       },
       pageIndex: {
         type: "number",
@@ -584,16 +623,26 @@ var ProxyList = class {
   async handle(params) {
     const searchParams = new URLSearchParams();
     searchParams.append("workspaceId", params.workspaceId.toString());
-    if (params.id)
-      searchParams.append("id", params.id.toString());
     if (params.pageIndex)
       searchParams.append("page_index", params.pageIndex.toString());
     if (params.pageSize)
       searchParams.append("page_size", params.pageSize.toString());
+    if (params.country)
+      searchParams.append("country", params.country);
+    if (params.checkStatus !== void 0)
+      searchParams.append("check_status", params.checkStatus.toString());
+    if (params.startDate)
+      searchParams.append("start_date", params.startDate);
+    if (params.endDate)
+      searchParams.append("end_date", params.endDate);
+    if (params.checker)
+      searchParams.append("checker", params.checker);
+    if (params.proxyType)
+      searchParams.append("proxyType", params.proxyType === "user-added" ? "0" : "1");
     if (!params.workspaceId) {
       throw new Error("workspaceId is required");
     }
-    const result = await request(`/proxy/list?${searchParams}`);
+    const result = await request(`/proxy/list_merged?${searchParams}`);
     let text = "";
     if (result.code === 0) {
       const data = result.data;
@@ -602,10 +651,14 @@ var ProxyList = class {
       const totalPages = Math.max(1, Math.ceil((data.total || 0) / pageSize));
       const hasNextPage = currentPage < totalPages;
       const proxyListText = data.rows.length > 0 ? data.rows.map((proxy, index) => {
-        const statusText = proxy.checkStatus === 1 ? "\u2705 available" : proxy.checkStatus === 2 ? "\u274C unavailable" : "\u23F3 not checked";
+        const statusText = formatCheckStatus(proxy.checkStatus);
+        const sourceType = proxy.dataType === "proxyModule" ? "user-added" : "proxy store";
+        const canDelete = proxy.dataType === "proxyModule" ? "yes" : "no";
         const name = `proxy (id: ${proxy.id}) ${proxy.remark ? `remark: ${proxy.remark}` : ""}`;
         const location = proxy.lastCountry ? `${proxy.lastCity || ""}${proxy.lastCity && proxy.lastCountry ? ", " : ""}${proxy.lastCountry}` : null;
         let baseInfo = `${index + 1}. ${statusText} **${name}**
+source: ${sourceType}
+deletable: ${canDelete}
 protocol: ${proxy.protocol || "N/A"}
 ipType: ${proxy.ipType || "N/A"}
 bind profile count: ${proxy.bindCount || "N/A"}
@@ -625,7 +678,9 @@ ${ipInfo.length > 0 ? `${ipInfo.join("")}
         }
         return baseInfo;
       }).join("\n\n") : "";
-      text = `\u{1F4CB} **proxy list** (total: ${data.total})
+      text = `\u{1F4F5} **proxy list** (total: ${data.total})
+
+Only proxies with \`source: user-added\` can be deleted.
 
 ${proxyListText}
 
@@ -643,9 +698,9 @@ ${result.msg}`;
     return { content: [{ type: "text", text }] };
   }
 };
-var ProxyStore = class {
-  name = "roxy_store_proxies";
-  description = "Get list of proxy configurations in the Proxy Store";
+var GetProxyDetail = class {
+  name = "roxy_proxy_detail";
+  description = "Get detailed information for a specific proxy configuration";
   inputSchema = {
     type: "object",
     properties: {
@@ -653,138 +708,12 @@ var ProxyStore = class {
         type: "number",
         description: "Workspace ID"
       },
-      pageIndex: {
-        type: "number",
-        description: "Page index for pagination (default: 1)",
-        default: 1
-      },
-      pageSize: {
-        type: "number",
-        description: "Number of items per page (default: 15)",
-        default: 15
-      },
-      type: {
-        type: "number",
-        description: "Type of proxies to get (0: list_use, 1: available_list)",
-        default: 0
-      }
-    },
-    required: ["workspaceId"]
-  };
-  get schema() {
-    return {
-      name: this.name,
-      description: this.description,
-      inputSchema: this.inputSchema
-    };
-  }
-  async handle(params) {
-    const searchParams = new URLSearchParams();
-    searchParams.append("workspaceId", params.workspaceId.toString());
-    if (params.pageIndex)
-      searchParams.append("page_index", params.pageIndex.toString());
-    if (params.pageSize)
-      searchParams.append("page_size", params.pageSize.toString());
-    if (params.type)
-      searchParams.append("type", params.type.toString());
-    const result = await request(`/proxy/bought_list?${searchParams}`);
-    let text = "";
-    if (result.code === 0) {
-      const data = result.data;
-      const currentPage = params.pageIndex ?? 1;
-      const pageSize = params.pageSize ?? 15;
-      const totalPages = Math.max(1, Math.ceil((data.total || 0) / pageSize));
-      const hasNextPage = currentPage < totalPages;
-      const proxyListText = data.rows.length > 0 ? data.rows.map((proxy, index) => {
-        const statusText = proxy.checkStatus === 1 ? "\u2705 available" : proxy.checkStatus === 2 ? "\u274C unavailable" : "\u23F3 not checked";
-        const name = `proxy (id: ${proxy.id}) ${proxy.remark ? `remark: ${proxy.remark}` : ""}`;
-        const location = proxy.lastCountry ? `${proxy.lastCity || ""}${proxy.lastCity && proxy.lastCountry ? ", " : ""}${proxy.lastCountry}` : null;
-        let baseInfo = `${index + 1}. ${statusText} **${name}**
-protocol: ${proxy.protocol || "N/A"}
-ipType: ${proxy.ipType || "N/A"}
-bind profile count: ${proxy.bindCount || "N/A"}
-Detection channel: ${proxy.checkChannel || "N/A"}
-expire date: ${proxy.expireDate}`;
-        const ipInfo = [proxy.host, ":", proxy.port];
-        if (proxy.proxyUserName) {
-          ipInfo.push(...[proxy.proxyUserName, "@", proxy.proxyPassword]);
-        }
-        if (location) {
-          baseInfo += `
-${ipInfo.join("")}
-\u{1F4CD} ${location}`;
-        }
-        return baseInfo;
-      }).join("\n\n") : "";
-      text = `\u{1F4CB} **proxy store** (total: ${data.total})
-
-${proxyListText}
-
-Pagination:
-- currentPage: ${currentPage}
-- pageSize: ${pageSize}
-- totalPages: ${totalPages}
-- hasNextPage: ${hasNextPage}
-${hasNextPage ? `- nextPageHint: Call roxy_store_proxies again with pageIndex=${currentPage + 1}` : "- nextPageHint: No more pages"}`;
-    } else {
-      text = `\u274C **get proxy store failed**
-
-${result.msg}`;
-    }
-    return { content: [{ type: "text", text }] };
-  }
-};
-var CreateProxy = class {
-  name = "roxy_create_proxy";
-  description = "Create a new proxy configuration with automatic IP detection";
-  inputSchema = {
-    type: "object",
-    properties: {
-      workspaceId: {
+      id: {
         type: "number",
-        description: "Workspace ID"
-      },
-      protocol: {
-        type: "string",
-        enum: ["HTTP", "HTTPS", "SOCKS5", "SSH"],
-        description: "Proxy protocol type"
-      },
-      host: {
-        type: "string",
-        description: "Proxy host/IP address"
-      },
-      port: {
-        type: "string",
-        description: "Proxy port"
-      },
-      proxyUserName: {
-        type: "string",
-        description: "Proxy username"
-      },
-      proxyPassword: {
-        type: "string",
-        description: "Proxy password"
-      },
-      ipType: {
-        type: "string",
-        enum: ["IPV4", "IPV6"],
-        description: "IP type (default: IPV4)"
-      },
-      checkChannel: {
-        type: "string",
-        enum: channelList.map((item) => item.label),
-        description: "IP detection channel (default: IP123.in)"
-      },
-      refreshUrl: {
-        type: "string",
-        description: "Refresh URL for dynamic proxies"
-      },
-      remark: {
-        type: "string",
-        description: "Proxy remark/notes"
+        description: "Proxy ID to get detail for"
       }
     },
-    required: ["workspaceId", "protocol", "host", "port"]
+    required: ["workspaceId", "id"]
   };
   get schema() {
     return {
@@ -794,51 +723,93 @@ var CreateProxy = class {
     };
   }
   async handle(params) {
-    if (!params.workspaceId || !params.protocol || !params.host || !params.port) {
+    if (!params.workspaceId || !params.id) {
       return {
         content: [
           {
             type: "text",
-            text: "\u274C **Failed to create proxy:**\n\n workspaceId, protocol, host, and port are required"
+            text: "\u274C **Failed to get proxy detail:**\n\n workspaceId and id are required"
           }
         ]
       };
     }
-    const { workspaceId, ipType = "IPV4", checkChannel = "IP123.in", ...proxyData } = params;
-    const proxyParams = {
-      workspaceId,
-      ...proxyData,
-      ipType,
-      checkChannel: checkChannel ? channelList.find((item) => item.label === checkChannel)?.value : null,
-      proxyCategory: params.protocol
-    };
-    const result = await request("/proxy/create", {
-      method: "POST",
-      body: JSON.stringify(proxyParams)
-    });
+    const searchParams = new URLSearchParams();
+    searchParams.append("workspaceId", params.workspaceId.toString());
+    searchParams.append("id", params.id.toString());
+    const result = await request(`/proxy/detail?${searchParams}`);
     let text = "";
     if (result.code !== 0) {
-      if (result.data) {
-        text = `\u274C **Failed to create proxy:**
-
- error message: ${result.msg}
-
-${result.data.map((item) => `  - index: ${item.index}, error message: ${item.msg.join(", ")}`).join("\n")}`;
-      } else {
-        text = `\u274C **Failed to create proxy:**
+      text = `\u274C **Failed to get proxy detail:**
 
  error message: ${result.msg}`;
-      }
     } else {
-      text = `\u2705 **Proxy Created Successfully**
-
-**Protocol:** ${params.protocol}
-**Host:** ${params.host}:${params.port}${params.proxyUserName ? `
-**Username:** ${params.proxyUserName}` : ""}${params.remark ? `
-**Remark:** ${params.remark}` : ""}${params.checkChannel ? `
-**Check Channel:** ${params.checkChannel}` : ""}
+      const detail = result.data?.rows?.[0] || result.data || null;
+      if (!detail) {
+        text = `\u274C **Proxy Not Found**
 
-*Proxy configuration created. IP detection will be performed automatically.*`;
+No proxy detail found for ID ${params.id} in workspace ${params.workspaceId}.`;
+      } else {
+        const sourceType = formatProxySource(detail.dataType);
+        const sourceSpecificTitle = detail.dataType === "buyProxy" ? "Store Purchase Fields" : "User-added Fields";
+        const authText = detail.proxyUserName && detail.proxyPassword ? `${detail.proxyUserName}:${detail.proxyPassword}` : detail.proxyUserName || detail.proxyPassword || "N/A";
+        const commonLines = [
+          `**ID:** ${formatValue(detail.id)}`,
+          `**Source Type:** ${sourceType}`,
+          `**Workspace ID:** ${formatValue(detail.workspaceId)}`,
+          `**User ID:** ${formatValue(detail.userId)}`,
+          `**Remark:** ${formatValue(detail.remark)}`,
+          `**Protocol:** ${formatValue(detail.protocol)}`,
+          `**Host:** ${formatValue(detail.host)}`,
+          `**Port:** ${formatValue(detail.port)}`,
+          `**IP Type:** ${formatValue(detail.ipType)}`,
+          `**Proxy Account:** ${authText}`,
+          `**Bind Status:** ${formatBool(detail.isBind, "bound", "not bound")}`,
+          `**Bind Count:** ${formatValue(detail.bindCount)}`,
+          `**Bound Browser IDs:** ${formatValue(detail.bindList)}`,
+          `**Direct Connection:** ${formatBool(detail.isDirect)}`,
+          `**Check Status:** ${formatCheckStatus(detail.checkStatus)}`,
+          `**Check Channel:** ${formatValue(detail.checkChannel)}`,
+          `**Check Channel Value:** ${formatValue(detail.checkChannelValue)}`,
+          `**Last Check Time:** ${formatValue(detail.checkTime)}`,
+          `**Last IP:** ${formatValue(detail.lastIp)}`,
+          `**Last Location:** ${formatLocation(detail)}`,
+          `**Created At:** ${formatValue(detail.createTime)}`,
+          `**Updated At:** ${formatValue(detail.updateTime)}`
+        ];
+        const userAddedLines = [
+          `**Refresh URL:** ${formatValue(detail.refreshUrl)}`,
+          `**Model Param:** ${formatValue(detail.modelParam)}`
+        ];
+        const storePurchaseLines = [
+          `**Order No:** ${formatValue(detail.orderNo)}`,
+          `**Order Status:** ${formatValue(detail.orderStatus)}`,
+          `**Country:** ${formatValue(detail.country)}`,
+          `**Provider Type:** ${formatValue(detail.providerType)}`,
+          `**Provider Name:** ${formatValue(detail.proxyProviderName)}`,
+          `**Provider ID:** ${formatValue(detail.proxyProviderId)}`,
+          `**Provider Price:** ${formatValue(detail.proxyProviderPrice)}`,
+          `**Discount Price:** ${formatValue(detail.proxyProviderDiscountPrice)}`,
+          `**Proxy Check Channel:** ${formatValue(detail.proxyCheckChannel)}`,
+          `**Expire Date:** ${formatValue(detail.expireDate)}`,
+          `**Expire Status:** ${formatValue(detail.proxyExpireStatus)}`,
+          `**Auto Renew:** ${formatBool(detail.autoRenew, "enabled", "disabled")}`,
+          `**Can Renew:** ${formatBool(detail.canRenew)}`,
+          `**Can Refund:** ${formatBool(detail.canRefund)}`,
+          `**Renewal Time:** ${formatValue(detail.renewalTime)}`,
+          `**Proxy Months:** ${formatValue(detail.proxyMonths)}`,
+          `**Gift Days:** ${formatValue(detail.giftDays)}`,
+          `**Replace Status:** ${formatValue(detail.replaceStatus)}`,
+          `**Badge Type:** ${formatValue(detail.badgeTypeDesc)}`,
+          `**Operator Name:** ${formatValue(detail.opName)}`
+        ];
+        const sourceSpecificLines = detail.dataType === "buyProxy" ? storePurchaseLines : userAddedLines;
+        text = `\u{1F50E} **Proxy Detail**
+
+${commonLines.join("\n")}
+
+**${sourceSpecificTitle}:**
+${sourceSpecificLines.join("\n")}`;
+      }
     }
     return {
       content: [
@@ -850,8 +821,8 @@ ${result.data.map((item) => `  - index: ${item.index}, error message: ${item.msg
     };
   }
 };
-var BatchCreateProxies = class {
-  name = "roxy_batch_create_proxies";
+var CreateProxies = class {
+  name = "roxy_create_proxies";
   description = "Batch create multiple proxy configurations";
   inputSchema = {
     type: "object",
@@ -860,11 +831,6 @@ var BatchCreateProxies = class {
         type: "number",
         description: "Workspace ID"
       },
-      // checkChannel: {
-      //   type: 'string',
-      //   enum: channelList.map(item => item.label),
-      //   description: 'Default IP detection channel for all proxies',
-      // },
       proxyList: {
         type: "array",
         description: "Array of proxy configurations",
@@ -1199,9 +1165,8 @@ ${params.ids.map((id, index) => `  ${index + 1}. ${id}`).join("\n")}
   }
 };
 var proxyList = new ProxyList();
-var proxyStore = new ProxyStore();
-var createProxy = new CreateProxy();
-var batchCreateProxies = new BatchCreateProxies();
+var proxyDetail = new GetProxyDetail();
+var createProxies = new CreateProxies();
 var detectProxy = new DetectProxy();
 var modifyProxy = new ModifyProxy();
 var deleteProxies = new DeleteProxies();
@@ -1713,7 +1678,7 @@ var CreateBrowser = class {
         description: "Complete proxy configuration object",
         properties: {
           // 如果有 moduleId ，则其他参数不可传递 (moduleId 可通过 roxy_list_proxies 或 roxy_store_proxies 获取) 优先使用该参数来绑定代理IP
-          moduleId: { type: "number", description: `If moduleId is provided, no other parameters may be passed. (moduleId can be obtained via ${proxyList.name} or ${proxyStore.name}. field: id) Priority to use this parameter to bind proxy IP` },
+          moduleId: { type: "number", description: `If moduleId is provided, no other parameters may be passed. (moduleId can be obtained via ${proxyList.name} field: id) Priority to use this parameter to bind proxy IP` },
           proxyMethod: { type: "string", enum: ["custom", "choose", "api"] },
           proxyCategory: { type: "string", enum: ["noproxy", "HTTP", "HTTPS", "SOCKS5", "SSH"] },
           ipType: { type: "string", enum: ["IPV4", "IPV6"] },
@@ -2168,11 +2133,12 @@ var ListBrowsers = class {
       const pageSize = params.pageSize ?? 15;
       const totalPages = Math.max(1, Math.ceil((data.total || 0) / pageSize));
       const hasNextPage = currentPage < totalPages;
+      const serialNo = `${data.workspaceName?.slice(0, 3).toLocaleUpperCase()}-${data.windowSortNum}`;
       text = `Found ${data.total} browsers in workspace ${params.workspaceId}:
 
 ${data.rows.map(
-        (browser) => `**${browser.windowName || "Unnamed"}** (ID: ${browser.dirId})
-  - coreVersion: ${browser.coreVersion}  - Sort: ${browser.windowSortNum}
+        (browser) => `**${browser.windowName || "Unnamed"}** (Serial No: ${serialNo})
+  - CoreVersion: ${browser.coreVersion}  - DirId: ${browser.dirId}
   - OSVersion: ${browser.osVersion}
   - OS: ${browser.os}
   - Remark: ${browser.windowRemark}`
@@ -2387,11 +2353,13 @@ var GetBrowserDetail = class {
       } else {
         const cookieCount = detail.cookie?.length || 0;
         const { cookie: _cookie, ...detailWithoutCookies } = detail;
+        const serialNo = `${detail.workspaceName?.slice(0, 3).toLocaleUpperCase()}-${detail.windowSortNum}`;
         text = `**Browser Details Summary**
 
 **ID:** \`${detail.dirId}\`
+**dirId**: \`${detail.dirId}\`
+**Serial No:** ${serialNo}
 **Name:** ${detail.windowName}
-**Sort Number:** ${detail.windowSortNum}
 **Project:** ${detail.projectName} (ID: ${detail.projectId})
 **OS:** ${detail.os} ${detail.osVersion}
 **Core Version:** ${detail.coreVersion}
@@ -2980,9 +2948,8 @@ var TOOLS = [
   listLabels.schema,
   getConnectionInfo.schema,
   proxyList.schema,
-  proxyStore.schema,
-  createProxy.schema,
-  batchCreateProxies.schema,
+  proxyDetail.schema,
+  createProxies.schema,
   detectProxy.schema,
   modifyProxy.schema,
   deleteProxies.schema,
@@ -3060,12 +3027,10 @@ var RoxyBrowserMCPServer = class {
           // 代理相关
           case proxyList.name:
             return await proxyList.handle(args);
-          case proxyStore.name:
-            return await proxyStore.handle(args);
-          case createProxy.name:
-            return await createProxy.handle(args);
-          case batchCreateProxies.name:
-            return await batchCreateProxies.handle(args);
+          case proxyDetail.name:
+            return await proxyDetail.handle(args);
+          case createProxies.name:
+            return await createProxies.handle(args);
           case detectProxy.name:
             return await detectProxy.handle(args);
           case modifyProxy.name: