@optima-chat/browser-cli 0.14.0 → 0.15.1

package/dist/index.js

@@ -183,11 +183,12 @@ async function requestBinary(path) {
   return Buffer.from(arrayBuffer);
 }
 var BrowserAPI = class {
-  async createSession(url, force, connector, ziniaoProfileId, bitbrowserProfileId, feikuaProfileId) {
+  async createSession(url, force, connector, ziniaoProfileId, bitbrowserProfileId, feikuaProfileId, chromeProfile) {
     const body = {};
     if (url) body.url = url;
     if (force) body.force = true;
     if (connector) body.connector = connector;
+    if (chromeProfile) body.chrome_profile = chromeProfile;
     if (ziniaoProfileId) body.ziniao_profile_id = ziniaoProfileId;
     if (bitbrowserProfileId) body.bitbrowser_profile_id = bitbrowserProfileId;
     if (feikuaProfileId) body.feikua_profile_id = feikuaProfileId;
@@ -211,6 +212,10 @@ var BrowserAPI = class {
   async getZiNiaoProfiles() {
     return request("/api/user/ziniao-profiles");
   }
+  // logged_in 缺席 = 没探(未开 check、无 homeUrl 或探测失败),下游按未知处理,别当 false。
+  async getChromeProfiles(check) {
+    return request(`/api/user/chrome-profiles${check ? "?check=true" : ""}`);
+  }
   async getBitBrowserProfiles() {
     return request("/api/user/bitbrowser-profiles");
   }
@@ -370,9 +375,10 @@ var BrowserAPI = class {
   async deleteScript(name) {
     await request(`/api/scripts/${encodeURIComponent(name)}`, { method: "DELETE" });
   }
-  async runScript(scriptName, params = {}, connector, ziniaoProfileId, bitbrowserProfileId, feikuaProfileId) {
+  async runScript(scriptName, params = {}, connector, ziniaoProfileId, bitbrowserProfileId, feikuaProfileId, chromeProfile) {
     const payload = { params };
     if (connector) payload.connector = connector;
+    if (chromeProfile) payload.chrome_profile = chromeProfile;
     if (ziniaoProfileId) payload.ziniao_profile_id = ziniaoProfileId;
     if (bitbrowserProfileId) payload.bitbrowser_profile_id = bitbrowserProfileId;
     if (feikuaProfileId) payload.feikua_profile_id = feikuaProfileId;
@@ -430,9 +436,13 @@ function clearSessionId(onlyIfEquals) {
 }
 
 // src/formatter.ts
+var URL_STALE_WARNING = "\u26A0 URL/title may be stale: the live page probe failed, values above are cached. Verify with a screenshot before concluding a navigation failed.";
 function formatPageState(state) {
   const lines = [];
   lines.push(`Page: ${state.title} (${state.url})`);
+  if (state.url_stale) {
+    lines.push(URL_STALE_WARNING);
+  }
   lines.push("");
   lines.push("DOM:");
   lines.push(state.dom);
@@ -472,6 +482,9 @@ function formatTabs(tabList) {
   for (const tab of tabList.tabs) {
     lines.push(`  [${tab.tab_id}] ${tab.title} (${tab.url})`);
   }
+  if (tabList.url_stale) {
+    lines.push(URL_STALE_WARNING);
+  }
   return lines.join("\n");
 }
 function formatSearch(result) {
@@ -515,9 +528,9 @@ function formatTabsInline(tabs) {
 
 // src/commands/lifecycle.ts
 function registerLifecycleCommands(program2) {
-  program2.command("launch").description("Launch a browser session").option("--url <url>", "Navigate to URL after launch").option("--force", "Close existing session before launching").option("--connector <type>", "Browser connector: chrome, ziniao, bitbrowser, or feikua").option("--ziniao-profile <id>", "ZiNiao browser profile ID").option("--bitbrowser-profile <id>", "BitBrowser profile ID").option("--feikua-profile <id>", "Feikua (\u98DE\u8DE8) shop browser instance ID").action(async (opts) => {
+  program2.command("launch").description("Launch a browser session").option("--url <url>", "Navigate to URL after launch").option("--force", "Close existing session before launching").option("--connector <type>", "Browser connector: chrome, ziniao, bitbrowser, or feikua").option("--ziniao-profile <id>", "ZiNiao browser profile ID").option("--bitbrowser-profile <id>", "BitBrowser profile ID").option("--feikua-profile <id>", "Feikua (\u98DE\u8DE8) shop browser instance ID").option("--chrome-profile <name>", "Chrome named profile (per-store login state; default: shared profile)").action(async (opts) => {
     try {
-      const state = await api.createSession(opts.url, opts.force, opts.connector, opts.ziniaoProfile, opts.bitbrowserProfile, opts.feikuaProfile);
+      const state = await api.createSession(opts.url, opts.force, opts.connector, opts.ziniaoProfile, opts.bitbrowserProfile, opts.feikuaProfile, opts.chromeProfile);
       saveSessionId(state.session_id);
       console.log(formatLaunch(state));
     } catch (err) {
@@ -758,8 +771,9 @@ function registerTabCommands(program2) {
 }
 
 // src/commands/script.ts
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { basename, dirname, resolve } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, statSync, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir } from "os";
+import { basename, dirname, join as join3, resolve } from "path";
 var POLL_INTERVAL_MS = 2e3;
 var POLL_TIMEOUT_MS = 18e4;
 var REQUIRED_ARG_FLAG = {
@@ -772,16 +786,50 @@ function formatRequiredArgs(s) {
   const flags = s.required_args.map((a) => REQUIRED_ARG_FLAG[a] ?? `--param ${a}=<value>`).join(" ");
   return `  requires: ${flags}`;
 }
+var ArtifactLostError = class extends Error {
+};
+var errMsg = (err) => err instanceof Error ? err.message : String(err);
+function resolveArtifactTarget(out, name) {
+  if (!out) return resolve(`./${name}`);
+  const wantsDir = /[\\/]$/.test(out) || existsSync3(out) && statSync(out).isDirectory();
+  return wantsDir ? resolve(out, name) : resolve(out);
+}
 async function deliverArtifact(task, out) {
   const output = task.output;
   if (!output) return null;
-  if (output.path) return output.path;
+  if (output.path) return { path: output.path, size: output.size };
   if (!output.artifact_path) return null;
-  const target = resolve(out ?? `./${basename(output.filename ?? "artifact")}`);
-  const content = await api.fetchArtifact(output.artifact_path);
+  const name = basename(output.filename ?? "") || "artifact";
+  const target = resolveArtifactTarget(out, name);
   mkdirSync2(dirname(target), { recursive: true });
-  writeFileSync3(target, content);
-  return target;
+  const content = await api.fetchArtifact(output.artifact_path);
+  try {
+    writeFileSync3(target, content);
+  } catch (err) {
+    const fallback = join3(tmpdir(), name);
+    try {
+      writeFileSync3(fallback, content);
+    } catch (err2) {
+      throw new ArtifactLostError(
+        `Could not write ${target} (${errMsg(err)}) nor ${fallback} (${errMsg(err2)}); the artifact was already fetched and is no longer on the server`
+      );
+    }
+    console.error(`Could not write ${target} (${errMsg(err)}); saved to ${fallback} instead`);
+    return { path: fallback, size: content.length };
+  }
+  return { path: target, size: content.length };
+}
+function artifactUrl(artifactPath) {
+  return `${BROWSER_API_URL}${artifactPath}`;
+}
+function hasStagedArtifact(task) {
+  const output = task.output;
+  return task.status === "completed" && !!output?.artifact_path;
+}
+function downloadHint(task) {
+  const filename = task.output?.filename;
+  const dest = filename ? ` ./${basename(filename)}` : "";
+  return `Download with: browser-cli script-task ${task.id} --download${dest}`;
 }
 function formatScriptList(scripts) {
   if (scripts.length === 0) return "No scripts registered.";
@@ -804,7 +852,7 @@ function formatScriptTask(task) {
     lines.push("\u2713 Script completed");
     if (task.output) {
       for (const [k, v] of Object.entries(task.output)) {
-        lines.push(`${k}: ${v}`);
+        lines.push(k === "artifact_path" ? `${k}: ${artifactUrl(String(v))}` : `${k}: ${v}`);
       }
     }
   } else if (task.status === "needs_fallback") {
@@ -881,7 +929,7 @@ function registerScriptCommands(program2) {
       process.exit(1);
     }
   });
-  program2.command("runscript").argument("<name>", "Script name").description("Run a script (polls until complete)").option("--param <params...>", "Parameters as key=value").option("--connector <type>", "Browser connector: chrome, ziniao, bitbrowser, or feikua").option("--ziniao-profile <id>", "ZiNiao browser profile ID (with --connector ziniao)").option("--bitbrowser-profile <id>", "BitBrowser profile ID (with --connector bitbrowser)").option("--feikua-profile <id>", "Feikua (\u98DE\u8DE8) shop browser instance ID (with --connector feikua)").option("--out <path>", "Where to write the script's exported file (default: ./<filename>)").option("--no-poll", "Return immediately without polling").action(async (name, opts) => {
+  program2.command("runscript").argument("<name>", "Script name").description("Run a script (polls until complete)").option("--param <params...>", "Parameters as key=value").option("--connector <type>", "Browser connector: chrome, ziniao, bitbrowser, or feikua").option("--ziniao-profile <id>", "ZiNiao browser profile ID (with --connector ziniao)").option("--bitbrowser-profile <id>", "BitBrowser profile ID (with --connector bitbrowser)").option("--feikua-profile <id>", "Feikua (\u98DE\u8DE8) shop browser instance ID (with --connector feikua)").option("--chrome-profile <name>", "Chrome named profile (per-store login state, with --connector chrome)").option("--out <path>", "Where to write the script's exported file (default: ./<filename>)").option("--no-poll", "Return immediately without polling").action(async (name, opts) => {
     try {
       const params = {};
       if (opts.param) {
@@ -891,7 +939,7 @@ function registerScriptCommands(program2) {
         }
       }
       if (opts.out) params.out_path = resolve(opts.out);
-      const task = await api.runScript(name, params, opts.connector, opts.ziniaoProfile, opts.bitbrowserProfile, opts.feikuaProfile);
+      const task = await api.runScript(name, params, opts.connector, opts.ziniaoProfile, opts.bitbrowserProfile, opts.feikuaProfile, opts.chromeProfile);
       console.log(`Script started (task: ${task.id})`);
       if (!opts.poll) {
         console.log(`Poll with: browser-cli script-task ${task.id}`);
@@ -915,12 +963,15 @@ function registerScriptCommands(program2) {
       if (result.status === "completed") {
         try {
           const saved = await deliverArtifact(result, opts.out);
-          if (saved) console.log(`Saved -> ${saved}`);
+          if (saved) console.log(`Saved -> ${saved.path}`);
         } catch (err) {
           const staged = result.output?.artifact_path;
           console.error(`${formatError(err)}
 Script completed; only saving the file failed.`);
-          if (staged) console.error(`The artifact is still at ${staged}.`);
+          if (staged && !(err instanceof ArtifactLostError)) {
+            console.error(`The artifact is still at ${artifactUrl(staged)}.
+${downloadHint(result)}`);
+          }
           process.exit(1);
         }
       }
@@ -929,12 +980,26 @@ Script completed; only saving the file failed.`);
       process.exit(1);
     }
   });
-  program2.command("script-task").argument("<task-id>", "Task ID").description("Check script task status").action(async (taskId) => {
+  program2.command("script-task").argument("<task-id>", "Task ID").description("Check script task status").option("--download [path]", "Save the task's exported file (default: ./<filename>)").action(async (taskId, opts) => {
     try {
       const task = await api.getScriptTask(taskId);
-      console.log(formatScriptTask(task));
+      if (opts.download === void 0) {
+        console.log(formatScriptTask(task));
+        if (hasStagedArtifact(task)) console.log(downloadHint(task));
+        return;
+      }
+      if (task.status !== "completed") {
+        throw new Error(`Task ${taskId} is ${task.status} \u2014 nothing to download yet`);
+      }
+      const saved = await deliverArtifact(task, typeof opts.download === "string" ? opts.download : void 0);
+      if (!saved) throw new Error(`Task ${taskId} produced no file`);
+      console.log(`Saved -> ${saved.path}${saved.size === void 0 ? "" : ` (${saved.size} bytes)`}`);
     } catch (err) {
-      console.error(formatError(err));
+      const gone = err.errorCode === "artifact_gone";
+      console.error(
+        gone ? `${formatError(err)}
+Each artifact can be fetched once; if runscript printed "Saved ->", the file is already local.` : formatError(err)
+      );
       process.exit(1);
     }
   });
@@ -1116,6 +1181,44 @@ function registerZiNiaoCommands(program2) {
   });
 }
 
+// src/commands/chrome.ts
+function registerChromeCommands(program2) {
+  const chrome = program2.command("chrome").description("Manage Chrome named profiles (per-store login state)");
+  chrome.command("profiles").description("List Chrome named profiles (requires Desktop app online)").option("--check", "Probe login state for profiles with a homeUrl (opens a headed Chrome per profile, ~10s each)").action(async (opts) => {
+    try {
+      const result = await api.getChromeProfiles(opts.check);
+      if (!result.connected) {
+        console.log(formatDesktopNotConnected(result));
+        process.exit(1);
+      }
+      console.log(`Chrome profiles (${result.profiles.length}):
+`);
+      for (const p of result.profiles) {
+        const label = p.name === "default" ? "\u5171\u4EAB\u9ED8\u8BA4" : p.label ?? "-";
+        const login = p.logged_in === void 0 ? "-" : p.logged_in ? "\u2705" : "\u274C \u9700\u4EBA\u5DE5\u91CD\u767B";
+        const home = p.homeUrl ? `  ${p.homeUrl}` : "";
+        console.log(`  ${p.name.padEnd(12)} ${label.padEnd(18)} running: ${p.running ? "yes" : "no"}  logged_in: ${login}${home}`);
+      }
+      console.log("\nUse: browser-cli launch --connector chrome --chrome-profile <name> --url <url>");
+      if (!opts.check) console.log("Add --check to probe login state (profiles with a homeUrl only).");
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
+  chrome.command("open").description("Open a named profile's headed Chrome for manual login (the official login entry)").requiredOption("--profile <name>", "Chrome named profile to open (created on first use)").option("--url <url>", "Page to open, e.g. the seller center login page").action(async (opts) => {
+    try {
+      const state = await api.createSession(opts.url, false, "chrome", void 0, void 0, void 0, opts.profile);
+      saveSessionId(state.session_id);
+      console.log(`\u2713 Opened Chrome profile "${opts.profile}"${opts.url ? ` at ${opts.url}` : ""} (session: ${state.session_id})`);
+      console.log("\u5728\u5F39\u51FA\u7684 Chrome \u7A97\u53E3\u91CC\u5B8C\u6210\u767B\u5F55;\u767B\u5F55\u6001\u4F1A\u7559\u5728\u8BE5 profile,\u4E4B\u540E\u5E26 --chrome-profile \u7684\u8C03\u7528\u76F4\u63A5\u590D\u7528\u3002");
+    } catch (err) {
+      console.error(formatError(err));
+      process.exit(1);
+    }
+  });
+}
+
 // src/commands/recipes.ts
 import { writeFileSync as writeFileSync4 } from "fs";
 import { resolve as resolve2 } from "path";
@@ -1339,6 +1442,7 @@ registerInfoCommands(program);
 registerTabCommands(program);
 registerScriptCommands(program);
 registerZiNiaoCommands(program);
+registerChromeCommands(program);
 registerRecipeCommands(program);
 registerBitBrowserCommands(program);
 registerFeikuaCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/browser-cli",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {