@mcp-use/cli 3.3.2-canary.2 → 3.3.2-canary.4

package/dist/index.js

@@ -1209,6 +1209,39 @@ var ApiUnauthorizedError = class extends Error {
     this.name = "ApiUnauthorizedError";
   }
 };
+function normalizePaginatedResponse(response, params) {
+  if (Array.isArray(response)) {
+    return {
+      items: response,
+      total: response.length,
+      limit: params?.limit ?? response.length,
+      skip: params?.skip ?? 0
+    };
+  }
+  return {
+    items: response.items,
+    total: response.total,
+    limit: response.limit,
+    skip: response.skip
+  };
+}
+function buildPaginationQuery(params) {
+  const search = new URLSearchParams();
+  if (params?.organizationId) {
+    search.set("organizationId", params.organizationId);
+  }
+  if (params?.limit != null) {
+    search.set("limit", String(params.limit));
+  }
+  if (params?.skip != null) {
+    search.set("skip", String(params.skip));
+  }
+  if (params?.sort) {
+    search.set("sort", params.sort);
+  }
+  const q = search.toString();
+  return q ? `?${q}` : "";
+}
 var McpUseAPI = class _McpUseAPI {
   baseUrl;
   apiKey;
@@ -1337,21 +1370,8 @@ var McpUseAPI = class _McpUseAPI {
     });
   }
   async listServers(params) {
-    const search = new URLSearchParams();
-    if (params?.organizationId) {
-      search.set("organizationId", params.organizationId);
-    }
-    if (params?.limit != null) {
-      search.set("limit", String(params.limit));
-    }
-    if (params?.skip != null) {
-      search.set("skip", String(params.skip));
-    }
-    if (params?.sort) {
-      search.set("sort", params.sort);
-    }
-    const q = search.toString();
-    return this.request(`/servers${q ? `?${q}` : ""}`);
+    const response = await this.request(`/servers${buildPaginationQuery(params)}`);
+    return normalizePaginatedResponse(response, params);
   }
   async getServer(idOrSlug) {
     const path12 = encodeURIComponent(idOrSlug);
@@ -1405,8 +1425,9 @@ var McpUseAPI = class _McpUseAPI {
   async getDeployment(deploymentId) {
     return this.request(`/deployments/${deploymentId}`);
   }
-  async listDeployments() {
-    return this.request("/deployments");
+  async listDeployments(params) {
+    const response = await this.request(`/deployments${buildPaginationQuery(params)}`);
+    return normalizePaginatedResponse(response, params);
   }
   async deleteDeployment(deploymentId) {
     await this.request(`/deployments/${deploymentId}`, {
@@ -5848,6 +5869,7 @@ async function deployCommand(options) {
 
 // src/commands/deployments.ts
 import { Command as Command3 } from "commander";
+var DEFAULT_LIST_LIMIT = 30;
 async function prompt2(question) {
   const readline = await import("readline");
   const rl = readline.createInterface({
@@ -5879,7 +5901,23 @@ function getStatusColor(status) {
 function formatId(id) {
   return id;
 }
-async function listDeploymentsCommand() {
+function formatPageHeader(label, count, total) {
+  return count === total ? `${label} (${total})` : `${label} (${count} of ${total})`;
+}
+function printNextPageHint(command, page, extraArgs = []) {
+  const nextSkip = page.skip + page.items.length;
+  if (nextSkip >= page.total) return;
+  const args = [
+    command,
+    "--limit",
+    String(page.limit),
+    "--skip",
+    String(nextSkip),
+    ...extraArgs
+  ];
+  console.log(source_default.gray(`Next page: ${args.join(" ")}`));
+}
+async function listDeploymentsCommand(options) {
   try {
     if (!await isLoggedIn()) {
       console.log(source_default.red("\u2717 You are not logged in."));
@@ -5890,11 +5928,26 @@ async function listDeploymentsCommand() {
       );
       process.exit(1);
     }
+    const limit = options.limit ? parseInt(options.limit, 10) : DEFAULT_LIST_LIMIT;
+    const skip = options.skip ? parseInt(options.skip, 10) : void 0;
+    if (limit !== void 0 && (Number.isNaN(limit) || limit < 1)) {
+      console.log(source_default.red("\u2717 Invalid --limit"));
+      process.exit(1);
+    }
+    if (skip !== void 0 && (Number.isNaN(skip) || skip < 0)) {
+      console.log(source_default.red("\u2717 Invalid --skip"));
+      process.exit(1);
+    }
     const api = await McpUseAPI.create();
-    const [deployments, authResult] = await Promise.all([
-      api.listDeployments(),
+    const [page, authResult] = await Promise.all([
+      api.listDeployments({
+        limit,
+        skip,
+        sort: options.sort ?? "createdAt:desc"
+      }),
       api.testAuth()
     ]);
+    const deployments = page.items;
     const orgMap = new Map(authResult.orgs.map((o) => [o.id, o.name]));
     const uniqueServerIds = [
       ...new Set(
@@ -5916,18 +5969,31 @@ async function listDeploymentsCommand() {
       (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime()
     );
     if (sortedDeployments.length === 0) {
-      console.log(source_default.yellow("No deployments found."));
-      console.log(
-        source_default.gray(
-          "\nDeploy your first MCP server with " + source_default.white("mcp-use deploy")
-        )
-      );
+      if (page.total === 0) {
+        console.log(source_default.yellow("No deployments found."));
+        console.log(
+          source_default.gray(
+            "\nDeploy your first MCP server with " + source_default.white("mcp-use deploy")
+          )
+        );
+      } else {
+        console.log(
+          source_default.yellow(`No deployments found at --skip ${page.skip}.`)
+        );
+        console.log(source_default.gray(`Total deployments: ${page.total}`));
+      }
       return;
     }
     console.log(
-      source_default.cyan.bold(`
-\u{1F4E6} Deployments (${sortedDeployments.length})
-`)
+      source_default.cyan.bold(
+        `
+\u{1F4E6} ${formatPageHeader(
+          "Deployments",
+          sortedDeployments.length,
+          page.total
+        )}
+`
+      )
     );
     console.log(
       source_default.white.bold(
@@ -5948,6 +6014,9 @@ async function listDeploymentsCommand() {
         `${source_default.gray(id)} ${name} ${source_default.magenta(org)} ${status} ${source_default.cyan(mcpUrl)} ${source_default.gray(created)}`
       );
     }
+    const extraArgs = [];
+    if (options.sort) extraArgs.push("--sort", options.sort);
+    printNextPageHint("mcp-use deployments list", page, extraArgs);
     console.log();
   } catch (error) {
     handleCommandError(error, "Failed to list deployments");
@@ -6262,7 +6331,7 @@ function createDeploymentsCommand() {
   const deploymentsCommand = new Command3("deployments").description("Manage cloud deployments").showHelpAfterError(
     "(Run `mcp-use deployments --help` to see available commands)"
   );
-  deploymentsCommand.command("list").alias("ls").description("List all deployments").action(listDeploymentsCommand);
+  deploymentsCommand.command("list").alias("ls").description("List deployments").option("--limit <n>", "Page size (default 30)").option("--skip <n>", "Offset for pagination").option("--sort <field:asc|desc>", "Sort (e.g. createdAt:desc)").action(listDeploymentsCommand);
   deploymentsCommand.command("get").argument("<deployment-id>", "Deployment ID").description("Get deployment details").action(getDeploymentCommand);
   deploymentsCommand.command("restart").argument("<deployment-id>", "Deployment ID").option("-f, --follow", "Follow build logs").description(
     "Restart a deployment (triggers a new deployment on the same server)"
@@ -6441,6 +6510,7 @@ function createEnvCommand() {
 }
 
 // src/commands/servers.ts
+var DEFAULT_LIST_LIMIT2 = 30;
 async function prompt3(question) {
   const readline = await import("readline");
   const rl = readline.createInterface({
@@ -6488,6 +6558,22 @@ function getStatusColor2(status) {
   if (s.includes("build") || s.includes("pend")) return source_default.yellow;
   return source_default.gray;
 }
+function formatPageHeader2(label, count, total) {
+  return count === total ? `${label} (${total})` : `${label} (${count} of ${total})`;
+}
+function printNextPageHint2(command, page, extraArgs = []) {
+  const nextSkip = page.skip + page.items.length;
+  if (nextSkip >= page.total) return;
+  const args = [
+    command,
+    "--limit",
+    String(page.limit),
+    "--skip",
+    String(nextSkip),
+    ...extraArgs
+  ];
+  console.log(source_default.gray(`Next page: ${args.join(" ")}`));
+}
 async function listServersCommand(options) {
   try {
     if (!await isLoggedIn()) {
@@ -6502,7 +6588,7 @@ async function listServersCommand(options) {
     const api = await McpUseAPI.create();
     await applyOrgOption(api, options.org);
     if (options.org) console.log();
-    const limit = options.limit ? parseInt(options.limit, 10) : void 0;
+    const limit = options.limit ? parseInt(options.limit, 10) : DEFAULT_LIST_LIMIT2;
     const skip = options.skip ? parseInt(options.skip, 10) : void 0;
     if (limit !== void 0 && (Number.isNaN(limit) || limit < 1)) {
       console.log(source_default.red("\u2717 Invalid --limit"));
@@ -6512,23 +6598,33 @@ async function listServersCommand(options) {
       console.log(source_default.red("\u2717 Invalid --skip"));
       process.exit(1);
     }
-    const servers = await api.listServers({
+    const page = await api.listServers({
       limit,
       skip,
       sort: options.sort
     });
+    const servers = page.items;
     if (servers.length === 0) {
-      console.log(source_default.yellow("No servers found."));
-      console.log(
-        source_default.gray(
-          "\nCreate one by deploying with " + source_default.white("mcp-use deploy")
-        )
-      );
+      if (page.total === 0) {
+        console.log(source_default.yellow("No servers found."));
+        console.log(
+          source_default.gray(
+            "\nCreate one by deploying with " + source_default.white("mcp-use deploy")
+          )
+        );
+      } else {
+        console.log(source_default.yellow(`No servers found at --skip ${page.skip}.`));
+        console.log(source_default.gray(`Total servers: ${page.total}`));
+      }
       return;
     }
-    console.log(source_default.cyan.bold(`
-\u{1F5A5}  Servers (${servers.length})
-`));
+    console.log(
+      source_default.cyan.bold(
+        `
+\u{1F5A5}  ${formatPageHeader2("Servers", servers.length, page.total)}
+`
+      )
+    );
     console.log(
       source_default.white.bold(
         `${"ID".padEnd(38)} ${"NAME".padEnd(22)} ${"STATUS".padEnd(14)} ${"REPO".padEnd(32)} ${"MCP URL".padEnd(52)}`
@@ -6546,6 +6642,10 @@ async function listServersCommand(options) {
         `${source_default.gray(id)} ${name} ${status} ${source_default.gray(repo)} ${source_default.cyan(mcp)}`
       );
     }
+    const extraArgs = [];
+    if (options.sort) extraArgs.push("--sort", options.sort);
+    if (options.org) extraArgs.push("--org", options.org);
+    printNextPageHint2("mcp-use servers list", page, extraArgs);
     console.log();
   } catch (error) {
     handleCommandError(error, "Failed to list servers");
@@ -6708,7 +6808,7 @@ function createServersCommand() {
   const serversCommand = new Command5("servers").description("Manage cloud servers (Git-backed deploy targets)").showHelpAfterError(
     "(Run `mcp-use servers --help` to see available commands)"
   );
-  serversCommand.command("list").alias("ls").description("List servers for the current organization").option("--org <slug-or-id>", "Target organization (slug, id, or name)").option("--limit <n>", "Page size (1\u2013100, default 50)").option("--skip <n>", "Offset for pagination").option("--sort <field:asc|desc>", "Sort (e.g. updatedAt:desc)").action(listServersCommand);
+  serversCommand.command("list").alias("ls").description("List servers for the current organization").option("--org <slug-or-id>", "Target organization (slug, id, or name)").option("--limit <n>", "Page size (default 30)").option("--skip <n>", "Offset for pagination").option("--sort <field:asc|desc>", "Sort (e.g. updatedAt:desc)").action(listServersCommand);
   serversCommand.command("get").argument("<id-or-slug>", "Server UUID or slug").option("--org <slug-or-id>", "Resolve org context before fetch").description("Show server details and recent deployments").action(getServerCommand);
   serversCommand.command("delete").alias("rm").argument("<server-id>", "Server UUID (or slug if API accepts it)").option("-y, --yes", "Skip confirmation prompt").option("--org <slug-or-id>", "Target organization").description("Delete a server and all its deployments").action(deleteServerCommand);
   serversCommand.addCommand(createEnvCommand());