@optima-chat/browser-cli 0.21.0 → 0.22.0

package/dist/index.js

@@ -789,10 +789,21 @@ var WAIT_DEFAULT_TIMEOUT_S = 90;
 var WAIT_MAX_TIMEOUT_S = 570;
 var EXIT_TASK_STOPPED = 2;
 var EXIT_STILL_RUNNING = 3;
-async function waitForScriptTask(taskId, timeoutMs, first) {
+var EXIT_WAITING_HUMAN = 4;
+function waitingHumanLine(task) {
+  const w = task.waiting_human;
+  if (!w) return null;
+  return `WAITING_HUMAN kind=${w.kind} since=${w.since} message=${JSON.stringify(w.message)}`;
+}
+function waitingHumanMessage(task) {
+  return `${waitingHumanLine(task)}
+The script is paused waiting for the store owner to act in their browser. Tell the owner now, then call as a separate command: browser-cli script-task ${task.id} --wait --through-human`;
+}
+async function waitForScriptTask(taskId, timeoutMs, first, throughHuman = false) {
   const deadline = Date.now() + timeoutMs;
   let task = first ?? await api.getScriptTask(taskId);
   while (task.status === "running") {
+    if (task.waiting_human && !throughHuman) return { task, timedOut: false, waitingHuman: true };
     const left = deadline - Date.now();
     if (left <= 0) return { task, timedOut: true };
     await sleep(Math.min(POLL_INTERVAL_MS, left));
@@ -811,7 +822,9 @@ function stillRunningMessage(task, waitedS, nowMs = Date.now()) {
   const started = task.created_at ? Date.parse(task.created_at) : Number.NaN;
   const elapsed = Number.isFinite(started) ? `running for ${Math.max(0, Math.round((nowMs - started) / 1e3))}s` : `waited ${waitedS}s`;
   const step = task.total_steps ? `, step ${task.current_step}/${task.total_steps}` : "";
-  return `Still running (${elapsed}${step}). Call again as a separate command: browser-cli script-task ${task.id} --wait`;
+  const waiting = waitingHumanLine(task);
+  return `Still running (${elapsed}${step}). Call again as a separate command: browser-cli script-task ${task.id} --wait` + (waiting ? ` --through-human
+${waiting}` : "");
 }
 var REQUIRED_ARG_FLAG = {
   ziniao_profile_id: "--ziniao-profile <id>",
@@ -974,6 +987,8 @@ function formatScriptTask(task) {
     }
     lines.push(...haltOutputFields(task));
   } else {
+    const waiting = waitingHumanLine(task);
+    if (waiting) lines.push(waiting);
     lines.push(`Script status: ${task.status} (step ${task.current_step}/${task.total_steps})`);
   }
   return lines.join("\n");
@@ -1049,7 +1064,12 @@ function registerScriptCommands(program2) {
         console.log(`Wait with: browser-cli script-task ${task.id} --wait`);
         return;
       }
-      const { task: result, timedOut } = await waitForScriptTask(task.id, POLL_TIMEOUT_MS, task);
+      const { task: result, timedOut, waitingHuman } = await waitForScriptTask(task.id, POLL_TIMEOUT_MS, task);
+      if (waitingHuman) {
+        console.log(waitingHumanMessage(result));
+        process.exit(EXIT_WAITING_HUMAN);
+        return;
+      }
       if (timedOut) {
         console.log(`Polling timed out. Task ${task.id} still running.`);
         console.log(`Wait with: browser-cli script-task ${task.id} --wait`);
@@ -1084,18 +1104,25 @@ ${downloadHint(result)}`);
   });
   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>)").option("--json", "Print the raw task (status / error / full output) as JSON").option(
     "--wait",
-    `Block until the task finishes (completed / failed / needs_fallback), at most --timeout seconds. Exit code: 0 completed, 2 failed / needs_fallback, 3 still running (call again), 1 error`
-  ).option("--timeout <seconds>", `With --wait: max seconds to wait (default ${WAIT_DEFAULT_TIMEOUT_S}, max ${WAIT_MAX_TIMEOUT_S})`).action(async (taskId, opts) => {
+    `Block until the task finishes (completed / failed / needs_fallback), at most --timeout seconds. Exit code: 0 completed, 2 failed / needs_fallback, 3 still running (call again), 4 waiting for the store owner (e.g. captcha; tell them, then --wait --through-human), 1 error`
+  ).option("--through-human", "With --wait: keep waiting while the script waits for the store owner (exit 4 otherwise)").option("--timeout <seconds>", `With --wait: max seconds to wait (default ${WAIT_DEFAULT_TIMEOUT_S}, max ${WAIT_MAX_TIMEOUT_S})`).action(async (taskId, opts) => {
     try {
       if (opts.json && opts.download !== void 0) {
         throw new Error("--json \u4E0E --download \u53EA\u80FD\u7ED9\u4E00\u4E2A");
       }
       if (opts.timeout !== void 0 && !opts.wait) throw new Error("--timeout \u53EA\u80FD\u548C --wait \u4E00\u8D77\u7528");
+      if (opts.throughHuman && !opts.wait) throw new Error("--through-human \u53EA\u80FD\u548C --wait \u4E00\u8D77\u7528");
       const timeoutS = opts.timeout === void 0 ? WAIT_DEFAULT_TIMEOUT_S : parseWaitTimeout(opts.timeout);
       let task;
       if (opts.wait) {
-        const waited = await waitForScriptTask(taskId, timeoutS * 1e3);
+        const waited = await waitForScriptTask(taskId, timeoutS * 1e3, void 0, opts.throughHuman);
         task = waited.task;
+        if (waited.waitingHuman) {
+          if (opts.json) console.log(JSON.stringify(task, null, 2));
+          (opts.json ? console.error : console.log)(waitingHumanMessage(task));
+          process.exit(EXIT_WAITING_HUMAN);
+          return;
+        }
         if (waited.timedOut) {
           if (opts.json) console.log(JSON.stringify(task, null, 2));
           (opts.json ? console.error : console.log)(stillRunningMessage(task, timeoutS));

package/package.json

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