@xbrowser/cli 0.14.2 → 0.15.0

package/dist/index.js

@@ -191,7 +191,18 @@ function parsePluginParams(args, schema, base = {}) {
         if (value === "true") params[key] = true;
         else if (value === "false") params[key] = false;
         else if (/^\d+$/.test(value)) params[key] = parseInt(value, 10);
-        else params[key] = value;
+        else {
+          try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed) || typeof parsed === "object" && parsed !== null) {
+              params[key] = parsed;
+            } else {
+              params[key] = value;
+            }
+          } catch {
+            params[key] = value;
+          }
+        }
         i++;
       } else {
         params[key] = true;
@@ -6535,8 +6546,48 @@ async function loadHooks() {
 // src/executor.ts
 import { homedir as homedir3 } from "os";
 import { join as join3 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync9, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
 var NAVIGATION_COMMANDS = /* @__PURE__ */ new Set(["goto", "back", "forward", "refresh"]);
 var snapshotHintShown = /* @__PURE__ */ new WeakSet();
+var STORAGE_DIR = join3(homedir3(), ".xbrowser", "storage");
+var storageCache = /* @__PURE__ */ new Map();
+function getPluginStorage(pluginName) {
+  if (!storageCache.has(pluginName)) {
+    const filePath = join3(STORAGE_DIR, `${pluginName}.json`);
+    let data = {};
+    const load3 = () => {
+      if (existsSync6(filePath)) {
+        try {
+          data = JSON.parse(readFileSync9(filePath, "utf-8"));
+        } catch {
+          data = {};
+        }
+      }
+    };
+    const save = () => {
+      mkdirSync3(STORAGE_DIR, { recursive: true });
+      writeFileSync4(filePath, JSON.stringify(data, null, 2), "utf-8");
+    };
+    load3();
+    storageCache.set(pluginName, {
+      get: async (key) => data[key] ?? null,
+      set: async (key, value) => {
+        data[key] = value;
+        save();
+      },
+      delete: async (key) => {
+        delete data[key];
+        save();
+      },
+      clear: async () => {
+        data = {};
+        save();
+      },
+      keys: async () => Object.keys(data)
+    });
+  }
+  return storageCache.get(pluginName);
+}
 var archiveInitialized = false;
 function ensureArchiveInit() {
   if (!archiveInitialized) {
@@ -6647,16 +6698,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     args: [],
     options: {},
     cwd: process.cwd(),
-    storage: {
-      get: async () => null,
-      set: async () => {
-      },
-      delete: async () => {
-      },
-      clear: async () => {
-      },
-      keys: async () => []
-    },
+    storage: getPluginStorage(commandName),
     output: {
       mode: "text",
       showTips: false,
@@ -6879,16 +6921,7 @@ async function executeChain(input, options) {
             browser: session.context.browser(),
             browserContext: session.context,
             sessionId: session.id,
-            storage: {
-              get: async (_key) => null,
-              set: async (_key, _value) => {
-              },
-              delete: async (_key) => {
-              },
-              clear: async () => {
-              },
-              keys: async () => []
-            },
+            storage: getPluginStorage(cmdName),
             output: { mode: "text", showTips: false, color: false, emoji: false },
             error: (msg) => {
               throw new Error(msg);
@@ -6899,8 +6932,21 @@ async function executeChain(input, options) {
           };
           const start2 = Date.now();
           try {
+            const hooks = await loadHooks();
+            if (hooks.length > 0) {
+              await Promise.all(hooks.map((h) => h.onBeforeCommand?.({ page: session.page, command: `${cmdName} ${subCommand}`, params: pluginParams })));
+            }
             const raw = await cmdEntry.handler(pluginParams, pluginCtx);
             const duration2 = Date.now() - start2;
+            let hookOutputs;
+            if (hooks.length > 0) {
+              const outputs = [];
+              for (const h of hooks) {
+                const output = await h.onAfterCommand?.({ page: session.page, command: `${cmdName} ${subCommand}`, params: pluginParams, result: raw, duration: duration2 });
+                if (output) outputs.push({ _hook: h.name, ...output });
+              }
+              if (outputs.length > 0) hookOutputs = outputs;
+            }
             const data = raw?.data ?? raw;
             recordArchive(session.id, sessionName, {
               step: results.length,
@@ -6915,7 +6961,8 @@ async function executeChain(input, options) {
               command: `${cmdName} ${subCommand}`,
               raw: cmdStr,
               ...ok25(data),
-              duration: duration2
+              duration: duration2,
+              ...hookOutputs ? { hookOutputs } : {}
             });
             if (type === "or") {
               return {
@@ -6979,7 +7026,8 @@ async function executeChain(input, options) {
           data: result.data,
           message: result.message,
           duration,
-          tips: result.tips
+          tips: result.tips,
+          ...result.hookOutputs ? { hookOutputs: result.hookOutputs } : {}
         };
         results.push(stepResult);
         if (type === "and" && !result.success) {
@@ -7285,26 +7333,26 @@ var configBuiltin = {
 
 // src/plugin/installer.ts
 import {
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   readdirSync as readdirSync3,
-  mkdirSync as mkdirSync7,
+  mkdirSync as mkdirSync8,
   rmSync as rmSync7
 } from "fs";
 import { resolve as resolve15, basename as basename2 } from "path";
 import { homedir as homedir4 } from "os";
 
 // src/plugin/install-sources/local.ts
-import { existsSync as existsSync7, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync8, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
 import { resolve as resolve10 } from "path";
 
 // src/plugin/install-utils.ts
 import {
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   readdirSync as readdirSync2,
   cpSync,
   rmSync,
-  mkdirSync as mkdirSync3,
-  readFileSync as readFileSync9,
+  mkdirSync as mkdirSync4,
+  readFileSync as readFileSync10,
   createWriteStream
 } from "fs";
 import { resolve as resolve9 } from "path";
@@ -7375,7 +7423,7 @@ async function downloadToFile(url, destPath) {
   await pipeline(nodeStream, createWriteStream(destPath));
 }
 function extractTarGz(tarballPath, targetDir) {
-  mkdirSync3(targetDir, { recursive: true });
+  mkdirSync4(targetDir, { recursive: true });
   execSync7(`tar -xzf "${tarballPath}" -C "${targetDir}"`, { stdio: "pipe" });
 }
 function flattenPackageRoot(targetDir) {
@@ -7396,18 +7444,18 @@ function flattenPackageRoot(targetDir) {
 async function verifyPlugin(dir) {
   const warnings = [];
   const indexPath = resolve9(dir, "index.ts");
-  if (!existsSync6(indexPath)) {
+  if (!existsSync7(indexPath)) {
     const indexJs = resolve9(dir, "index.js");
-    if (!existsSync6(indexJs)) {
+    if (!existsSync7(indexJs)) {
       return { valid: false, error: "No index.ts or index.js entry point found", warnings };
     }
   }
   const pkgPath = resolve9(dir, "package.json");
-  if (!existsSync6(pkgPath)) {
+  if (!existsSync7(pkgPath)) {
     warnings.push("No package.json found");
   } else {
     try {
-      const pkg2 = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+      const pkg2 = JSON.parse(readFileSync10(pkgPath, "utf-8"));
       if (!pkg2.xbrowser) {
         warnings.push("No xbrowser metadata in package.json");
       }
@@ -7427,7 +7475,7 @@ function safeCleanup(dir) {
 // src/plugin/install-sources/local.ts
 async function installFromLocal(source, name, targetDir) {
   const srcPath = resolve10(source);
-  if (!existsSync7(srcPath)) {
+  if (!existsSync8(srcPath)) {
     throw new Error(`Local path does not exist: ${srcPath}`);
   }
   const tmpTarget = `${targetDir}-tmp-${Date.now()}`;
@@ -7440,7 +7488,7 @@ async function installFromLocal(source, name, targetDir) {
       safeCleanup(tmpTarget);
       throw new Error(`Invalid plugin: ${verify.error}`);
     }
-    if (existsSync7(targetDir)) {
+    if (existsSync8(targetDir)) {
       rmSync2(targetDir, { recursive: true, force: true });
     }
     cpSync2(tmpTarget, targetDir, { recursive: true, force: true });
@@ -7460,7 +7508,7 @@ async function installFromLocal(source, name, targetDir) {
 }
 
 // src/plugin/install-sources/npm.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync10, writeFileSync as writeFileSync4, rmSync as rmSync3, cpSync as cpSync3 } from "fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync5, rmSync as rmSync3, cpSync as cpSync3 } from "fs";
 import { resolve as resolve11, join as join4 } from "path";
 import { tmpdir } from "os";
 async function installFromNpm(packageName, name, targetDir) {
@@ -7481,7 +7529,7 @@ async function installFromNpm(packageName, name, targetDir) {
   }
   const tarballUrl = versionMeta.dist.tarball;
   const tmpDir = join4(tmpdir(), `xbrowser-npm-${Date.now()}`);
-  mkdirSync4(tmpDir, { recursive: true });
+  mkdirSync5(tmpDir, { recursive: true });
   let warnings = [];
   try {
     const tarballPath = join4(tmpDir, `${name}.tgz`);
@@ -7494,16 +7542,16 @@ async function installFromNpm(packageName, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid npm plugin: ${verify.error}`);
     }
-    if (existsSync8(targetDir)) {
+    if (existsSync9(targetDir)) {
       rmSync3(targetDir, { recursive: true, force: true });
     }
     cpSync3(extractDir, targetDir, { recursive: true, force: true });
     const pkgPath = resolve11(targetDir, "package.json");
-    if (existsSync8(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync10(pkgPath, "utf-8"));
+    if (existsSync9(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync11(pkgPath, "utf-8"));
       if (!pkg2._npmSource) {
         pkg2._npmSource = { name: packageName, version: latestVersion };
-        writeFileSync4(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync5(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7520,7 +7568,7 @@ async function installFromNpm(packageName, name, targetDir) {
 }
 
 // src/plugin/install-sources/git.ts
-import { existsSync as existsSync9, readFileSync as readFileSync11, writeFileSync as writeFileSync5, rmSync as rmSync4, cpSync as cpSync4 } from "fs";
+import { existsSync as existsSync10, readFileSync as readFileSync12, writeFileSync as writeFileSync6, rmSync as rmSync4, cpSync as cpSync4 } from "fs";
 import { resolve as resolve12, join as join5 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 import { execSync as execSync8 } from "child_process";
@@ -7534,17 +7582,17 @@ async function installFromGit(gitUrl, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid git plugin: ${verify.error}`);
     }
-    if (existsSync9(targetDir)) {
+    if (existsSync10(targetDir)) {
       rmSync4(targetDir, { recursive: true, force: true });
     }
     cpSync4(tmpDir, targetDir, { recursive: true, force: true });
     rmSync4(resolve12(targetDir, ".git"), { recursive: true, force: true });
     const pkgPath = resolve12(targetDir, "package.json");
-    if (existsSync9(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync11(pkgPath, "utf-8"));
+    if (existsSync10(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync12(pkgPath, "utf-8"));
       if (!pkg2._gitSource) {
         pkg2._gitSource = { url: gitUrl };
-        writeFileSync5(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync6(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7561,12 +7609,12 @@ async function installFromGit(gitUrl, name, targetDir) {
 }
 
 // src/plugin/install-sources/url.ts
-import { existsSync as existsSync10, readFileSync as readFileSync12, writeFileSync as writeFileSync6, mkdirSync as mkdirSync5, rmSync as rmSync5, cpSync as cpSync5 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync7, mkdirSync as mkdirSync6, rmSync as rmSync5, cpSync as cpSync5 } from "fs";
 import { resolve as resolve13, join as join6, basename } from "path";
 import { tmpdir as tmpdir3 } from "os";
 async function installFromUrl(url, name, targetDir) {
   const tmpDir = join6(tmpdir3(), `xbrowser-url-${Date.now()}`);
-  mkdirSync5(tmpDir, { recursive: true });
+  mkdirSync6(tmpDir, { recursive: true });
   let warnings = [];
   try {
     const fileName = basename(new URL(url).pathname) || "plugin.tar.gz";
@@ -7580,16 +7628,16 @@ async function installFromUrl(url, name, targetDir) {
     if (!verify.valid) {
       throw new Error(`Invalid plugin from URL: ${verify.error}`);
     }
-    if (existsSync10(targetDir)) {
+    if (existsSync11(targetDir)) {
       rmSync5(targetDir, { recursive: true, force: true });
     }
     cpSync5(extractDir, targetDir, { recursive: true, force: true });
     const pkgPath = resolve13(targetDir, "package.json");
-    if (existsSync10(pkgPath)) {
-      const pkg2 = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+    if (existsSync11(pkgPath)) {
+      const pkg2 = JSON.parse(readFileSync13(pkgPath, "utf-8"));
       if (!pkg2._urlSource) {
         pkg2._urlSource = { url };
-        writeFileSync6(pkgPath, JSON.stringify(pkg2, null, 2));
+        writeFileSync7(pkgPath, JSON.stringify(pkg2, null, 2));
       }
     }
   } finally {
@@ -7607,10 +7655,10 @@ async function installFromUrl(url, name, targetDir) {
 
 // src/plugin/install-sources/marketplace.ts
 import {
-  existsSync as existsSync11,
-  mkdirSync as mkdirSync6,
-  writeFileSync as writeFileSync7,
-  readFileSync as readFileSync13,
+  existsSync as existsSync12,
+  mkdirSync as mkdirSync7,
+  writeFileSync as writeFileSync8,
+  readFileSync as readFileSync14,
   rmSync as rmSync6,
   cpSync as cpSync6
 } from "fs";
@@ -7632,12 +7680,12 @@ async function installFromMarketplace(pluginsDir, slug, options) {
   const plugin = detailData.data;
   const name = options?.name || String(plugin.slug || slug);
   const targetDir = resolve14(pluginsDir, name);
-  if (existsSync11(targetDir) && !options?.force) {
+  if (existsSync12(targetDir) && !options?.force) {
     throw new Error(`Plugin "${name}" already exists. Use --force to overwrite.`);
   }
-  mkdirSync6(targetDir, { recursive: true });
+  mkdirSync7(targetDir, { recursive: true });
   const tmpDir = join7(tmpdir4(), `xbrowser-marketplace-${Date.now()}`);
-  mkdirSync6(tmpDir, { recursive: true });
+  mkdirSync7(tmpDir, { recursive: true });
   const realSlug = String(plugin.slug || slug);
   try {
     await downloadAndExtractMarketplaceTarball(baseUrl, realSlug, tmpDir, targetDir);
@@ -7667,14 +7715,14 @@ function isManifestArray(data) {
   return Array.isArray(data) && data.length > 0 && typeof data[0].path === "string" && typeof data[0].content === "string";
 }
 function extractManifestToDir(manifest, targetDir) {
-  if (existsSync11(targetDir)) {
+  if (existsSync12(targetDir)) {
     rmSync6(targetDir, { recursive: true, force: true });
   }
-  mkdirSync6(targetDir, { recursive: true });
+  mkdirSync7(targetDir, { recursive: true });
   for (const file of manifest) {
     const filePath = resolve14(targetDir, file.path);
-    mkdirSync6(dirname2(filePath), { recursive: true });
-    writeFileSync7(filePath, Buffer.from(file.content, "base64"));
+    mkdirSync7(dirname2(filePath), { recursive: true });
+    writeFileSync8(filePath, Buffer.from(file.content, "base64"));
   }
 }
 function tryParseAsGzippedManifest(buffer) {
@@ -7701,7 +7749,7 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
     const redirectUrl = tarballRes.headers.get("location");
     const tarballPath = join7(tmpDir, `${slug}.tar.gz`);
     await downloadToFile(redirectUrl, tarballPath);
-    const buffer = readFileSync13(tarballPath);
+    const buffer = readFileSync14(tarballPath);
     const manifest = tryParseAsGzippedManifest(buffer);
     if (manifest) {
       extractManifestToDir(manifest, targetDir);
@@ -7710,7 +7758,7 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
     const extractDir = join7(tmpDir, "extracted");
     extractTarGz(tarballPath, extractDir);
     flattenPackageRoot(extractDir);
-    if (existsSync11(targetDir)) {
+    if (existsSync12(targetDir)) {
       rmSync6(targetDir, { recursive: true, force: true });
     }
     cpSync6(extractDir, targetDir, { recursive: true, force: true });
@@ -7722,12 +7770,12 @@ async function downloadAndExtractMarketplaceTarball(baseUrl, slug, tmpDir, targe
       return;
     }
     const tarballPath = join7(tmpDir, `${slug}.tar.gz`);
-    writeFileSync7(tarballPath, buffer);
+    writeFileSync8(tarballPath, buffer);
     try {
       const extractDir = join7(tmpDir, "extracted");
       extractTarGz(tarballPath, extractDir);
       flattenPackageRoot(extractDir);
-      if (existsSync11(targetDir)) {
+      if (existsSync12(targetDir)) {
         rmSync6(targetDir, { recursive: true, force: true });
       }
       cpSync6(extractDir, targetDir, { recursive: true, force: true });
@@ -7763,24 +7811,24 @@ function writeMarketplacePackageJson(plugin, slug, name, baseUrl, targetDir) {
     }
   };
   const pkgPath = resolve14(targetDir, "package.json");
-  if (!existsSync11(pkgPath)) {
-    writeFileSync7(pkgPath, JSON.stringify(packageJson, null, 2));
+  if (!existsSync12(pkgPath)) {
+    writeFileSync8(pkgPath, JSON.stringify(packageJson, null, 2));
   } else {
     try {
-      const existing = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+      const existing = JSON.parse(readFileSync14(pkgPath, "utf-8"));
       const merged = {
         ...existing,
         xbrowser: { ...existing.xbrowser, ...packageJson.xbrowser },
         _marketplace: packageJson._marketplace
       };
-      writeFileSync7(pkgPath, JSON.stringify(merged, null, 2));
+      writeFileSync8(pkgPath, JSON.stringify(merged, null, 2));
     } catch {
-      writeFileSync7(pkgPath, JSON.stringify(packageJson, null, 2));
+      writeFileSync8(pkgPath, JSON.stringify(packageJson, null, 2));
     }
   }
 }
 function ensureIndexFile(plugin, name, targetDir) {
-  if (!existsSync11(resolve14(targetDir, "index.ts")) && !existsSync11(resolve14(targetDir, "index.js"))) {
+  if (!existsSync12(resolve14(targetDir, "index.ts")) && !existsSync12(resolve14(targetDir, "index.js"))) {
     const commands = plugin.commands || [];
     const commandHandlers = commands.length > 0 ? commands.map((cmd) => {
       return [
@@ -7795,7 +7843,7 @@ function ensureIndexFile(plugin, name, targetDir) {
       `    handler: async () => ({ data: { message: 'Hello from ${name}!' }, tips: [] }),`,
       `  });`
     ].join("\n");
-    writeFileSync7(
+    writeFileSync8(
       resolve14(targetDir, "index.ts"),
       [
         `import type { XCLIAPI } from '@dyyz1993/xcli-core';`,
@@ -7834,10 +7882,10 @@ var PluginInstaller = class {
     const type = this.detectSourceType(source);
     const name = options?.name || this.deriveName(source, type);
     const targetDir = resolve15(this.pluginsDir, name);
-    if (existsSync12(targetDir) && !options?.force) {
+    if (existsSync13(targetDir) && !options?.force) {
       throw new Error(`Plugin "${name}" already exists. Use --force to overwrite.`);
     }
-    mkdirSync7(targetDir, { recursive: true });
+    mkdirSync8(targetDir, { recursive: true });
     const resolvedSource = type === "npm" ? await resolveNpmPackageWithFallback(source) : source;
     switch (type) {
       case "local":
@@ -7895,7 +7943,7 @@ var PluginInstaller = class {
    */
   async uninstall(name) {
     const targetDir = resolve15(this.pluginsDir, name);
-    if (!existsSync12(targetDir)) {
+    if (!existsSync13(targetDir)) {
       throw new Error(`Plugin "${name}" not found`);
     }
     rmSync7(targetDir, { recursive: true, force: true });
@@ -7906,7 +7954,7 @@ var PluginInstaller = class {
    * @returns Array of installed plugin information.
    */
   async list(_options) {
-    if (!existsSync12(this.pluginsDir)) return [];
+    if (!existsSync13(this.pluginsDir)) return [];
     const entries = readdirSync3(this.pluginsDir, { withFileTypes: true });
     const plugins = [];
     for (const entry of entries) {
@@ -7914,7 +7962,7 @@ var PluginInstaller = class {
       const pluginPath = resolve15(this.pluginsDir, entry.name);
       const indexPath = resolve15(pluginPath, "index.ts");
       const indexJsPath = resolve15(pluginPath, "index.js");
-      if (!existsSync12(indexPath) && !existsSync12(indexJsPath)) continue;
+      if (!existsSync13(indexPath) && !existsSync13(indexJsPath)) continue;
       const metadata = PluginMetadataParser.parseFromPackageJson(pluginPath);
       let source = "local";
       const pkg2 = readJsonFile(resolve15(pluginPath, "package.json"), {});
@@ -7941,10 +7989,10 @@ var PluginInstaller = class {
     }
     if (source.startsWith("file://")) {
       const filePath = decodeURIComponent(new URL(source).pathname);
-      if (existsSync12(filePath)) return "url";
+      if (existsSync13(filePath)) return "url";
     }
     if (source.endsWith(".git") || source.includes("github.com/")) return "git";
-    if (existsSync12(resolve15(source))) return "local";
+    if (existsSync13(resolve15(source))) return "local";
     return "npm";
   }
   deriveName(source, type) {
@@ -9973,7 +10021,7 @@ async function handleFilter(args, _mode) {
 
 // src/stdin.ts
 import { createInterface } from "readline";
-import { readFileSync as readFileSync14 } from "fs";
+import { readFileSync as readFileSync15 } from "fs";
 async function readStdin2() {
   if (process.stdin.isTTY) return [];
   const lines = [];
@@ -9987,7 +10035,7 @@ async function readStdin2() {
   return lines;
 }
 function readCommandFile(filePath) {
-  const content = readFileSync14(filePath, "utf-8");
+  const content = readFileSync15(filePath, "utf-8");
   return content.split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith("#"));
 }
 
@@ -11255,11 +11303,14 @@ Run "xbrowser ${command} --help" to see available commands.`
             showCommandHelp(command, cmdEntry, { description: site.config.description, name: site.name, url: site.url }, mode);
             return;
           }
-          const params = parsePluginParams(cmdArgsForPlugin, cmdEntry.parameters, options);
+          const pluginNameIdx = argv.indexOf(command);
+          const subCmdIdx = pluginNameIdx >= 0 ? argv.indexOf(subCommand, pluginNameIdx + 1) : -1;
+          const rawPluginArgs = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : [];
+          const params = parsePluginParams(rawPluginArgs, cmdEntry.parameters);
           if (options.target && !params._target) {
             params._target = options.target;
           }
-          const needsBrowser = cmdEntry.scope !== "global";
+          const needsBrowser = cmdEntry.scope === "page";
           if (needsBrowser && !process.env.XBROWSER_DAEMON_WORKER) {
             const { forwardExec } = await import("./daemon-client-3IJD6X4B.js");
             const userTimeout = typeof params.timeout === "number" && params.timeout > 0 ? params.timeout * 1e3 + 3e4 : void 0;
@@ -11296,16 +11347,7 @@ Run "xbrowser ${command} --help" to see available commands.`
             browser: needsBrowser ? session.context.browser() : null,
             browserContext: needsBrowser ? session.context : null,
             sessionId: needsBrowser ? session.id : "",
-            storage: {
-              get: async (_key) => null,
-              set: async (_key, _value) => {
-              },
-              delete: async (_key) => {
-              },
-              clear: async () => {
-              },
-              keys: async () => []
-            },
+            storage: getPluginStorage(command),
             output: { mode, showTips: true, color: true, emoji: true },
             error: (msg) => {
               outputError(msg);
@@ -12560,10 +12602,10 @@ var WSServer = class extends EventEmitter {
       }
       case "file_download": {
         try {
-          const { readFileSync: readFileSync16 } = await import("fs");
+          const { readFileSync: readFileSync17 } = await import("fs");
           const { resolve: resolve16, basename: basename3 } = await import("path");
           const targetPath = resolve16(msg.path);
-          const data = readFileSync16(targetPath);
+          const data = readFileSync17(targetPath);
           const base64 = data.toString("base64");
           const ext = targetPath.split(".").pop()?.toLowerCase() || "";
           const mimeMap = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xbrowser/cli",
-  "version": "0.14.2",
-  "description": "A self-contained browser automation CLI tool — navigate, click, fill forms, extract data, record & replay sessions via YAML scripts",
+  "version": "0.15.0",
+  "description": "Browser automation CLI for web scraping, headless browsing, SEO analysis, and AI agent workflows. A command-line alternative to Playwright, Puppeteer, and Selenium.",
   "type": "module",
   "bin": {
     "xbrowser": "dist/cli.js"
@@ -27,21 +27,37 @@
     "record-replay",
     "browser automation",
     "web scraping",
+    "web-scraping",
     "playwright alternative",
+    "playwright-alternative",
     "puppeteer alternative",
+    "puppeteer-alternative",
     "selenium alternative",
+    "selenium-alternative",
     "web crawler",
+    "web-crawler",
     "headless browser",
+    "headless-browser",
+    "headless-chrome",
     "scrape",
     "crawl",
+    "crawler",
+    "scraping",
     "cli tool",
     "command line",
+    "command-line",
     "browser cli",
+    "browser-cli",
     "anti-detection",
     "record replay",
     "seo tool",
+    "seo",
+    "search-engine",
     "ai agent",
-    "browser plugin"
+    "ai-agent",
+    "browser plugin",
+    "browser-testing",
+    "chrome-devtools-protocol"
   ],
   "author": "dyyz1993",
   "license": "MIT",