@optima-chat/browser-cli 0.25.0 → 0.25.1

package/dist/index.js

@@ -200,7 +200,7 @@ function conversationHeader() {
   const conv = conversationId();
   return conv ? { "X-Optima-Conversation": conv } : {};
 }
-async function request(path, options = {}) {
+async function request(path, options = {}, originalTaskConversation) {
   const url = `${BROWSER_API_URL}${path}`;
   const auth = authHeader();
   let response;
@@ -210,7 +210,7 @@ async function request(path, options = {}) {
       headers: {
         "Content-Type": "application/json",
         ...auth,
-        ...conversationHeader(),
+        ...originalTaskConversation === void 0 ? conversationHeader() : originalTaskConversation === null ? {} : { "X-Optima-Conversation": originalTaskConversation },
         ...options.headers
       }
     });
@@ -450,8 +450,20 @@ var BrowserAPI = class {
       body: JSON.stringify(payload)
     });
   }
+  async settleScriptTaskSession(taskId) {
+    const task = await this.getScriptTask(taskId);
+    const proof = task.execution_evidence;
+    if (task.id !== taskId || !["failed", "cancelled", "needs_fallback", "completed"].includes(task.status) || !proof || proof.protocol !== "script-execution/v1" || proof.task_id !== taskId || proof.worker_ended !== true || !(proof.conversation === null || typeof proof.conversation === "string")) {
+      throw new Error("Original task execution/conversation unresolved; refusing session settlement");
+    }
+    return request(
+      `/api/script-tasks/${encodeURIComponent(taskId)}/settle-session`,
+      { method: "POST" },
+      proof.conversation
+    );
+  }
   async getScriptTask(taskId) {
-    return request(`/api/script-tasks/${taskId}`);
+    return request(`/api/script-tasks/${encodeURIComponent(taskId)}`);
   }
   async sourceCapabilities() {
     return request(`/api/script-source-capabilities`);
@@ -1227,7 +1239,7 @@ ${downloadHint(result)}`);
       process.exit(1);
     }
   });
-  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(
+  program2.command("script-task").argument("<task-id>", "Task ID").description("Check script task status").option("--settle-session", "Read the original task, then settle its ended channel under its server-recorded conversation; keeps the current session and never classifies publication").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), 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) => {
@@ -1237,6 +1249,7 @@ ${downloadHint(result)}`);
       }
       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");
+      if (opts.settleSession && (opts.wait || opts.download !== void 0)) throw new Error("--settle-session cannot combine with --wait/--download");
       const timeoutS = opts.timeout === void 0 ? WAIT_DEFAULT_TIMEOUT_S : parseWaitTimeout(opts.timeout);
       let task;
       if (opts.wait) {
@@ -1255,12 +1268,12 @@ ${downloadHint(result)}`);
           return;
         }
       } else {
-        task = await api.getScriptTask(taskId);
+        task = opts.settleSession ? await api.settleScriptTaskSession(taskId) : await api.getScriptTask(taskId);
       }
       const stoppedExit = () => {
         if (opts.wait && task.status !== "completed") process.exit(EXIT_TASK_STOPPED);
       };
-      if (task.status === "needs_fallback" && task.session_id) saveSessionId(task.session_id);
+      if (!opts.settleSession && task.status === "needs_fallback" && task.session_id) saveSessionId(task.session_id);
       if (opts.json) {
         console.log(JSON.stringify(task, null, 2));
         stoppedExit();

package/package.json

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