@usercase/mcp 0.2.3-next.2 → 0.2.3-next.3

package/mcp/hub.js

@@ -401,6 +401,11 @@ class Hub {
     const look = await v.look();
     if (look.ended) return "This visit has ended.";
     if (look.card) return renderCard(look.card);
+    // 브라우저 창(confirm 등)이 떠 있다. 페이지는 멈춰 있다 — 아이콘 그림·위치는 안 본다
+    if (look.view.dialog) {
+      this.pictures.set(rec.id, null);
+      return renderScreen(look);
+    }
     const lines = [];
     // 굴리지 않았는데 맨 위로 돌아갔다(창이 닫히며 주소가 바뀐 사이트). 사람은 화면이 튀는 걸 본다(10/21 실험실 q3)
     // 다른 페이지로 간 것은 원래 맨 위에서 시작한다 — 같은 페이지(? 뒤만 바뀐 것 포함)일 때만

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usercase/mcp",
-  "version": "0.2.3-next.2",
+  "version": "0.2.3-next.3",
   "description": "Virtual users that browse your website and tell you what they thought — an MCP server for Claude Code",
   "license": "UNLICENSED",
   "homepage": "https://usercase.io",

package/src/run/visit.js

@@ -444,6 +444,113 @@ class Visit {
         .then((a) => (this.fileWindow = { accept: a || "" }))
         .catch(() => {});
     });
+    /**
+     * 브라우저 창(alert·confirm·prompt). 듣지 않으면 Playwright 가 조용히 "취소" 한다 — bluetags 커뮤니티 나가기는
+     * "Are you sure you want to leave?" 가 세 번 다 취소돼 "눌러도 그대로" 로 찍히고 고객 화면에 사이트 탓으로 나갔다(10/22 p2038).
+     * 창이 떠 있는 동안 페이지는 멈추고 누르기도 안 끝난다 — 방문자에게 문구를 보여 주고 고르게 한다(answerDialog)
+     */
+    this.dialog = null;
+    this.dialogWake = null;
+    this.dialogWork = null;
+    this.dialogText = null;
+    this.acting = false;
+    this.curRecord = null;
+    page.on("dialog", (d) => this.onDialog(d));
+  }
+
+  /** 창이 떴다. 걸음 중이면 방문자에게 넘기고, 아니면(화면 보는 중·카드) 사람이 그냥 넘기듯 닫는다 — 열어 두면 페이지가 멈춘다 */
+  onDialog(d) {
+    const type = d.type();
+    const message = String(d.message() || "").slice(0, 500);
+    // 떠나며 "저장 안 한 내용이 있다" 는 사람도 대개 떠난다
+    if (type === "beforeunload") return void d.accept().catch(() => {});
+    if (!this.acting || this.dialog) {
+      (type === "alert" ? d.accept() : d.dismiss()).catch(() => {});
+      this.history.push(`A box from the browser popped up saying "${message}" and went away.`);
+      return;
+    }
+    this.dialog = { d, type, message, defaultValue: d.defaultValue() || "", path: this.pathNow() };
+    this.dialogText = null;
+    if (this.dialogWake) this.dialogWake();
+  }
+
+  pathNow() {
+    try {
+      const u = new URL(this.page.url());
+      return u.pathname + u.search;
+    } catch {
+      return "";
+    }
+  }
+
+  /** 창 안에서 고를 것 — 화면의 번호 목록처럼 준다 */
+  dialogItems() {
+    const d = this.dialog;
+    const ok = { key: "ok", label: "OK", where: "in the box" };
+    const cancel = { key: "cancel", label: "Cancel", where: "in the box" };
+    const items = d.type === "alert" ? [ok] : d.type === "prompt" ? [{ key: "field", label: "(text box)", where: "in the box" }, ok, cancel] : [ok, cancel];
+    return items.map((it, i) => ({ ...it, i }));
+  }
+
+  /** 창이 떠 있는 화면. 페이지를 읽을 수 없다(멈춰 있다) — 창만 보인다 */
+  dialogLook() {
+    const d = this.dialog;
+    const what = d.type === "alert" ? "A message box from the browser popped up over the page:" : d.type === "prompt" ? "A box from the browser popped up over the page, asking you to type something:" : "A box from the browser popped up over the page, asking:";
+    const lines = [what, "", d.message || "(no text)", ""];
+    if (d.type === "prompt") lines.push(this.dialogText !== null ? `You have typed: ${this.dialogText}` : d.defaultValue ? `It already says: ${d.defaultValue}` : "The text box is empty.", "");
+    lines.push(d.type === "alert" ? "The page behind it is frozen until you close the box." : "The page behind it is frozen until you answer.");
+    const view = { path: d.path, scrollY: 0, height: 0, viewport: 0, items: this.dialogItems().map(({ i, label, where }) => ({ i, label, where })), dialog: true };
+    return { view, text: lines.join("\n") };
+  }
+
+  /**
+   * 창에 답한다 — OK·Cancel 을 누르거나 prompt 칸에 친다. 원래 걸음(_act)은 창이 닫힌 뒤 마저 끝난다.
+   * 고른 것은 그 걸음 기록에 붙는다(record.dialogs). 다른 조작은 창이 막는다 — 떠나기는 Cancel 하고 떠난다
+   */
+  async answerDialog(decision) {
+    await this.waitTurn();
+    const dl = this.dialog;
+    const item = this.dialogItems()[decision.index];
+    let choice = null;
+    if (decision.action === "leave") choice = "cancel";
+    else if (decision.action === "type" && item && item.key === "field") {
+      this.dialogText = String(decision.text || "").slice(0, 200);
+      await sleep(800 + Math.random() * 1500);
+      this.nextAt = Date.now() + 600;
+      return { dialog: true };
+    } else if (decision.action === "click" && item && item.key !== "field") choice = item.key;
+    else if (decision.action === "click" && item) return { skipped: "you can only type into that text box" };
+    else return { skipped: decision.action === "click" || decision.action === "type" ? "that number is not on the screen" : "the box from the browser is still open on top of the page — answer it first" };
+
+    this.dialog = null;
+    const answer = choice === "ok" ? (dl.type === "prompt" ? "typed and pressed OK" : "OK") : "Cancel";
+    await (choice === "ok" ? dl.d.accept(dl.type === "prompt" ? this.dialogText ?? dl.defaultValue : undefined) : dl.d.dismiss()).catch(() => {});
+    if (this.curRecord) (this.curRecord.dialogs = this.curRecord.dialogs || []).push({ type: dl.type, message: dl.message, answer, why: decision.why, t: Date.now() - this.t0 });
+    this.log(`  browser box "${dl.message.slice(0, 40)}" → ${answer}`);
+    // 원래 걸음이 마저 끝나기를 본다. 창이 또 뜨면 다시 방문자에게
+    const r = await this.untilDialog(this.dialogWork);
+    if (r && r.dialog) return r;
+    this.dialogWork = null;
+    if (decision.action === "leave") return this.act(decision);
+    return r || { step: this.steps.length };
+  }
+
+  /** 걸음을 하다가 창이 뜨면 거기서 돌려준다({ dialog: true }) — 걸음은 창이 닫힌 뒤 마저 간다 */
+  async untilDialog(work) {
+    let wake;
+    const seen = new Promise((res) => (wake = res));
+    this.dialogWake = wake;
+    this.acting = true;
+    const first = await Promise.race([work.then((r) => ({ r })), seen.then(() => null)]);
+    if (first) {
+      this.acting = false;
+      this.dialogWake = null;
+      return first.r;
+    }
+    this.dialogWork = work;
+    // 창 글을 읽는 시간
+    this.nextAt = Date.now() + 1200 + Math.min(4000, this.dialog.message.length * 40);
+    return { dialog: true };
   }
 
   /**
@@ -489,6 +596,8 @@ class Visit {
    */
   async look() {
     if (this.ended) return { ended: true };
+    // 브라우저 창이 떠 있다. 페이지는 멈춰 있어 읽으면 걸린다 — 창만 보여 준다
+    if (this.dialog) return this.dialogLook();
     if (!this.card && !this.pending) {
       const shown = await waitCard(this.page, 500);
       if (shown) this.pending = shown;
@@ -545,8 +654,14 @@ class Visit {
    * 한 걸음. decision 은 STEP_SCHEMA 모양({ why, action, index, text, done, times }).
    * 번호는 마지막 look() 화면 기준이다. 떠나면 끝나고, 떠나는 순간 뜬 카드가 있으면 pending 에 남는다.
    * 보고 있던 사이에 카드가 떴으면 하려던 걸 하지 않고 { interrupted: true } 를 돌려준다 — 카드부터 본다.
+   * 하는 도중 브라우저 창이 뜨면 { dialog: true } — 다음 look() 이 창을 보여 주고, 다음 act() 가 창에 답한다
    */
   async act(decision) {
+    if (this.dialog) return this.answerDialog(decision);
+    return this.untilDialog(this._act(decision));
+  }
+
+  async _act(decision) {
     if (this.ended) throw new Error("This visit has already ended");
     if (this.pending) throw new Error("A card is showing — answer or close it first");
     await this.waitTurn();
@@ -562,6 +677,7 @@ class Visit {
     const view = this.lastView || (await listControls(page));
     const item = view.items[decision.index];
     const record = { step: this.steps.length + 1, t: Date.now() - this.t0, path: view.path, action: decision.action, why: decision.why, label: item?.label ?? null };
+    this.curRecord = record;
     await this.checkLastJudgement(decision);
     const diagFrom = this.diag.length;
     const times = Math.max(1, Math.min(MAX_TIMES[decision.action] || 1, Math.round(Number(decision.times) || 1)));
@@ -735,7 +851,8 @@ class Visit {
           // 안 눌린다 싶어 거듭 누른다. 화면이 바뀌면 멈춘다
           for (let i = 1; i < times && !record.skipped && this.handState.mouse; i++) {
             await sleep(150 + Math.random() * 450);
-            if (page.url() !== before || this.offsite.length > offsiteBefore) break;
+            // 창이 떴었다 — 화면이 반응한 것이다. 또 누르면 같은 창이 또 뜬다
+            if (page.url() !== before || this.offsite.length > offsiteBefore || record.dialogs) break;
             await page.mouse.click(this.handState.mouse.x, this.handState.mouse.y).catch(() => {});
           }
           if ((await settle(page, before, net)).navTimeout) this.diag.push({ kind: "nav_timeout", action: "click", shape: await diag.shapeOf(el) });
@@ -796,10 +913,12 @@ class Visit {
     )
       await this.shoot(record, "error");
 
-    // 눌렀는데 그대로. 우리 쪽 사정(빗나감·막은 요청·바깥 사이트·파일 창)으로 그대로인 것은 빼고, 같은 것은 한 번만
+    // 눌렀는데 그대로. 우리 쪽 사정(빗나감·막은 요청·바깥 사이트·파일 창)으로 그대로인 것은 빼고, 같은 것은 한 번만.
+    // 브라우저 창이 떴으면 반응한 것이다 — Cancel 을 골라 그대로인 것은 사이트 탓이 아니다
     if (
       probe &&
       !record.skipped &&
+      !record.dialogs &&
       !record.missed &&
       !record.closedOverlay &&
       !record.offsite &&
@@ -827,7 +946,7 @@ class Visit {
 
     this.steps.push(record);
     this.history.push(
-      `${decision.action}${times > 1 ? ` ×${times}` : ""}${item ? ` "${item.label}"` : ""} — ${decision.why}${record.skipped ? ` (${record.skipped})` : ""}${record.cappedTimes ? " (that is the most in one go)" : ""}${record.offsite ? ` (it leads to another website, ${record.offsite})` : ""}${record.notSent ? " (it would have sent something to the site; it was not sent)" : ""}${record.fileWindow ? " (a window to choose a file opened; you closed it without choosing)" : ""}${record.personalField !== undefined ? " (you chose not to enter personal details there)" : ""}${record.openedApp ? " (it tried to open another app; nothing opened)" : ""}${record.backOut ? " (going back from here would have taken you off the site; you stayed)" : ""}`,
+      `${decision.action}${times > 1 ? ` ×${times}` : ""}${item ? ` "${item.label}"` : ""} — ${decision.why}${record.skipped ? ` (${record.skipped})` : ""}${record.cappedTimes ? " (that is the most in one go)" : ""}${record.offsite ? ` (it leads to another website, ${record.offsite})` : ""}${record.notSent ? " (it would have sent something to the site; it was not sent)" : ""}${record.fileWindow ? " (a window to choose a file opened; you closed it without choosing)" : ""}${record.personalField !== undefined ? " (you chose not to enter personal details there)" : ""}${record.openedApp ? " (it tried to open another app; nothing opened)" : ""}${record.backOut ? " (going back from here would have taken you off the site; you stayed)" : ""}${(record.dialogs || []).map((d) => ` (a box from the browser said "${d.message.slice(0, 120)}"; you pressed ${d.answer === "Cancel" ? "Cancel" : "OK"})`).join("")}`,
     );
     this.log(`${record.step}. ${decision.action}${item ? ` "${String(item.label).slice(0, 30)}"` : ""}${record.skipped ? ` · ${record.skipped}` : ""} — ${decision.why}`);
     this.lastView = null;