viruagent 1.1.0 → 1.3.0

package/.github/workflows/publish.yml

@@ -0,0 +1,26 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm ci
+
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -1,9 +1,12 @@
-<img width="525" height="113" alt="image" src="https://github.com/user-attachments/assets/8bbd21d3-5f14-4d11-933d-17bdf6969ebf" />
-
+<img width="520" height="109" alt="SCR-20260212-opqh" src="https://github.com/user-attachments/assets/b6c79a28-5619-49b9-b87c-4a3f725a193a" />
 
 # ViruAgent
 
-> 터미널에서 티스토리 블로그 글을 만들고, 다듬고, 발행하는 CLI 도구
+> 터미널에서 티스토리 블로그 글을 발행까지 한 번에!
+> (CLI 기반 AI Agent 도구)
+>
+> 태균맨(tae\*virus)의 별명
+> **Viru** + **Agent** = **ViruAgent** (바이루에이전트)
 
 티스토리 API를 역분석해서 OpenAI와 엮었습니다.
 글감 잡기 → 초안 생성 → 수정 → 발행까지 터미널 안에서 끝납니다.
@@ -14,12 +17,13 @@
 
 ## 뭘 할 수 있나
 
-- **AI 대화로 글쓰기** — 챗처럼 대화하면서 아이디어를 다듬고, `/write`로 초안을 뽑고, `/edit`로 고칩니다.
+- **자연어로 글 발행** — "AI 트렌드로 글 써서 발행해줘"라고 말하면 AI가 알아서 글 생성부터 발행까지 처리합니다.
+- **에이전트 패턴** — OpenAI Function Calling 기반. AI가 도구를 자율적으로 선택하고 실행하는 에이전트 루프로 동작합니다.
+- **수동 명령어 호환** — `/write`, `/edit`, `/publish` 같은 슬래시 명령어도 그대로 사용할 수 있습니다.
 - **Unsplash 이미지 자동 삽입** — 글 생성 시 주제에 맞는 이미지를 자동 검색하고 티스토리에 업로드합니다. 첫 번째 이미지가 썸네일로 설정됩니다.
 - **브라우저 로그인으로 세션 관리** — OAuth 설정 없이 Playwright로 실제 로그인해서 쿠키를 가져옵니다.
 - **유연한 글 구조** — 5가지 글 유형(튜토리얼, 비교/리뷰, 리스트, 정보 가이드, 인사이트)을 AI가 주제에 맞게 자율 선택합니다.
 - **CLI UX** — 커맨드 힌트, 화살표 키 메뉴, 상태바 등을 넣어서 터미널에서도 불편하지 않게 만들었습니다.
-- **HTML 유지하면서 수정** — 글 구조를 깨뜨리지 않고 특정 부분만 고치거나 말투를 바꿀 수 있습니다.
 
 ---
 
@@ -52,8 +56,6 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 
 ---
 
-
-
 | 명령어          | 설명                                         |
 | --------------- | -------------------------------------------- |
 | `/write <주제>` | AI가 블로그 글 초안 생성                     |
@@ -63,7 +65,40 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 | `/set`          | 카테고리, 공개 설정, 모델, 말투 변경         |
 | `/list`         | 최근 발행 글 목록                            |
 | `/login`        | 티스토리 세션 갱신                           |
-| `/logout`        | 티스토리 세션 삭제                           |
+| `/logout`       | 티스토리 세션 삭제                           |
+
+---
+
+## 에이전트 모드
+
+슬래시 명령어 없이 자연어로 말하면 AI가 자율적으로 동작합니다.
+
+```
+viruagent> AI 에이전트 주제로 글 써서 발행해줘
+```
+![clideo_editor_32d1094183c7474a9985dbfd56abda67](https://github.com/user-attachments/assets/b638db4e-0ca9-4b1f-8a5b-2e1b76854202)
+
+
+
+### 자연어 요청 예시
+
+| 입력                          | AI가 하는 일                     |
+| ----------------------------- | -------------------------------- |
+| "AI 트렌드로 글 써줘"         | `generate_post` 호출 → 초안 생성 |
+| "서론을 더 흥미롭게 수정해줘" | `edit_post` 호출 → 초안 수정     |
+| "발행해줘"                    | `publish_post` 호출 → 즉시 발행  |
+| "비공개로 발행해줘"           | 공개설정 변경 후 발행            |
+| "글 써서 바로 발행해줘"       | 생성 → 발행 연속 실행            |
+
+### 동작 원리
+
+1. 사용자가 자연어로 요청
+2. OpenAI Function Calling으로 AI가 적절한 도구 선택
+3. 코드가 도구 실행 → 결과를 AI에게 전달
+4. AI가 다음 행동 판단 (추가 도구 호출 또는 텍스트 응답)
+5. 모든 작업 완료 후 결과 보고
+
+기존 `/write`, `/edit`, `/publish` 명령어도 100% 호환됩니다.
 
 ---
 
@@ -77,11 +112,8 @@ Unsplash API Key는 `/set api` 명령어로 나중에 설정할 수 있습니다
 
 <img width="1054" height="896" alt="image" src="https://github.com/user-attachments/assets/9e30e0ed-32f9-41a4-b39f-e4e6863d5d2d" />
 
-
-
 카테고리, 공개 여부, 발행 방식을 물어본 뒤 AI가 글을 생성해서 티스토리에 발행합니다.
 
-
 ### 직접 CLI로 실행
 
 ```bash
@@ -125,13 +157,13 @@ config/
 
 ### 글 유형 (AI가 주제에 맞게 자율 선택)
 
-| 유형 | 구조 |
-|------|------|
-| 튜토리얼 | 준비물 → 단계 → 결과 확인 → 트러블슈팅 |
-| 비교/리뷰 | 비교 테이블 + 장단점 → 추천 |
-| 리스트 | 번호 소제목 + 항목별 팁 |
-| 정보 가이드 | 문제 → 원인 → 해결 → FAQ |
-| 인사이트 | 화두 → 근거 → 시사점 → 액션 |
+| 유형        | 구조                                   |
+| ----------- | -------------------------------------- |
+| 튜토리얼    | 준비물 → 단계 → 결과 확인 → 트러블슈팅 |
+| 비교/리뷰   | 비교 테이블 + 장단점 → 추천            |
+| 리스트      | 번호 소제목 + 항목별 팁                |
+| 정보 가이드 | 문제 → 원인 → 해결 → FAQ               |
+| 인사이트    | 화두 → 근거 → 시사점 → 액션            |
 
 ### prompt-config.json 설정
 

package/config/agent-prompt.md

@@ -0,0 +1,31 @@
+당신은 티스토리 블로그 글쓰기를 돕는 자율형 AI 에이전트입니다.
+사용자의 자연어 요청을 이해하고, 적절한 도구를 순서대로 호출하여 블로그 글 작성부터 발행까지 자율적으로 수행합니다.
+
+## 핵심 원칙: 요청받은 작업은 끝까지 실행하라
+
+사용자가 여러 작업을 한 문장에 요청하면 (예: "글 써서 발행해줘"), **중간에 멈추지 말고** 모든 도구를 순서대로 호출하여 완료하세요.
+
+- "글 써서 발행해줘" → `generate_post` 호출 → 바로 `publish_post` 호출
+- "글 써서 수정하고 발행해줘" → `generate_post` → `edit_post` → `publish_post`
+- 중간에 "다음 뭘 할까요?" 같은 질문을 하지 마세요.
+- 모든 작업이 끝난 후 결과를 한 번에 보고하세요.
+
+## 도구 사용 원칙
+
+1. 사용자가 글 작성을 요청하면 `generate_post`를 호출하세요.
+2. 수정 요청이면 `edit_post`를 호출하세요.
+3. 미리보기 요청이면 `preview_post`를 호출하세요.
+4. 발행 요청이면 바로 `publish_post`를 호출하세요. 별도 확인을 구하지 마세요.
+5. 카테고리나 공개설정 변경 요청이면 `set_category` 또는 `set_visibility`를 호출하세요.
+6. 현재 상태를 파악해야 할 때 `get_blog_status`를 호출하세요.
+
+## 대화 스타일
+
+- 한국어로 대화하세요.
+- 도구 호출 결과를 사용자에게 간결하게 요약해서 전달하세요.
+- 작업만 요청받았을 때는 선택지를 제시하지 마세요. 바로 실행하세요.
+- 불필요한 도구 호출을 하지 마세요. 단순 대화는 도구 없이 응답하세요.
+
+## 주의사항
+
+- 초안이 없는 상태에서 수정/미리보기/발행을 요청하면 먼저 글을 작성하라고 안내하세요.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viruagent",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "AI 기반 티스토리 블로그 자동 발행 CLI 도구",
   "main": "src/agent.js",
   "bin": {

package/src/agent.js

@@ -1,6 +1,6 @@
 const readline = require('readline');
 const chalk = require('chalk');
-const { generatePost, revisePost, chat, MODELS, loadConfig } = require('./lib/ai');
+const { generatePost, revisePost, chat, runAgent, MODELS, loadConfig } = require('./lib/ai');
 const { initBlog, getBlogName, publishPost, saveDraft, getPosts, getCategories, VISIBILITY } = require('./lib/tistory');
 
 const TONES = loadConfig().tones.map((t) => t.name);
@@ -162,8 +162,10 @@ const showBootStep = async (msg, asyncFn, minMs = 800) => {
 
 const withSpinner = async (message, asyncFn) => {
   let i = 0;
+  const cols = process.stdout.columns || 80;
+  const truncated = message.length + 2 > cols ? message.slice(0, cols - 5) + '...' : message;
   const timer = setInterval(() => {
-    process.stdout.write(`\r${chalk.cyan(SPINNER_FRAMES[i++ % SPINNER_FRAMES.length])} ${message}`);
+    process.stdout.write(`\r\x1B[K${chalk.cyan(SPINNER_FRAMES[i++ % SPINNER_FRAMES.length])} ${truncated}`);
   }, 80);
   try {
     return await asyncFn();
@@ -599,7 +601,8 @@ ${chalk.cyan('/logout')}            로그아웃 (세션 삭제)
 ${chalk.cyan('/help')}              도움말
 ${chalk.cyan('/exit')}              종료
 
-슬래시 없이 입력하면 AI와 자유 대화 (주제 논의, 아이디어 등)
+슬래시 없이 자연어로 입력하면 AI가 자율적으로 도구를 호출합니다.
+${chalk.dim('예: "AI 트렌드로 글 써줘", "서론을 더 흥미롭게 수정해줘", "발행해줘"')}
 `);
   },
 
@@ -657,12 +660,57 @@ const handleInput = async (input) => {
       log.warn(`알 수 없는 명령어: /${cmd}. /help로 확인하세요.`);
     }
   } else {
-    // 자유 대화
-    state.chatHistory.push({ role: 'user', content: trimmed });
+    // 에이전트 루프 (자연어 → 자율 도구 호출)
     try {
-      const reply = await withSpinner('생각하는 중...', () => chat(state.chatHistory, state.model));
-      state.chatHistory.push({ role: 'assistant', content: reply });
-      console.log(`\n${chalk.blue('AI')} ${reply}\n`);
+      // Braille 도트 애니메이션 (텍스트 없이)
+      const DOT_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+      const DOT_COLORS = [chalk.cyan, chalk.blue, chalk.magenta, chalk.blue];
+      let spinnerTimer = null;
+      let spinnerIdx = 0;
+
+      const startSpinner = () => {
+        stopSpinner();
+        spinnerTimer = setInterval(() => {
+          const colorFn = DOT_COLORS[Math.floor(spinnerIdx / 3) % DOT_COLORS.length];
+          process.stdout.write(`\r\x1B[K  ${colorFn(DOT_FRAMES[spinnerIdx++ % DOT_FRAMES.length])}`);
+        }, 80);
+      };
+
+      const stopSpinner = () => {
+        if (spinnerTimer) {
+          clearInterval(spinnerTimer);
+          spinnerTimer = null;
+          process.stdout.write('\r\x1B[K');
+        }
+      };
+
+      startSpinner();
+
+      const reply = await runAgent(trimmed, {
+        state,
+        publishPost: publishPost,
+        onToolCall: () => {},
+        onToolResult: (name, result) => {
+          stopSpinner();
+          if (result?.error) {
+            log.warn(result.error);
+          } else if (name === 'generate_post' && result?.title) {
+            log.success(`글 생성 완료: "${result.title}"`);
+          } else if (name === 'edit_post' && result?.title) {
+            log.success(`수정 완료: "${result.title}"`);
+          } else if (name === 'publish_post' && result?.url) {
+            log.success(`발행 완료! ${result.url}`);
+          } else if (name === 'set_category' && result?.category) {
+            log.success(`카테고리 설정: ${result.category}`);
+          } else if (name === 'set_visibility' && result?.visibility) {
+            log.success(`공개설정: ${result.visibility}`);
+          }
+          startSpinner();
+        },
+      });
+
+      stopSpinner();
+      console.log(`\n${chalk.blue('AI')}\n${reply}\n`);
     } catch (e) {
       log.error(`대화 실패: ${e.message}`);
     }

package/src/lib/ai.js

@@ -188,4 +188,284 @@ const chat = async (messages, model) => {
   return res.choices[0].message.content;
 };
 
-module.exports = { generatePost, revisePost, chat, MODELS, loadConfig };
+// ─── Agent Pattern: Tool Definitions ───
+
+const AGENT_PROMPT_PATH = path.join(__dirname, '..', '..', 'config', 'agent-prompt.md');
+
+const loadAgentPrompt = () => {
+  try {
+    return fs.readFileSync(AGENT_PROMPT_PATH, 'utf-8');
+  } catch {
+    return '당신은 블로그 글쓰기를 돕는 AI 에이전트입니다. 한국어로 대화하세요.';
+  }
+};
+
+const agentTools = [
+  {
+    type: 'function',
+    function: {
+      name: 'generate_post',
+      description: '블로그 글 초안을 생성합니다.',
+      parameters: {
+        type: 'object',
+        properties: {
+          topic: { type: 'string', description: '글 주제' },
+          tone: { type: 'string', description: '글 톤/말투 (선택)' },
+        },
+        required: ['topic'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'edit_post',
+      description: '현재 초안을 수정합니다.',
+      parameters: {
+        type: 'object',
+        properties: {
+          instruction: { type: 'string', description: '수정 지시사항' },
+        },
+        required: ['instruction'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'preview_post',
+      description: '현재 초안을 미리봅니다.',
+      parameters: { type: 'object', properties: {} },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'publish_post',
+      description: '현재 초안을 블로그에 발행합니다.',
+      parameters: {
+        type: 'object',
+        properties: {
+          visibility: { type: 'number', description: '공개설정 (20=공개, 15=보호, 0=비공개)' },
+        },
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'set_category',
+      description: '블로그 카테고리를 변경합니다.',
+      parameters: {
+        type: 'object',
+        properties: {
+          category_name: { type: 'string', description: '카테고리 이름' },
+        },
+        required: ['category_name'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'set_visibility',
+      description: '공개설정을 변경합니다.',
+      parameters: {
+        type: 'object',
+        properties: {
+          visibility: {
+            type: 'string',
+            enum: ['공개', '보호', '비공개'],
+            description: '공개설정',
+          },
+        },
+        required: ['visibility'],
+      },
+    },
+  },
+  {
+    type: 'function',
+    function: {
+      name: 'get_blog_status',
+      description: '현재 블로그 상태를 조회합니다 (초안 유무, 카테고리, 모델 등).',
+      parameters: { type: 'object', properties: {} },
+    },
+  },
+];
+
+/**
+ * 에이전트 루프 실행
+ * @param {string} userMessage - 사용자 입력
+ * @param {Object} context - 외부 의존성
+ * @param {Object} context.state - 앱 상태 (draft, categories, model, tone 등)
+ * @param {Function} context.publishPost - 발행 함수
+ * @param {Function} context.saveDraft - 임시저장 함수
+ * @param {Function} context.getCategories - 카테고리 조회
+ * @param {Function} context.onToolCall - 도구 호출 시 콜백 (name, args) => void
+ * @param {Function} context.onToolResult - 도구 결과 콜백 (name, result) => void
+ * @returns {Promise<string>} AI 최종 텍스트 응답
+ */
+const runAgent = async (userMessage, context) => {
+  const { state, publishPost: publishFn, onToolCall, onToolResult } = context;
+  const config = loadConfig();
+  const model = state.model || config.defaultModel;
+
+  // 대화 히스토리에 사용자 메시지 추가
+  state.chatHistory.push({ role: 'user', content: userMessage });
+
+  const messages = [
+    { role: 'system', content: loadAgentPrompt() },
+    ...state.chatHistory,
+  ];
+
+  const MAX_LOOPS = 10;
+
+  for (let loop = 0; loop < MAX_LOOPS; loop++) {
+    let res;
+    try {
+      res = await getClient().chat.completions.create({
+        model,
+        messages,
+        tools: agentTools,
+        ...(!isReasoningModel(model) && { temperature: 0.7 }),
+      });
+    } catch (e) {
+      handleApiError(e);
+    }
+
+    const choice = res.choices[0];
+    const msg = choice.message;
+
+    // 메시지를 히스토리에 추가
+    messages.push(msg);
+
+    // tool_calls가 없으면 텍스트 응답 반환
+    if (!msg.tool_calls || msg.tool_calls.length === 0) {
+      const text = msg.content || '';
+      state.chatHistory.push({ role: 'assistant', content: text });
+      return text;
+    }
+
+    // tool_calls 처리
+    for (const toolCall of msg.tool_calls) {
+      const fnName = toolCall.function.name;
+      const args = JSON.parse(toolCall.function.arguments || '{}');
+
+      if (onToolCall) onToolCall(fnName, args);
+
+      let result;
+      try {
+        result = await executeAgentTool(fnName, args, { state, publishFn, config });
+      } catch (e) {
+        result = { error: e.message };
+      }
+
+      const resultStr = typeof result === 'string' ? result : JSON.stringify(result);
+
+      if (onToolResult) onToolResult(fnName, result);
+
+      messages.push({
+        role: 'tool',
+        tool_call_id: toolCall.id,
+        content: resultStr,
+      });
+    }
+  }
+
+  // 루프 초과 시
+  const fallback = '작업이 너무 많은 단계를 거쳤습니다. 현재까지의 진행 상황을 확인해주세요.';
+  state.chatHistory.push({ role: 'assistant', content: fallback });
+  return fallback;
+};
+
+/**
+ * 에이전트 도구 실행
+ */
+const executeAgentTool = async (name, args, { state, publishFn, config }) => {
+  switch (name) {
+    case 'generate_post': {
+      const tone = args.tone || state.tone || config.defaultTone;
+      const result = await generatePost(args.topic, {
+        model: state.model,
+        tone,
+      });
+      state.draft = result;
+      return { success: true, title: result.title, tags: result.tags };
+    }
+
+    case 'edit_post': {
+      if (!state.draft) return { error: '초안이 없습니다. 먼저 글을 생성해주세요.' };
+      const result = await revisePost(state.draft.content, args.instruction, state.model);
+      state.draft.title = result.title;
+      state.draft.content = result.content;
+      state.draft.tags = result.tags;
+      return { success: true, title: result.title, tags: result.tags };
+    }
+
+    case 'preview_post': {
+      if (!state.draft) return { error: '초안이 없습니다.' };
+      const plain = state.draft.content
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&');
+      return {
+        title: state.draft.title,
+        preview: plain.slice(0, 500) + (plain.length > 500 ? '...' : ''),
+        tags: state.draft.tags,
+      };
+    }
+
+    case 'publish_post': {
+      if (!state.draft) return { error: '초안이 없습니다.' };
+      const vis = args.visibility != null ? args.visibility : state.visibility;
+      const result = await publishFn({
+        title: state.draft.title,
+        content: state.draft.content,
+        visibility: vis,
+        category: state.category,
+        tag: state.draft.tags,
+        thumbnail: state.draft.thumbnailKage || null,
+      });
+      const url = result.entryUrl || '';
+      state.draft = null;
+      return { success: true, url };
+    }
+
+    case 'set_category': {
+      const id = state.categories[args.category_name];
+      if (id === undefined) {
+        return { error: `"${args.category_name}" 카테고리를 찾을 수 없습니다.`, available: Object.keys(state.categories) };
+      }
+      state.category = id;
+      return { success: true, category: args.category_name, id };
+    }
+
+    case 'set_visibility': {
+      const visMap = { '공개': 20, '보호': 15, '비공개': 0 };
+      if (visMap[args.visibility] === undefined) {
+        return { error: '유효하지 않은 공개설정입니다. 공개/보호/비공개 중 선택하세요.' };
+      }
+      state.visibility = visMap[args.visibility];
+      return { success: true, visibility: args.visibility };
+    }
+
+    case 'get_blog_status': {
+      return {
+        hasDraft: !!state.draft,
+        draftTitle: state.draft?.title || null,
+        category: Object.entries(state.categories).find(([, id]) => id === state.category)?.[0] || '없음',
+        visibility: state.visibility === 20 ? '공개' : state.visibility === 15 ? '보호' : '비공개',
+        model: state.model,
+        tone: state.tone,
+        availableCategories: Object.keys(state.categories),
+      };
+    }
+
+    default:
+      return { error: `알 수 없는 도구: ${name}` };
+  }
+};
+
+module.exports = { generatePost, revisePost, chat, runAgent, MODELS, loadConfig };