evot-agent 0.4.0 → 0.4.1

package/package.json

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

package/src/backends/claude.js

@@ -1,6 +1,6 @@
 import { query } from "@anthropic-ai/claude-agent-sdk";
 import { AGENT_DIR } from "../config.js";
-import { SYSTEM_APPEND, buildMcpArgs } from "./common.js";
+import { SYSTEM_APPEND, buildPlaywrightMcp } from "./common.js";
 
 /**
  * 잡을 Claude Agent SDK + Playwright MCP(전용 프로필)로 실행하고 최종 텍스트를 돌려준다.
@@ -12,7 +12,7 @@ export async function runClaudeJob(job) {
   const prompt = promptParts.join("\n");
 
   const headless = job.headless !== false;
-  const mcpArgs = buildMcpArgs(headless);
+  const mcp = buildPlaywrightMcp(headless);
   console.log(headless ? "Browsing headlessly (no window)." : "Browsing with a visible window.");
 
   let finalText = "";
@@ -34,8 +34,8 @@ export async function runClaudeJob(job) {
       mcpServers: {
         playwright: {
           type: "stdio",
-          command: "npx",
-          args: mcpArgs,
+          command: mcp.command,
+          args: mcp.args,
         },
       },
       allowedTools: ["mcp__playwright"],

package/src/backends/codex.js

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { mkdir, copyFile, chmod } from "node:fs/promises";
 import { AGENT_DIR, PROFILE_DIR } from "../config.js";
-import { SYSTEM_APPEND, buildMcpArgs } from "./common.js";
+import { SYSTEM_APPEND, buildPlaywrightMcp } from "./common.js";
 
 // ChatGPT 계정에서 쓸 수 있는 모델(사용자 config.toml 기본값 gpt-5.3-codex 등은 미지원).
 // 중간급(밸런스) 기본값. 더 강한/약한 모델이 필요하면 EVOT_AGENT_CODEX_MODEL로 교체
@@ -57,7 +57,7 @@ export async function runCodexJob(job) {
   const prompt = promptParts.join("\n");
 
   const headless = job.headless !== false;
-  const mcpArgs = buildMcpArgs(headless);
+  const mcp = buildPlaywrightMcp(headless);
   console.log(headless ? "Browsing headlessly (no window)." : "Browsing with a visible window.");
 
   // ChatGPT 로그인 크리덴셜 강제: API 키가 있으면 로그인 흐름과 충돌(이슈 #3286).
@@ -72,8 +72,8 @@ export async function runCodexJob(job) {
     config: {
       mcp_servers: {
         playwright: {
-          command: "npx",
-          args: mcpArgs,
+          command: mcp.command,
+          args: mcp.args,
           default_tools_approval_mode: "approve",
         },
       },

package/src/backends/common.js

@@ -1,5 +1,9 @@
+import { fileURLToPath } from "node:url";
 import { PROFILE_DIR } from "../config.js";
 
+// 읽기 전용 프록시 절대 경로(src/readonly-proxy.js). backends/에서 상위 src/로.
+const READONLY_PROXY_PATH = fileURLToPath(new URL("../readonly-proxy.js", import.meta.url));
+
 // 백엔드(claude/codex)가 공유하는 프롬프트·상수. 순환 import을 피하려고
 // browse.js가 아니라 이 leaf 모듈에 둔다(config.js에만 의존).
 
@@ -19,6 +23,14 @@ export const SYSTEM_APPEND = [
   "  LOGIN_REQUIRED: <domain>",
   '  (e.g. "LOGIN_REQUIRED: news.ycombinator.com"). No other text.',
   "",
+  "YOUTUBE:",
+  "- Do NOT play the video. Open the description (\"more\"/\"더보기\") and click",
+  '  "Show transcript"("스크립트 표시") — the FULL transcript loads into the panel at',
+  "  once; read it with a single snapshot (scroll the transcript panel only if the",
+  "  snapshot is truncated). Summarize from that text.",
+  "- If no transcript exists, fall back to metadata only: title, channel, description,",
+  "  and chapters — and say the summary is metadata-based.",
+  "",
   "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",
@@ -44,17 +56,22 @@ export const SYSTEM_APPEND = [
 ].join("\n");
 
 /**
- * Playwright MCP(stdio) 실행 인자. 기본은 headless(창 없이),
- * headless === false면 창을 띄운다(봇차단 폴백). 전용 프로필을 재사용한다.
+ * Playwright MCP(stdio) 서버 스펙 { command, args }을 만든다.
+ * 읽기 전용 프록시(readonly-proxy.js)를 앞단에 끼워 쓰기 계열 툴을 물리 차단한다:
+ *   command = 현재 node 실행파일, args = [proxy.js, "npx", "@playwright/mcp", ...]
+ * 기본은 headless(창 없이), headless === false면 창을 띄운다(봇차단 폴백). 전용 프로필 재사용.
  */
-export function buildMcpArgs(headless) {
-  const args = [
+export function buildPlaywrightMcp(headless) {
+  const playwrightArgs = [
     "@playwright/mcp",
     "--browser",
     "chrome",
     "--user-data-dir",
     PROFILE_DIR,
   ];
-  if (headless) args.push("--headless");
-  return args;
+  if (headless) playwrightArgs.push("--headless");
+  return {
+    command: process.execPath,
+    args: [READONLY_PROXY_PATH, "npx", ...playwrightArgs],
+  };
 }

package/src/browse.js

@@ -103,6 +103,8 @@ function isSafeDomain(d) {
  * loginDomain(세션만료 마커)이 있으면 재로그인 절차를 안내한다.
  */
 export function describeJobFailure(err) {
+  const msg = err?.message ?? "";
+
   if (err?.loginDomain && isSafeDomain(err.loginDomain)) {
     return [
       `The agent is signed out of ${err.loginDomain}, so this task could not be completed.`,
@@ -121,5 +123,41 @@ export function describeJobFailure(err) {
       "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"}`;
+
+  // 실행 시간 초과(Codex 벽시계 타임아웃 등) — 무엇을 하라고 명확히 안내.
+  if (err?.name === "AbortError" || /\baborted?\b|timed out|timeout/i.test(msg)) {
+    return [
+      "The task timed out on the connected computer before it finished.",
+      "",
+      "Try a narrower or simpler request, then ask the Vot to retry.",
+    ].join("\n");
+  }
+
+  // Codex 백엔드 미로그인 — 유저 컴퓨터에 Codex가 없거나 로그인 안 된 상태로 실행한 경우.
+  if (/codex is not signed in|codex login/i.test(msg)) {
+    return [
+      "Codex is not signed in on the connected computer, so this task could not run.",
+      "",
+      "To fix it, run `codex login` in a terminal on that computer, then ask the Vot to retry.",
+      "Or switch the runtime to Claude Code in Settings → Computer Use.",
+    ].join("\n");
+  }
+
+  // Claude Code 백엔드 미로그인/인증 실패 — Codex 대칭 보강.
+  if (/not logged in|invalid api key|\/login|unauthorized|authentication|credential/i.test(msg)) {
+    return [
+      "Claude Code is not logged in on the connected computer, so this task could not run.",
+      "",
+      "To fix it, run `claude` in a terminal on that computer and log in with `/login`,",
+      "then ask the Vot to retry (this is separate from the Claude desktop app login).",
+    ].join("\n");
+  }
+
+  return [
+    "The agent could not complete this task.",
+    "",
+    `Reason: ${msg || "unknown"}`,
+    "",
+    "Check the connected computer and the agent status in Settings → Computer Use.",
+  ].join("\n");
 }

package/src/login.js

@@ -37,7 +37,28 @@ export async function runLogin(url) {
       "When you're done, just close the browser window.\n",
   );
 
-  // 유저가 창을 닫을 때까지 대기.
-  await new Promise((resolve) => context.on("close", resolve));
+  // 유저가 모든 탭을 닫으면 완료로 간주하고, 데몬이 직접 context.close()로 마무리한다.
+  // context.on("close") 하나에만 의존하면 macOS에서 창의 빨간 X를 눌러도 CDP 파이프가 남아
+  // Chrome 프로세스가 죽지 않고(=close 미발화) CLI가 행 + 프로필 SingletonLock을 계속 쥔다.
+  // 이후 browse 잡이 프로필 락 충돌로 실패하는 걸 막으려면 여기서 확실히 닫아야 한다.
+  await new Promise((resolve) => {
+    let done = false;
+    const finish = async () => {
+      if (done) return;
+      done = true;
+      try {
+        await context.close(); // Chrome 프로세스·프로필 락을 확실히 해제
+      } catch {
+        // 이미 닫힌 경우 무시
+      }
+      resolve();
+    };
+    const onPageClose = () => {
+      if (context.pages().length === 0) void finish();
+    };
+    for (const p of context.pages()) p.on("close", onPageClose);
+    context.on("page", (p) => p.on("close", onPageClose));
+    context.on("close", () => void finish()); // 프로세스가 정상 종료되는 경우도 처리
+  });
   console.log("Login session saved. You can now run jobs against those sites.");
 }

package/src/readonly-proxy.js

@@ -0,0 +1,105 @@
+// evot 로컬 에이전트 읽기 전용 MCP 프록시.
+// Claude/Codex ↔ @playwright/mcp 사이 stdio JSON-RPC(NDJSON) 파이프 중간에 끼어:
+//   - tools/list 응답에서 쓰기 계열 툴을 제거 → 모델이 아예 목록에서 못 본다.
+//   - 혹시 이름으로 직접 tools/call 하더라도 하위 서버로 전달하지 않고 isError로 즉시 거절.
+// allowlist가 없는 Codex 백엔드에서도 쓰기 동작이 물리적으로 차단된다(프롬프트에만 의존 X).
+// 의존성 0(node 내장만). MCP stdio는 줄 단위 JSON이라 readline으로 충분하다.
+//
+// 실행: node readonly-proxy.js <child-command> [child-args...]
+//   예) node readonly-proxy.js npx @playwright/mcp --browser chrome --user-data-dir <dir>
+
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+
+// 상태를 바꿀 수 있는 툴 — 물리 차단.
+// click/type/press_key/navigate/snapshot/hover 등 읽기·탐색에 필요한 툴은 허용한다
+// (더보기·transcript 클릭, 검색어 입력, 쿠키 배너 닫기 등). 폼 일괄 작성·파일 업로드·
+// 임의 JS 실행·네이티브 select·드래그·다이얼로그 승인 등 쓰기의 핵심 경로만 막는다.
+const BLOCKED = new Set([
+  "browser_fill_form",
+  "browser_file_upload",
+  "browser_select_option",
+  "browser_drag",
+  "browser_drop",
+  "browser_evaluate",
+  "browser_run_code_unsafe",
+  "browser_handle_dialog",
+]);
+
+const BLOCK_MESSAGE =
+  "This tool is blocked: the evot agent is read-only and cannot perform write actions " +
+  "(form fill/submit, uploads, native <select>, drag/drop, dialogs, arbitrary JS). " +
+  "Read and summarize what is visible instead, or report that the task needs a write action.";
+
+const childArgs = process.argv.slice(2);
+if (childArgs.length === 0) {
+  process.stderr.write("readonly-proxy: missing child command\n");
+  process.exit(1);
+}
+
+const child = spawn(childArgs[0], childArgs.slice(1), {
+  // stderr는 그대로 흘려보내 하위 MCP 서버 로그를 보존한다(디버깅).
+  stdio: ["pipe", "pipe", "inherit"],
+});
+
+child.on("exit", (code) => process.exit(code ?? 0));
+child.on("error", (err) => {
+  process.stderr.write(`readonly-proxy: failed to start child: ${err.message}\n`);
+  process.exit(1);
+});
+
+function writeToClient(obj) {
+  process.stdout.write(JSON.stringify(obj) + "\n");
+}
+function writeToServer(line) {
+  child.stdin.write(line + "\n");
+}
+
+// 클라이언트(Claude/Codex) → 서버: 차단 툴 호출은 가로채 즉시 거절, 나머진 원문 그대로 전달.
+const fromClient = createInterface({ input: process.stdin });
+fromClient.on("line", (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    writeToServer(line); // 파싱 불가 → 원문 전달(프로토콜 훼손 방지)
+    return;
+  }
+  if (msg?.method === "tools/call" && BLOCKED.has(msg?.params?.name)) {
+    writeToClient({
+      jsonrpc: "2.0",
+      id: msg.id,
+      result: { content: [{ type: "text", text: BLOCK_MESSAGE }], isError: true },
+    });
+    return;
+  }
+  writeToServer(line);
+});
+fromClient.on("close", () => {
+  try {
+    child.stdin.end();
+  } catch {
+    // 이미 닫힌 경우 무시
+  }
+});
+
+// 서버 → 클라이언트: tools/list 응답에서 차단 툴을 제거, 나머진 원문 그대로 전달.
+// tools/list 응답은 result.tools 배열 형태로 고유 식별되므로 요청 id 추적이 불필요하다.
+const fromServer = createInterface({ input: child.stdout });
+fromServer.on("line", (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try {
+    msg = JSON.parse(line);
+  } catch {
+    process.stdout.write(line + "\n"); // 파싱 불가 → 원문 전달
+    return;
+  }
+  if (msg?.result && Array.isArray(msg.result.tools)) {
+    msg.result.tools = msg.result.tools.filter((tool) => !BLOCKED.has(tool?.name));
+    writeToClient(msg);
+    return;
+  }
+  process.stdout.write(line + "\n");
+});