evot-agent 0.2.1 → 0.2.3

package/README.md

@@ -13,7 +13,7 @@ evot에서 Vot에게 "내 컴퓨터 브라우저로 ○○ 수집해줘"라고
 
 ## 설치 & 연결
 
-1. evot.io에 로그인 → **Settings → Integrations → Web Agent** → 코드 발급.
+1. evot.io에 로그인 → **Settings → Integrations → Computer Use** → 코드 발급.
 2. 코드로 연결:
 
 ```bash
@@ -36,10 +36,13 @@ npx evot-agent connect <code>      # 예: npx evot-agent connect ABCD2345
 ```bash
 npm install -g evot-agent
 evot-agent start                 # 기본 10분마다 폴링
-evot-agent install               # macOS: 로그인 시 자동 시작 + 백그라운드 상주
+evot-agent install               # macOS 전용: 로그인 시 자동 시작 + 백그라운드 상주
 evot-agent uninstall             # 상주 등록 해제
 ```
 
+> `install`은 현재 **macOS(launchd) 전용**이다. Windows/Linux는 `evot-agent start`를
+> 터미널에 띄워두거나, 작업 스케줄러/systemd 등으로 로그인 시 실행되게 등록한다.
+
 데몬을 켜두면 evot이 잡을 큐에 넣는 대로 가져와 실행한다. **새 UI는 없다** — 기존처럼 쓰면 된다:
 
 - **대화**: 쓰레드에서 Vot 멘션으로 "Use my computer's browser to summarize today's top AI
@@ -54,13 +57,20 @@ evot-agent uninstall             # 상주 등록 해제
 ## 로그인이 필요한 사이트 (선택)
 
 ```bash
-evot-agent login https://example.com
+evot-agent login x.com            # 스킴 생략 가능 (https:// 자동 보정)
+evot-agent login https://x.com
 ```
 
-전용 Chrome 창이 뜬다. 대상 사이트에 로그인 후 창을 닫으면 세션이 전용 프로필에 저장되어
-이후 잡에 재사용된다. 아이디/비번은 저장되지 않고 브라우저 세션 쿠키만 남는다.
+평소 쓰는 Chrome과 **별개인 전용 프로필**로 창이 뜬다. 즉 평소 브라우저에 로그인돼 있어도
+에이전트에는 상속되지 않으므로, 로그인이 필요한 사이트는 여기서 한 번 로그인해둬야 한다.
+대상 사이트에 로그인 후 창을 닫으면 세션이 전용 프로필에 저장되어 이후 잡에 재사용된다.
+아이디/비번은 저장되지 않고 브라우저 세션 쿠키만 남는다.
 수집 중 로그인이 풀리면 실패 셀에 재로그인 안내가 표시된다.
 
+> **소셜 로그인(Google·Apple 등) 주의**: 자동화가 제어하는 브라우저라 Google 등이 로그인을
+> "browser may not be secure"로 막을 수 있다. 그럴 땐 사이트 자체 로그인(이메일/비밀번호)을
+> 사용하면 우회된다.
+
 ## 안전
 
 - 에이전트는 read-only로 동작하도록 지시받는다 (구매·게시·폼 제출·설정변경 금지).

package/bin/evot-agent.js

@@ -26,7 +26,7 @@ A manual job file (for "run") looks like:
     "title": "HN AI digest"
   }
 
-Auth model: get a one-time code from evot.io → Settings → Web Agent, then run
+Auth model: get a one-time code from evot.io → Settings → Computer Use, then run
 "connect <code>". Only that code is entered — never your evot password or keys.
 The code is exchanged for a scoped, revocable token stored locally.
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evot-agent",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "Local browser agent for evot — browses sites with Claude and appends results as cells.",
   "license": "MIT",

package/src/browse.js

@@ -102,19 +102,42 @@ export async function runBrowseJob(job) {
   return finalText.trim();
 }
 
+/**
+ * 마커 도메인이 평범한 호스트네임 형태인지 검증한다.
+ * 신뢰 불가한 페이지가 모델을 속여 가짜 도메인을 주입 → 재로그인 안내로 피싱 URL을
+ * 흘리는 것을 막는다(경로·포트·IP·인접 점 차단).
+ */
+function isSafeDomain(d) {
+  return (
+    typeof d === "string" &&
+    /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/i.test(d) &&
+    !d.includes("..") &&
+    /\.[a-z]{2,}$/i.test(d)
+  );
+}
+
 /**
  * 잡 실패를 셀/텔레그램에 남길 사용자용 텍스트로 조립한다.
  * loginDomain(세션만료 마커)이 있으면 재로그인 절차를 안내한다.
  */
 export function describeJobFailure(err) {
-  if (err?.loginDomain) {
+  if (err?.loginDomain && isSafeDomain(err.loginDomain)) {
     return [
-      `The web agent is signed out of ${err.loginDomain}, so this task could not be completed.`,
+      `The agent is signed out of ${err.loginDomain}, so this task could not be completed.`,
       "",
       "To fix it, on the connected computer run:",
       `  evot-agent login https://${err.loginDomain}`,
       "sign in once in the window that opens, then ask the Vot to retry this task.",
     ].join("\n");
   }
-  return `The web agent could not complete this task.\n\nReason: ${err?.message ?? "unknown"}`;
+  if (err?.loginDomain) {
+    // 도메인이 의심스러우면 URL을 그대로 흘리지 않고 유저가 직접 지정하게 안내.
+    return [
+      "The agent hit a login wall it could not pass, so this task could not be completed.",
+      "",
+      "To fix it, on the connected computer run `evot-agent login <site-url>`",
+      "with the site you want to collect from, sign in once, then ask the Vot to retry.",
+    ].join("\n");
+  }
+  return `The agent could not complete this task.\n\nReason: ${err?.message ?? "unknown"}`;
 }

package/src/connect.js

@@ -15,13 +15,13 @@ function prompt(query) {
 /**
  * evot.io에서 발급한 일회용 연결 코드를 전용 토큰으로 교환한다.
  * 계정 비밀번호·이메일·anon key 아무것도 입력하지 않는다 — 오직 코드만.
- * (코드는 evot.io → Settings → Web Agent → "Connect a device"에서 발급.)
+ * (코드는 evot.io → Settings → Computer Use → "Connect a device"에서 발급.)
  */
 export async function runConnect(codeArg) {
   let code = (codeArg ?? "").trim();
   if (!code) {
     console.log(
-      "Get a connection code from evot.io → Settings → Web Agent → Connect a device.\n",
+      "Get a connection code from evot.io → Settings → Computer Use → Connect a device.\n",
     );
     code = await prompt("Connection code: ");
   }
@@ -49,5 +49,9 @@ export async function runConnect(codeArg) {
       `Token expires ${new Date(data.expires_at).toLocaleDateString()}. Re-connect to refresh.`,
     );
   }
-  console.log("You can revoke this device anytime from evot Settings → Web Agent.");
+  console.log("You can revoke this device anytime from evot Settings → Computer Use.");
+  console.log(
+    '\nTip: for sites that need a sign-in, run "evot-agent login <url>" once —\n' +
+      "the agent browses in its own profile, so your everyday Chrome logins don't carry over.",
+  );
 }

package/src/install.js

@@ -14,7 +14,9 @@ function escapeXml(s) {
   return s
     .replaceAll("&", "&")
     .replaceAll("<", "&lt;")
-    .replaceAll(">", "&gt;");
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&apos;");
 }
 
 function serviceTarget() {

package/src/login.js

@@ -11,10 +11,25 @@ export async function runLogin(url) {
     channel: "chrome",
     headless: false,
     viewport: null,
+    // navigator.webdriver 자동화 신호를 숨겨 일부 소셜 로그인(Google 등)의
+    // "browser may not be secure" 차단을 완화한다. 만능은 아님(구글은 여러 신호를 함께 봄).
+    args: ["--disable-blink-features=AutomationControlled"],
   });
 
   const page = context.pages()[0] ?? (await context.newPage());
-  if (url) await page.goto(url, { waitUntil: "domcontentloaded" });
+  if (url) {
+    // 스킴 없는 입력(예: "x.com")도 받도록 https:// 보정.
+    // 이동 실패해도 창은 열어둔 채 수동 이동을 안내한다(로그인 세션은 어차피 프로필에 저장됨).
+    const target = /^https?:\/\//i.test(url) ? url : `https://${url}`;
+    try {
+      await page.goto(target, { waitUntil: "domcontentloaded" });
+    } catch (err) {
+      console.log(
+        `Couldn't open ${target} automatically (${err.message}).\n` +
+          "Type the address in the window and sign in there.",
+      );
+    }
+  }
 
   console.log(
     "\nA dedicated browser window is open.\n" +

package/src/sync.js

@@ -57,7 +57,7 @@ async function runJob(job) {
     status = "error";
   }
   try {
-    const cellId = await reportResult({ jobId: job.id, text, title: "Web agent", status });
+    const cellId = await reportResult({ jobId: job.id, text, title: "Computer Use", status });
     console.log(`Reported job ${job.id}${cellId ? ` → cell ${cellId}` : ""}.`);
   } catch (err) {
     // 보고 실패 시 잡은 running으로 남고, running 타임아웃 후 서버가 expired 처리한다.