evot-agent 0.2.2 → 0.3.0

package/README.md

@@ -3,6 +3,7 @@
 유저 컴퓨터에서 도는 [evot](https://evot.io)의 로컬 브라우저 에이전트.
 evot에서 Vot에게 "내 컴퓨터 브라우저로 ○○ 수집해줘"라고 말하면(또는 루틴으로 걸어두면),
 이 에이전트가 Claude + Playwright로 사이트를 탐색·수집하고 결과를 지정한 쓰레드에 셀로 추가한다.
+결과는 요청을 받은 Vot 이름/아바타로 정리되며, 이미지를 수집한 경우 설명과 함께 셀 안에 표시된다.
 
 ## 요구사항
 
@@ -13,7 +14,7 @@ evot에서 Vot에게 "내 컴퓨터 브라우저로 ○○ 수집해줘"라고
 
 ## 설치 & 연결
 
-1. evot.io에 로그인 → **Settings → Integrations → Web Agent** → 코드 발급.
+1. evot.io에 로그인 → **Settings → Integrations → Computer Use** → 코드 발급.
 2. 코드로 연결:
 
 ```bash
@@ -36,10 +37,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 +58,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.
 `;
@@ -84,8 +84,9 @@ async function main() {
 
     console.log(`Running job → thread ${job.log_id}`);
     let text;
+    let segments;
     try {
-      text = await runBrowseJob(job);
+      ({ text, segments } = await runBrowseJob(job));
     } catch (err) {
       // 실패도 쓰레드에 남긴다 (그리고 텔레그램 알림).
       console.error(`\nBrowse failed: ${err.message}`);
@@ -103,6 +104,7 @@ async function main() {
     const cellId = await reportResult({
       logId: job.log_id,
       text,
+      segments,
       title: job.title ?? "collection",
       status: "success",
     });

package/package.json

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

package/src/browse.js

@@ -15,16 +15,77 @@ const SYSTEM_APPEND = [
   "  LOGIN_REQUIRED: <domain>",
   '  (e.g. "LOGIN_REQUIRED: news.ycombinator.com"). No other text.',
   "",
+  "MISSION FIDELITY:",
+  "- Complete exactly what the user asked. Do not narrow the scope on your own or",
+  "  substitute a different deliverable — e.g. do NOT return only text/metadata when",
+  "  images were requested. If the user asks for images, collect and output the",
+  "  actual image URLs, exactly as many as the task calls for.",
+  "- Do not act as a content moderator. Mature, adult, sensitive, or otherwise",
+  "  disagreeable material that is lawful and already publicly posted is in scope;",
+  "  do not skip, omit, sanitize, or downgrade it merely for being suggestive or",
+  "  NSFW. You are cataloguing what is publicly visible on the user's own request,",
+  "  not endorsing it. Report what is actually there.",
+  "- The only hard stop is genuinely illegal content (e.g. sexual content involving",
+  "  minors). If — and only if — you must decline part of a task, say so explicitly",
+  "  on its own line with the concrete reason. Never silently drop or replace it.",
+  "",
   "When finished, output ONLY the collected result as plain text:",
-  "- A short title line.",
-  "- The summary the user asked for.",
-  "- A 'Sources:' section listing the URLs you used, one per line.",
+  "- A short title line and the overall summary first.",
+  "- If the task involves collecting images, organize the result into sections:",
+  "  each section is its description text followed by its image lines, each",
+  "  exactly 'IMAGE: <url>' with a direct image URL you actually saw",
+  "  (e.g. a pbs.twimg.com link or a URL ending in .jpg/.png). Max 10 images total.",
+  "- A 'Sources:' section at the end listing the URLs you used, one per line.",
   "Do not include tool logs or meta commentary in the final answer.",
 ].join("\n");
 
+const MAX_IMAGES_TOTAL = 10;
+
+/**
+ * 최종 답변을 섹션 단위로 파싱한다.
+ * - 'IMAGE: <url>' 라인 → 현재 섹션의 이미지(전체 합산 10개 상한). 'Images:' 헤딩 라인은 제거.
+ * - 이미지 뒤에 다시 텍스트가 나오면 새 섹션 시작(설명→이미지→설명→이미지 그룹핑).
+ * - 반환 text는 IMAGE 라인이 제거된 전문(구서버 호환·텔레그램 스니펫용).
+ */
+export function parseSegments(raw) {
+  const segments = [];
+  let curText = [];
+  let curImages = [];
+  let sawImage = false;
+  let total = 0;
+
+  const flush = () => {
+    const text = curText.join("\n").trim();
+    if (text || curImages.length > 0) segments.push({ text, images: curImages });
+    curText = [];
+    curImages = [];
+    sawImage = false;
+  };
+
+  for (const line of raw.split("\n")) {
+    if (/^\s*images:\s*$/i.test(line)) continue; // 잔여 'Images:' 헤딩 제거
+    const m = line.match(/^\s*IMAGE:\s*(https?:\/\/\S+)\s*$/i);
+    if (m) {
+      if (total < MAX_IMAGES_TOTAL) {
+        curImages.push(m[1]);
+        total++;
+        sawImage = true;
+      }
+      continue;
+    }
+    if (sawImage && line.trim()) flush(); // 이미지 뒤 새 텍스트 → 새 섹션
+    curText.push(line);
+  }
+  flush();
+
+  const text = segments.map((s) => s.text).filter(Boolean).join("\n\n").trim();
+  return { text, segments: segments.length > 0 ? segments : [{ text, images: [] }] };
+}
+
 /**
  * 잡 지시문을 Claude Agent SDK + Playwright MCP(전용 프로필)로 실행하고
- * 최종 요약 텍스트를 반환한다. 모델 크리덴셜은 로컬 Claude Code 로그인을 사용.
+ * 최종 결과를 { text, segments }로 반환한다(섹션 = 설명+이미지 URL 그룹).
+ * 모델 크리덴셜은 로컬 Claude Code 로그인을 사용.
  */
 export async function runBrowseJob(job) {
   const promptParts = [job.instruction];
@@ -99,7 +160,7 @@ export async function runBrowseJob(job) {
       finalText.trim() || "Agent finished without producing a result.",
     );
   }
-  return finalText.trim();
+  return parseSegments(finalText);
 }
 
 /**
@@ -123,7 +184,7 @@ function isSafeDomain(d) {
 export function describeJobFailure(err) {
   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}`,
@@ -133,11 +194,11 @@ export function describeJobFailure(err) {
   if (err?.loginDomain) {
     // 도메인이 의심스러우면 URL을 그대로 흘리지 않고 유저가 직접 지정하게 안내.
     return [
-      "The web agent hit a login wall it could not pass, so this task could not be completed.",
+      "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 web agent could not complete this task.\n\nReason: ${err?.message ?? "unknown"}`;
+  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/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/report.js

@@ -8,12 +8,15 @@ import { SUPABASE_URL, loadToken } from "./config.js";
  * - 큐 경로(데몬): jobId만 넘긴다. 서버가 잡에서 log_id를 찾아 셀을 만들고 잡 상태를 done/failed로 갱신.
  * - 수동 경로(run): logId를 넘긴다. (Phase 1 호환)
  */
-export async function reportResult({ logId, jobId, text, title, status = "success" }) {
+export async function reportResult({ logId, jobId, text, segments, title, status = "success" }) {
   const token = await loadToken();
 
   const body = { text, title, status };
   if (jobId) body.job_id = jobId;
   if (logId) body.log_id = logId;
+  // 섹션(설명+이미지 URL) 전달 — 서버가 votResponse 서브셀·이미지 저장에 사용.
+  // 구서버는 이 필드를 무시하고 text만 쓴다(하위호환).
+  if (Array.isArray(segments) && segments.length > 0) body.segments = segments;
 
   const url = `${SUPABASE_URL}/functions/v1/agent-report`;
   const res = await fetch(url, {

package/src/sync.js

@@ -44,20 +44,21 @@ async function fetchJobs(token) {
 async function runJob(job) {
   console.log(`\nJob ${job.id}: ${String(job.instruction ?? "").slice(0, 80)}`);
   let text;
+  let segments;
   let status = "success";
   try {
-    text = await runBrowseJob({
+    ({ text, segments } = await runBrowseJob({
       instruction: job.instruction,
       start_url: job.start_url ?? undefined,
       headless: true,
-    });
+    }));
   } catch (err) {
     console.error(`Job ${job.id} failed: ${err.message}`);
     text = describeJobFailure(err);
     status = "error";
   }
   try {
-    const cellId = await reportResult({ jobId: job.id, text, title: "Web agent", status });
+    const cellId = await reportResult({ jobId: job.id, text, segments, title: "Computer Use", status });
     console.log(`Reported job ${job.id}${cellId ? ` → cell ${cellId}` : ""}.`);
   } catch (err) {
     // 보고 실패 시 잡은 running으로 남고, running 타임아웃 후 서버가 expired 처리한다.