@xbrowser/cli 0.14.0 → 0.14.2

package/dist/daemon-main.js

@@ -22,21 +22,15 @@ import {
   saveSessionDiskMeta,
   setActivePage
 } from "./chunk-F3ZWFCJJ.js";
-import {
-  PluginMetadataParser
-} from "./chunk-DESA2KMG.js";
-import {
-  readJsonFile
-} from "./chunk-YEN2ODUI.js";
 
 // src/daemon/daemon-main.ts
-import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync5, appendFileSync } from "fs";
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync5, appendFileSync } from "fs";
 import { join as join6 } from "path";
 import { homedir as homedir6 } from "os";
 import { startHttpServer } from "@dyyz1993/xcli-core";
 
 // src/daemon/rpc-handlers.ts
-import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync4 } from "fs";
+import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync4 } from "fs";
 import { join as join5 } from "path";
 import { homedir as homedir5 } from "os";
 import {
@@ -368,15 +362,15 @@ var clickCommand = registerCommand({
     let detectedNewPage;
     let cleanup;
     if (ctx.browserContext?.on) {
-      const pagePromise = new Promise((resolve8) => {
+      const pagePromise = new Promise((resolve9) => {
         const timer = setTimeout(() => {
           ctx.browserContext.off("page", handler);
-          resolve8(void 0);
+          resolve9(void 0);
         }, 3e3);
         const handler = (page2) => {
           clearTimeout(timer);
           ctx.browserContext.off("page", handler);
-          resolve8(page2);
+          resolve9(page2);
         };
         ctx.browserContext.on("page", handler);
       });
@@ -1134,7 +1128,7 @@ var consoleCheckCommand = registerCommand({
       await page.goto(p.url, { waitUntil: "domcontentloaded" });
     }
     const messages = await page.evaluate((args) => {
-      return new Promise((resolve8) => {
+      return new Promise((resolve9) => {
         const collected = [];
         const originalConsole = {
           log: console.log,
@@ -1201,7 +1195,7 @@ ${a.stack || ""}`;
           console.warn = originalConsole.warn;
           console.error = originalConsole.error;
           console.info = originalConsole.info;
-          resolve8(collected);
+          resolve9(collected);
         }, args.duration);
       });
     }, { duration: p.duration });
@@ -1613,7 +1607,7 @@ async function executeAction(page, action) {
       if (action.selector) {
         await page.waitForSelector(action.selector, { timeout: 3e4 });
       } else if (action.milliseconds) {
-        await new Promise((resolve8) => setTimeout(resolve8, action.milliseconds));
+        await new Promise((resolve9) => setTimeout(resolve9, action.milliseconds));
       } else {
         throw new Error("wait action requires either milliseconds or selector");
       }
@@ -1696,8 +1690,8 @@ var actionsCommand = registerCommand({
         results.push(result);
       }
     })();
-    const timeoutPromise = new Promise((resolve8) => {
-      setTimeout(resolve8, timeoutMs);
+    const timeoutPromise = new Promise((resolve9) => {
+      setTimeout(resolve9, timeoutMs);
     });
     await Promise.race([executionPromise, timeoutPromise]);
     const title = await ctx.page.title();
@@ -2371,11 +2365,11 @@ async function navigateForMap(page, url, timeout = 15e3) {
 }
 async function extractPageLinks(page, baseUrl) {
   await navigateForMap(page, baseUrl);
-  await new Promise((resolve8) => setTimeout(resolve8, 2e3));
+  await new Promise((resolve9) => setTimeout(resolve9, 2e3));
   await page.evaluate(() => {
     window.scrollTo(0, document.body.scrollHeight);
   });
-  await new Promise((resolve8) => setTimeout(resolve8, 1e3));
+  await new Promise((resolve9) => setTimeout(resolve9, 1e3));
   const origin = new URL(baseUrl).origin;
   const rawLinks = await page.evaluate((evalOrigin) => {
     return Array.from(document.querySelectorAll("a[href]")).map((a) => {
@@ -4205,25 +4199,25 @@ aria snapshot\uFF1A
 async function analyzeWithLLM(ariaSnapshot) {
   const piBin = process.env.PI_CLI_PATH || "pi";
   const prompt = LLM_PROMPT.replace("{snapshot}", ariaSnapshot.slice(0, 4e3));
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     execFile(
       piBin,
       ["--provider", LLM_PROVIDER, "--model", LLM_MODEL, prompt],
       { timeout: LLM_TIMEOUT_MS, maxBuffer: 1024 * 1024 },
       (err, stdout, _stderr) => {
         if (err) {
-          resolve8(null);
+          resolve9(null);
           return;
         }
         const output = (stdout || "").trim();
         if (!output) {
-          resolve8(null);
+          resolve9(null);
           return;
         }
         try {
           const parsed = parse(output);
           if (!parsed || typeof parsed !== "object") {
-            resolve8(null);
+            resolve9(null);
             return;
           }
           const elements = {};
@@ -4238,9 +4232,9 @@ async function analyzeWithLLM(ariaSnapshot) {
               };
             }
           }
-          resolve8(Object.keys(elements).length > 0 ? elements : null);
+          resolve9(Object.keys(elements).length > 0 ? elements : null);
         } catch {
-          resolve8(null);
+          resolve9(null);
         }
       }
     );
@@ -4793,11 +4787,11 @@ function resolveScriptContent(params) {
 async function readStdin() {
   const { createReadStream } = await import("fs");
   const { createInterface } = await import("readline");
-  return new Promise((resolve8, reject) => {
+  return new Promise((resolve9, reject) => {
     const lines = [];
     const rl = createInterface({ input: createReadStream("/dev/stdin") });
     rl.on("line", (line) => lines.push(line));
-    rl.on("close", () => resolve8(lines.join("\n")));
+    rl.on("close", () => resolve9(lines.join("\n")));
     rl.on("error", reject);
   });
 }
@@ -5535,12 +5529,95 @@ var promoCommand = registerCommand({
 import {
   Core
 } from "@dyyz1993/xcli-core";
-import { resolve as resolve7 } from "path";
-import { existsSync as existsSync4, readdirSync } from "fs";
+import { resolve as resolve8 } from "path";
+import { existsSync as existsSync5, readdirSync } from "fs";
 import { homedir as homedir2 } from "os";
 
+// src/plugin/metadata-parser.ts
+import { existsSync as existsSync3 } from "fs";
+import { resolve as resolve7 } from "path";
+
+// src/utils/json-file.ts
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync3 } from "fs";
+function readJsonFile(filePath, defaultValue) {
+  try {
+    const content = readFileSync9(filePath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return defaultValue;
+  }
+}
+
+// src/plugin/metadata-parser.ts
+var PluginMetadataParser = class {
+  static XBROWSER_KEYWORDS = ["xbrowser", "xbrowser-plugin"];
+  static parseFromPackageJson(pluginPath) {
+    const packageJsonPath = resolve7(pluginPath, "package.json");
+    if (!existsSync3(packageJsonPath)) {
+      return null;
+    }
+    const packageJson = readJsonFile(packageJsonPath, null);
+    if (!packageJson) return null;
+    if (!packageJson.xbrowser) {
+      return null;
+    }
+    const xbrowser = packageJson.xbrowser;
+    const metadata = {
+      id: xbrowser.id || packageJson.name,
+      name: xbrowser.name || packageJson.name,
+      description: xbrowser.description || packageJson.description || "",
+      version: xbrowser.version || packageJson.version || "1.0.0",
+      author: xbrowser.author || this.extractAuthor(packageJson.author),
+      homepage: xbrowser.homepage || packageJson.homepage,
+      commands: xbrowser.commands,
+      sites: xbrowser.sites,
+      tags: xbrowser.tags,
+      screenshot: xbrowser.screenshot,
+      license: xbrowser.license || packageJson.license
+    };
+    return metadata;
+  }
+  static isXBrowserPlugin(packageJson) {
+    if (packageJson.xbrowser) {
+      return true;
+    }
+    const keywords = packageJson.keywords;
+    if (!keywords) return false;
+    return this.XBROWSER_KEYWORDS.some((kw) => keywords.includes(kw));
+  }
+  static fromNPMResult(result) {
+    const author = typeof result.author === "string" ? result.author : result.author?.name || "Unknown";
+    return {
+      id: result.name,
+      name: result.name.replace(/^xbrowser-plugin-/, "").replace(/^@[^/]+\//, ""),
+      description: result.description || "",
+      version: result.version,
+      author,
+      homepage: result.homepage || result.links?.homepage,
+      tags: result.keywords,
+      license: ""
+    };
+  }
+  static extractAuthor(author) {
+    if (typeof author === "string") return author;
+    if (typeof author === "object" && author !== null) {
+      const authorObj = author;
+      return authorObj.name || "Unknown";
+    }
+    return "Unknown";
+  }
+  static validateMetadata(metadata) {
+    const errors = [];
+    if (!metadata.id) errors.push("id is required");
+    if (!metadata.name) errors.push("name is required");
+    if (!metadata.description) errors.push("description is required");
+    if (!metadata.version) errors.push("version is required");
+    return errors;
+  }
+};
+
 // src/plugin/ensure-deps.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync4 } from "fs";
 import { join as join2 } from "path";
 import { execSync as execSync6 } from "child_process";
 var SHARED_PLUGIN_DEPENDENCIES = {
@@ -5549,11 +5626,11 @@ var SHARED_PLUGIN_DEPENDENCIES = {
 };
 function ensurePluginDependencies(pluginsDir) {
   const zodPath = join2(pluginsDir, "node_modules", "zod");
-  if (existsSync3(zodPath)) return;
+  if (existsSync4(zodPath)) return;
   mkdirSync2(pluginsDir, { recursive: true });
   const pkgPath = join2(pluginsDir, "package.json");
   let pkg = {};
-  if (existsSync3(pkgPath)) {
+  if (existsSync4(pkgPath)) {
     try {
       pkg = readJsonFile(pkgPath, {});
     } catch {
@@ -5567,11 +5644,11 @@ function ensurePluginDependencies(pluginsDir) {
       needsInstall = true;
     }
   }
-  if (!needsInstall && existsSync3(join2(pluginsDir, "node_modules"))) return;
+  if (!needsInstall && existsSync4(join2(pluginsDir, "node_modules"))) return;
   pkg.dependencies = existingDeps;
   pkg.private = true;
   pkg.description = pkg.description || "xbrowser plugins \u2014 shared dependencies";
-  writeFileSync3(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+  writeFileSync4(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
   try {
     execSync6("npm install --production --no-package-lock --no-fund --no-audit", {
       cwd: pluginsDir,
@@ -5601,7 +5678,7 @@ var XBrowserPluginLoader = class {
       envPrefix: "XBROWSER",
       pluginDirs: [
         ...DEFAULT_PLUGIN_DIRS,
-        resolve7(cwd, ".xcli/plugins")
+        resolve8(cwd, ".xcli/plugins")
       ]
     };
     this.core = new Core(coreConfig);
@@ -5640,31 +5717,31 @@ var XBrowserPluginLoader = class {
   }
   async scanAndLoad() {
     const cwd = this.options.cwd || process.cwd();
-    const globalDir = this.options.globalDir || resolve7(homedir2(), ".xbrowser/plugins");
+    const globalDir = this.options.globalDir || resolve8(homedir2(), ".xbrowser/plugins");
     ensurePluginDependencies(globalDir);
     const dirs = [
-      resolve7(cwd, ".xcli/plugins"),
-      resolve7(cwd, "../.xcli/plugins"),
-      this.options.userDir || resolve7(homedir2(), ".xcli/plugins"),
+      resolve8(cwd, ".xcli/plugins"),
+      resolve8(cwd, "../.xcli/plugins"),
+      this.options.userDir || resolve8(homedir2(), ".xcli/plugins"),
       globalDir
     ];
     const loaded = [];
     const seen = /* @__PURE__ */ new Set();
     for (const dir of dirs) {
-      if (!existsSync4(dir)) continue;
+      if (!existsSync5(dir)) continue;
       const entries = readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
         if (seen.has(entry.name)) continue;
         seen.add(entry.name);
-        const pluginDir = resolve7(dir, entry.name);
-        let indexPath = resolve7(pluginDir, "index.js");
-        if (!existsSync4(indexPath)) {
-          indexPath = resolve7(pluginDir, "index.ts");
+        const pluginDir = resolve8(dir, entry.name);
+        let indexPath = resolve8(pluginDir, "index.js");
+        if (!existsSync5(indexPath)) {
+          indexPath = resolve8(pluginDir, "index.ts");
         }
-        if (!existsSync4(indexPath)) continue;
+        if (!existsSync5(indexPath)) continue;
         try {
-          if (!existsSync4(resolve7(pluginDir, "package.json"))) {
+          if (!existsSync5(resolve8(pluginDir, "package.json"))) {
             console.warn(`\u26A0\uFE0F  Plugin "${entry.name}" has no package.json. Use "xbrowser create ${entry.name} --template static" for proper structure.`);
           } else {
             const metadata = PluginMetadataParser.parseFromPackageJson(pluginDir);
@@ -5681,22 +5758,6 @@ var XBrowserPluginLoader = class {
         }
       }
     }
-    try {
-      const { default: setupMarketplace } = await import("./marketplace-FCVN5OTZ.js");
-      setupMarketplace(this.loader.getAPI());
-    } catch (err) {
-      if (process.env.XBROWSER_DEBUG) {
-        console.warn(`\u26A0\uFE0F  Built-in marketplace plugin load failed: ${err instanceof Error ? err.message : String(err)}`);
-      }
-    }
-    try {
-      const { default: setupAdmin } = await import("./admin-6UTU2RZ2.js");
-      setupAdmin(this.loader.getAPI());
-    } catch (err) {
-      if (process.env.XBROWSER_DEBUG) {
-        console.warn(`\u26A0\uFE0F  Built-in admin plugin load failed: ${err instanceof Error ? err.message : String(err)}`);
-      }
-    }
     return loaded;
   }
   async unload() {
@@ -6097,7 +6158,7 @@ var TipsManager = class {
     }
   }
   debounce() {
-    return new Promise((resolve8) => setTimeout(resolve8, DEBOUNCE_MS));
+    return new Promise((resolve9) => setTimeout(resolve9, DEBOUNCE_MS));
   }
   formatTips(tips) {
     return tips.map((tip) => {
@@ -6124,6 +6185,24 @@ function getTipsManager() {
   return globalTipsManager;
 }
 
+// src/hooks/loader.ts
+var builtinHooks = {
+  screenshot: () => import("./screenshot-MB6R7RSS.js").then((m) => m.screenshotHook)
+};
+async function loadHooks() {
+  const names = process.env.XBROWSER_HOOKS;
+  if (!names) return [];
+  const hooks = [];
+  for (const name of names.split(",")) {
+    const trimmed = name.trim();
+    const factory = builtinHooks[trimmed];
+    if (factory) {
+      hooks.push(await factory());
+    }
+  }
+  return hooks;
+}
+
 // src/executor.ts
 import { homedir as homedir3 } from "os";
 import { join as join3 } from "path";
@@ -6283,9 +6362,22 @@ async function executeCommand(commandName, params, sessionName = "default", extr
     }
   }
   try {
+    const hooks = await loadHooks();
+    if (hooks.length > 0 && session?.page) {
+      await Promise.all(hooks.map((h) => h.onBeforeCommand?.({ page: session.page, command: commandName, params })));
+    }
     const raw = await command.handler(params, ctx);
     const end = Date.now();
     const duration = end - start;
+    let hookOutputs;
+    if (hooks.length > 0 && session?.page) {
+      const outputs = [];
+      for (const h of hooks) {
+        const output = await h.onAfterCommand?.({ page: session.page, command: commandName, params, result: raw, duration });
+        if (output) outputs.push({ _hook: h.name, ...output });
+      }
+      if (outputs.length > 0) hookOutputs = outputs;
+    }
     if (session && isCommandResult(raw)) {
       const resultData = raw.data;
       const convUrl = resultData?.conversationUrl;
@@ -6333,9 +6425,9 @@ async function executeCommand(commandName, params, sessionName = "default", extr
         timestamp: start
       });
       if (isSuccess) {
-        return { ...ok25(raw.data, merged.length > 0 ? merged : raw.tips), duration };
+        return { ...ok25(raw.data, merged.length > 0 ? merged : raw.tips), duration, ...hookOutputs ? { hookOutputs } : {} };
       }
-      return { success: false, data: raw.data, message: raw.message, tips: merged.length > 0 ? merged : raw.tips || [], duration };
+      return { success: false, data: raw.data, message: raw.message, tips: merged.length > 0 ? merged : raw.tips || [], duration, ...hookOutputs ? { hookOutputs } : {} };
     }
     recordArchive(session?.id, sessionName, {
       step: 0,
@@ -6346,7 +6438,7 @@ async function executeCommand(commandName, params, sessionName = "default", extr
       duration,
       timestamp: start
     });
-    return { ...ok25(raw, smartTips), duration };
+    return { ...ok25(raw, smartTips), duration, ...hookOutputs ? { hookOutputs } : {} };
   } catch (err) {
     const end = Date.now();
     const duration = end - start;
@@ -6820,7 +6912,7 @@ async function replayEntry(entry, options = {}) {
 }
 
 // src/daemon/feedback-store.ts
-import { readFileSync as readFileSync9, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
+import { readFileSync as readFileSync10, writeFileSync as writeFileSync5, mkdirSync as mkdirSync3 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir4 } from "os";
 var FEEDBACK_FILE = join4(homedir4(), ".xbrowser", "feedback.json");
@@ -6831,7 +6923,7 @@ var FeedbackStore = class {
   }
   load() {
     try {
-      const data = readFileSync9(FEEDBACK_FILE, "utf8");
+      const data = readFileSync10(FEEDBACK_FILE, "utf8");
       this.entries = JSON.parse(data);
     } catch {
       this.entries = [];
@@ -6840,7 +6932,7 @@ var FeedbackStore = class {
   save() {
     try {
       mkdirSync3(join4(homedir4(), ".xbrowser"), { recursive: true });
-      writeFileSync4(FEEDBACK_FILE, JSON.stringify(this.entries, null, 2));
+      writeFileSync5(FEEDBACK_FILE, JSON.stringify(this.entries, null, 2));
     } catch {
     }
   }
@@ -7513,7 +7605,7 @@ function createRPCHandler() {
       const recordingsDir = join5(CONFIG_DIR, "recordings");
       mkdirSync4(recordingsDir, { recursive: true });
       const outPath = params.path || join5(recordingsDir, `recording-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`);
-      writeFileSync5(outPath, JSON.stringify({
+      writeFileSync6(outPath, JSON.stringify({
         startUrl: sess.page.url(),
         recordedAt: (/* @__PURE__ */ new Date()).toISOString(),
         events
@@ -7683,8 +7775,8 @@ function createRPCHandler() {
     const result = await engine.play({
       slowMo,
       onCheckpoint: async (checkpoint) => {
-        return new Promise((resolve8) => {
-          replayResumeResolvers.set(sessionName, () => resolve8(true));
+        return new Promise((resolve9) => {
+          replayResumeResolvers.set(sessionName, () => resolve9(true));
           console.log(`[replay] Checkpoint reached: [${checkpoint.type}] ${checkpoint.hint}`);
           console.log('[replay] Send "replay:resume" RPC to continue.');
         });
@@ -8547,8 +8639,8 @@ var WSServer = class extends EventEmitter {
       case "file_list": {
         try {
           const { readdirSync: readdirSync2, statSync } = await import("fs");
-          const { join: join7, resolve: resolve8 } = await import("path");
-          const targetPath = resolve8(msg.path);
+          const { join: join7, resolve: resolve9 } = await import("path");
+          const targetPath = resolve9(msg.path);
           const entries = readdirSync2(targetPath);
           const files = entries.map((name) => {
             try {
@@ -8566,10 +8658,10 @@ var WSServer = class extends EventEmitter {
       }
       case "file_download": {
         try {
-          const { readFileSync: readFileSync11 } = await import("fs");
-          const { resolve: resolve8, basename } = await import("path");
-          const targetPath = resolve8(msg.path);
-          const data = readFileSync11(targetPath);
+          const { readFileSync: readFileSync12 } = await import("fs");
+          const { resolve: resolve9, basename } = await import("path");
+          const targetPath = resolve9(msg.path);
+          const data = readFileSync12(targetPath);
           const base64 = data.toString("base64");
           const ext = targetPath.split(".").pop()?.toLowerCase() || "";
           const mimeMap = {
@@ -8674,7 +8766,7 @@ var WSServer = class extends EventEmitter {
       this.isRunning = false;
       return;
     }
-    return new Promise((resolve8, reject) => {
+    return new Promise((resolve9, reject) => {
       this.wsServer.close((err) => {
         if (err) {
           reject(err);
@@ -8682,7 +8774,7 @@ var WSServer = class extends EventEmitter {
           this.wsServer = null;
           this.isRunning = false;
           this.emit("stopped");
-          resolve8();
+          resolve9();
         }
       });
     });
@@ -9869,7 +9961,7 @@ async function main() {
   previewWS.on("screencast-started", (sid) => log(`Preview screencast started: ${sid}`));
   previewWS.on("screencast-stopped", (sid) => log(`Preview screencast stopped: ${sid}`));
   mkdirSync5(CONFIG_DIR2, { recursive: true });
-  writeFileSync6(join6(CONFIG_DIR2, "daemon.json"), JSON.stringify({
+  writeFileSync7(join6(CONFIG_DIR2, "daemon.json"), JSON.stringify({
     port: daemonPort,
     pid: process.pid,
     startedAt: Date.now()

package/dist/{human-interaction-QPHNDD76.js → human-interaction-W753RVJB.js}

@@ -1,7 +1,6 @@
 import {
   HumanInteractionManager
-} from "./chunk-VUJDJCIN.js";
-import "./chunk-M7CMBPCA.js";
+} from "./chunk-ITKPSIP7.js";
 import "./chunk-3RG5ZIWI.js";
 export {
   HumanInteractionManager

package/dist/index.d.ts

@@ -260,12 +260,17 @@ declare class WSServer extends EventEmitter {
 /**
  * Result of a single command execution.
  */
+interface HookOutput {
+    _hook: string;
+    [key: string]: unknown;
+}
 interface ExecutionResult {
     success: boolean;
     data: unknown;
     message?: string;
     duration: number;
     tips?: string[];
+    hookOutputs?: HookOutput[];
 }
 /**
  * Result of a single step within a command chain execution.
@@ -278,6 +283,7 @@ interface ChainStepResult {
     message?: string;
     duration: number;
     tips?: string[];
+    hookOutputs?: HookOutput[];
 }
 /**
  * Result of executing a command chain (multiple commands linked with &&, ||, etc.).
@@ -1055,73 +1061,6 @@ declare class PluginInstaller {
     private deriveName;
 }
 
-/**
- * Authentication configuration for publishing to a registry.
- */
-interface AuthConfig {
-    token: string;
-    registry: string;
-}
-type StorageType = 'npm' | 'r2';
-/**
- * Options for publishing a plugin.
- */
-interface PublishOptions {
-    registry: string;
-    token: string;
-    dryRun?: boolean;
-    storage?: StorageType;
-}
-interface CommandDocParam {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-    default?: unknown;
-}
-interface CommandDocExample {
-    cmd: string;
-    description: string;
-}
-interface CommandDoc {
-    name: string;
-    description: string;
-    parameters: CommandDocParam[];
-    examples?: CommandDocExample[];
-}
-/**
- * Result of creating a plugin tarball for publishing.
- */
-interface PublishResult {
-    name: string;
-    version: string;
-    slug: string;
-    description: string;
-    author: string;
-    commands: string[];
-    commandsDocs: CommandDoc[];
-    readme: string | null;
-    tags: string[];
-    sites: string[];
-    fileCount: number;
-    size: number;
-    checksum: string;
-    formData: FormData;
-}
-/**
- * Create a publishable tarball from a plugin directory.
- *
- * Collects plugin files, extracts metadata from package.json, detects
- * registered commands from source code, and prepares a FormData payload
- * for uploading to the marketplace or an npm-based registry.
- *
- * @param pluginDir - Path to the plugin directory containing `index.ts`.
- * @param options - Publish options including registry, token, storage type, and dry-run flag.
- * @returns A PublishResult with metadata and the prepared FormData.
- * @throws If `index.ts` is missing or the plugin has no description.
- */
-declare function createTarball(pluginDir: string, options: PublishOptions): Promise<PublishResult>;
-
 /**
  * A single recorded browser event (click, type, scroll, navigate, etc.).
  */
@@ -2310,4 +2249,4 @@ declare function advise(decision: DecisionResult, originalMethod: string): Advis
 /** Convenience factory: create and start a CDP interceptor proxy with defaults. */
 declare function createCDPInterceptor(config: CDPInterceptorConfig): Promise<CDPInterceptorProxy>;
 
-export { type APIRequest, type APIResponse, type AdvisoryResult, type AnalysisResult, type AuthConfig, BROWSER_SCOPE, type BatchCollectResult, type BrowserCommandContext, type BrowserCommandDefinition, type BrowserLaunchOptions, type BuiltinCommand, type BuiltinContext, type CDPError, type CDPInterceptorConfig, CDPInterceptorProxy, type CDPInterceptorRule, type CDPInterceptorStats, type CDPLogEntry, type CDPMessage, type CDPRequest, type CDPResponse, type CaptchaDetectionResult, CaptchaDetector, type ChainExecutionResult, type ChainRequest, type ChainStepResult, type CollectResult, type CollectorConfig, type CommandMessage, type CompanyInfo, type ContextChange, type DaemonInfo, DataCollector, DataStorage, type DecisionAction, type DecisionResult, type DomainStat, type ElementRef, type ExecRequest, type ExecutionResult, HTTPServer, type HTTPServerConfig, type HTTPServerError, HumanInteractionManager, type InstallOptions, type InstalledPlugin, type ManagedSession, type MessageDirection, type NetworkEntry, type ParsedPipeline, PlaybackEngine, type PlaybackOptions, type PlaybackResult, PluginInstaller, type PluginLoaderOptions, type PublishOptions, type PublishResult, type RecordedEvent, RecorderController, type RecorderStatus, type Recording, type RecordingControlFile, type RecordingData, type RecordingEvent, type RecordingSession, type RecordingStep, type RecordingSummary, type RegisteredCommand, ResultAnalyzer, type RuleContext, type RuleEngine, type ScopeDefinition, type ScopeLevel, ScreencastCapturer, type ScreencastFrame, type ScreencastMessage, type ScreencastOptions, type SearchResult, type ManagedSession as SessionInfo, SessionRecorder, type StatusMessage, type StorageConfig, type UserAction, type ViolationSeverity, type WSInboundMessage, type WSMessage, WSServer, type WSServerConfig, type WaitForHumanOptions, type WaitForHumanResult, WebhookNotifier, type WebhookPayload, XBrowserPluginLoader, advise, allBuiltins, assertPageScope, attachWaitForHuman, automationSignalsRule, checkBrowserScope, routeCommand as cliRoute, closeAllSessions as closeAllBrowserSessions, closeAllSessions, closeSession, closeSessionByName, createCDPInterceptor, createRuleEngine, createSession, createTarball, destroyBrowser, destroyBrowser as destroySessionManager, domMutationRule, emulationOverrideRule, eventSimulationRule, executeChain, executeCommand, extractAndSave, extractRecording, filterRecording, findSession, findSession as findSessionInfo, fingerprintingRule, generateBashScript, generateJSScript, generatePythonScript, getAllSessions as getAllBrowserSessions, getAllCommands, getBrowser, getBuiltin, getCaptchaConfig, getCommand, getCommandNames, getCompanyType, getDaemonProcessStatus, getPlatformName, getSessionPage, getWSServerFromCache, inputKeystrokeRule, isChainInput, getAllSessions as listAllBrowserSessions, listSessions, mouseTrajectoryRule, networkAnomalyRule, normalizeSelector, openSession, pageLifecycleRule, parseCommandArgs, parseCommandChain, parseExcludeTypes, printExtractSummary, readCommandFile, readStdin, registerCommand, registerCommandDefinition, resetForTesting, setWSServer, setWSServerCache, splitCommand, startDaemonProcess, stopDaemonProcess, version };
+export { type APIRequest, type APIResponse, type AdvisoryResult, type AnalysisResult, BROWSER_SCOPE, type BatchCollectResult, type BrowserCommandContext, type BrowserCommandDefinition, type BrowserLaunchOptions, type BuiltinCommand, type BuiltinContext, type CDPError, type CDPInterceptorConfig, CDPInterceptorProxy, type CDPInterceptorRule, type CDPInterceptorStats, type CDPLogEntry, type CDPMessage, type CDPRequest, type CDPResponse, type CaptchaDetectionResult, CaptchaDetector, type ChainExecutionResult, type ChainRequest, type ChainStepResult, type CollectResult, type CollectorConfig, type CommandMessage, type CompanyInfo, type ContextChange, type DaemonInfo, DataCollector, DataStorage, type DecisionAction, type DecisionResult, type DomainStat, type ElementRef, type ExecRequest, type ExecutionResult, HTTPServer, type HTTPServerConfig, type HTTPServerError, HumanInteractionManager, type InstallOptions, type InstalledPlugin, type ManagedSession, type MessageDirection, type NetworkEntry, type ParsedPipeline, PlaybackEngine, type PlaybackOptions, type PlaybackResult, PluginInstaller, type PluginLoaderOptions, type RecordedEvent, RecorderController, type RecorderStatus, type Recording, type RecordingControlFile, type RecordingData, type RecordingEvent, type RecordingSession, type RecordingStep, type RecordingSummary, type RegisteredCommand, ResultAnalyzer, type RuleContext, type RuleEngine, type ScopeDefinition, type ScopeLevel, ScreencastCapturer, type ScreencastFrame, type ScreencastMessage, type ScreencastOptions, type SearchResult, type ManagedSession as SessionInfo, SessionRecorder, type StatusMessage, type StorageConfig, type UserAction, type ViolationSeverity, type WSInboundMessage, type WSMessage, WSServer, type WSServerConfig, type WaitForHumanOptions, type WaitForHumanResult, WebhookNotifier, type WebhookPayload, XBrowserPluginLoader, advise, allBuiltins, assertPageScope, attachWaitForHuman, automationSignalsRule, checkBrowserScope, routeCommand as cliRoute, closeAllSessions as closeAllBrowserSessions, closeAllSessions, closeSession, closeSessionByName, createCDPInterceptor, createRuleEngine, createSession, destroyBrowser, destroyBrowser as destroySessionManager, domMutationRule, emulationOverrideRule, eventSimulationRule, executeChain, executeCommand, extractAndSave, extractRecording, filterRecording, findSession, findSession as findSessionInfo, fingerprintingRule, generateBashScript, generateJSScript, generatePythonScript, getAllSessions as getAllBrowserSessions, getAllCommands, getBrowser, getBuiltin, getCaptchaConfig, getCommand, getCommandNames, getCompanyType, getDaemonProcessStatus, getPlatformName, getSessionPage, getWSServerFromCache, inputKeystrokeRule, isChainInput, getAllSessions as listAllBrowserSessions, listSessions, mouseTrajectoryRule, networkAnomalyRule, normalizeSelector, openSession, pageLifecycleRule, parseCommandArgs, parseCommandChain, parseExcludeTypes, printExtractSummary, readCommandFile, readStdin, registerCommand, registerCommandDefinition, resetForTesting, setWSServer, setWSServerCache, splitCommand, startDaemonProcess, stopDaemonProcess, version };