evot-agent 0.2.3 → 0.3.0

package/README.md

@@ -3,6 +3,7 @@
 유저 컴퓨터에서 도는 [evot](https://evot.io)의 로컬 브라우저 에이전트.
 evot에서 Vot에게 "내 컴퓨터 브라우저로 ○○ 수집해줘"라고 말하면(또는 루틴으로 걸어두면),
 이 에이전트가 Claude + Playwright로 사이트를 탐색·수집하고 결과를 지정한 쓰레드에 셀로 추가한다.
+결과는 요청을 받은 Vot 이름/아바타로 정리되며, 이미지를 수집한 경우 설명과 함께 셀 안에 표시된다.
 
 ## 요구사항
 

package/bin/evot-agent.js

@@ -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.3",
+  "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);
 }
 
 /**

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: "Computer Use", 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 처리한다.