companionbot 0.8.2 → 0.9.0

package/dist/telegram/utils/url.js

@@ -1,4 +1,7 @@
 import * as cheerio from "cheerio";
+// URL 내용 캐시 (중복 fetch 방지)
+const urlCache = new Map();
+const URL_CACHE_TTL = 10 * 60 * 1000; // 10분
 /**
  * 텍스트에서 URL을 추출합니다.
  */
@@ -72,6 +75,7 @@ export function isSafeUrl(url) {
 }
 /**
  * 웹페이지 내용을 가져옵니다.
+ * 캐시 지원으로 중복 fetch 방지
  */
 export async function fetchWebContent(url) {
     // SSRF 방지
@@ -79,6 +83,12 @@ export async function fetchWebContent(url) {
         console.log(`[Security] Blocked unsafe URL: ${url}`);
         return null;
     }
+    // 캐시 확인
+    const cached = urlCache.get(url);
+    if (cached && Date.now() - cached.timestamp < URL_CACHE_TTL) {
+        console.log(`[URL] Cache hit: ${url}`);
+        return { title: cached.title, content: cached.content };
+    }
     try {
         // 10초 타임아웃
         const controller = new AbortController();
@@ -107,7 +117,15 @@ export async function fetchWebContent(url) {
         const content = mainContent
             .replace(/\s+/g, " ")
             .trim()
-            .slice(0, 5000); // 5000자로 제한
+            .slice(0, 3000); // 5000 → 3000자로 제한 (토큰 절약)
+        // 캐시 저장
+        urlCache.set(url, { title, content, timestamp: Date.now() });
+        // 캐시 크기 제한 (최대 50개)
+        if (urlCache.size > 50) {
+            const oldestKey = urlCache.keys().next().value;
+            if (oldestKey)
+                urlCache.delete(oldestKey);
+        }
         return { title, content };
     }
     catch (error) {
@@ -115,3 +133,18 @@ export async function fetchWebContent(url) {
         return null;
     }
 }
+/**
+ * URL 내용을 컨텍스트용 포맷으로 변환합니다.
+ * 히스토리에는 간략한 버전만, 현재 요청에는 전체 내용
+ */
+export function formatUrlContent(url, content) {
+    const forHistory = `[링크: ${content.title}](${url})`;
+    const forContext = `\n---\n📎 ${url}\n📌 ${content.title}\n${content.content}\n---`;
+    return { forHistory, forContext };
+}
+/**
+ * 캐시를 무효화합니다.
+ */
+export function clearUrlCache() {
+    urlCache.clear();
+}

package/dist/tools/index.js

@@ -354,17 +354,35 @@ Guidelines:
     },
     {
         name: "save_memory",
-        description: "Save important information about the user or conversation to long-term memory. Use this when you learn something new about the user that should be remembered.",
+        description: `Save important information to daily memory. This is automatically saved to memory/YYYY-MM-DD.md.
+
+**WHEN TO USE (proactively, without being asked):**
+- User shares personal info: name, birthday, family, job, location
+- User expresses preferences: likes, dislikes, habits, routines
+- User mentions plans: upcoming events, projects, goals
+- User shares emotional moments: achievements, concerns, decisions
+- Significant conversation outcomes: agreements, conclusions, learnings
+- Technical context: project names, tech stack, environments
+
+**WHEN NOT TO USE:**
+- Trivial small talk
+- Already recorded information
+- Temporary/fleeting topics
+
+**TIPS:**
+- Be concise but include context (why it matters)
+- Include date references for time-sensitive info
+- Group related facts together`,
         input_schema: {
             type: "object",
             properties: {
                 content: {
                     type: "string",
-                    description: "The information to remember",
+                    description: "The information to remember. Be specific and include context.",
                 },
                 category: {
                     type: "string",
-                    enum: ["user_info", "preference", "event", "project", "other"],
+                    enum: ["user_info", "preference", "event", "project", "decision", "emotion", "other"],
                     description: "Category of the memory",
                 },
             },

package/dist/workspace/load.js

@@ -1,6 +1,43 @@
 import * as fs from "fs/promises";
 import * as path from "path";
 import { getWorkspacePath, getWorkspaceFilePath, getDailyMemoryPath } from "./paths.js";
+// 파일 크기 제한 (문자 수)
+const FILE_LIMITS = {
+    identity: 2000, // IDENTITY.md - 간결해야 함
+    soul: 4000, // SOUL.md - 성격/스타일
+    user: 3000, // USER.md - 사용자 정보
+    agents: 8000, // AGENTS.md - 가이드라인
+    tools: 3000, // TOOLS.md - 도구 노트
+    heartbeat: 2000, // HEARTBEAT.md - 체크리스트
+    memory: 6000, // MEMORY.md - 장기 기억
+    bootstrap: 2000, // BOOTSTRAP.md - 온보딩
+};
+// 전체 워크스페이스 최대 크기 (토큰 절약)
+const TOTAL_WORKSPACE_LIMIT = 25000;
+/**
+ * 파일을 읽고 크기 제한 적용
+ */
+async function readFileWithLimit(filePath, limit) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        if (content.length > limit) {
+            // 마지막 완전한 문단에서 자르기
+            let truncated = content.slice(0, limit);
+            const lastNewline = truncated.lastIndexOf("\n\n");
+            if (lastNewline > limit * 0.7) {
+                truncated = truncated.slice(0, lastNewline);
+            }
+            return {
+                content: truncated + "\n\n... (truncated)",
+                truncated: true
+            };
+        }
+        return { content, truncated: false };
+    }
+    catch {
+        return { content: null, truncated: false };
+    }
+}
 async function readFileOrNull(filePath) {
     try {
         return await fs.readFile(filePath, "utf-8");
@@ -9,17 +46,84 @@ async function readFileOrNull(filePath) {
         return null;
     }
 }
+/**
+ * 오늘과 어제의 daily memory를 로드합니다.
+ * 시스템 프롬프트에 직접 포함되어 최근 컨텍스트를 제공합니다.
+ */
+async function loadRecentDailyMemory() {
+    const parts = [];
+    const today = new Date();
+    const yesterday = new Date(today);
+    yesterday.setDate(yesterday.getDate() - 1);
+    const DAILY_LIMIT = 2500; // 각 날짜별 최대 문자 수
+    for (const [label, date] of [["오늘", today], ["어제", yesterday]]) {
+        try {
+            const memoryPath = getDailyMemoryPath(date);
+            let content = await fs.readFile(memoryPath, "utf-8");
+            if (content.trim()) {
+                // 너무 길면 최근 부분만 유지 (## 타임스탬프 기준)
+                if (content.length > DAILY_LIMIT) {
+                    // ## 로 시작하는 섹션들로 분할
+                    const sections = content.split(/(?=^## )/m);
+                    let trimmedContent = "";
+                    // 뒤에서부터 추가 (최근 기록 우선)
+                    for (let i = sections.length - 1; i >= 0; i--) {
+                        if ((trimmedContent + sections[i]).length > DAILY_LIMIT)
+                            break;
+                        trimmedContent = sections[i] + trimmedContent;
+                    }
+                    content = "...(이전 기록 생략)...\n" + trimmedContent.trim();
+                }
+                parts.push(`### ${label} 기록 (${date.toISOString().split("T")[0]})\n${content.trim()}`);
+            }
+        }
+        catch {
+            // 파일 없음 무시
+        }
+    }
+    return parts.length > 0 ? parts.join("\n\n") : null;
+}
 export async function loadWorkspace() {
     const workspacePath = getWorkspacePath();
-    const [agents, bootstrap, identity, soul, user, memory] = await Promise.all([
-        readFileOrNull(path.join(workspacePath, "AGENTS.md")),
-        readFileOrNull(path.join(workspacePath, "BOOTSTRAP.md")),
-        readFileOrNull(path.join(workspacePath, "IDENTITY.md")),
-        readFileOrNull(path.join(workspacePath, "SOUL.md")),
-        readFileOrNull(path.join(workspacePath, "USER.md")),
-        readFileOrNull(path.join(workspacePath, "MEMORY.md")),
+    const truncatedFiles = [];
+    const results = await Promise.all([
+        readFileWithLimit(path.join(workspacePath, "AGENTS.md"), FILE_LIMITS.agents),
+        readFileOrNull(path.join(workspacePath, "BOOTSTRAP.md")), // bootstrap은 제한 없음 (임시)
+        readFileWithLimit(path.join(workspacePath, "IDENTITY.md"), FILE_LIMITS.identity),
+        readFileWithLimit(path.join(workspacePath, "SOUL.md"), FILE_LIMITS.soul),
+        readFileWithLimit(path.join(workspacePath, "USER.md"), FILE_LIMITS.user),
+        readFileWithLimit(path.join(workspacePath, "TOOLS.md"), FILE_LIMITS.tools),
+        readFileWithLimit(path.join(workspacePath, "HEARTBEAT.md"), FILE_LIMITS.heartbeat),
+        readFileWithLimit(path.join(workspacePath, "MEMORY.md"), FILE_LIMITS.memory),
+        loadRecentDailyMemory(), // 오늘/어제 daily memory
     ]);
-    return { agents, bootstrap, identity, soul, user, memory };
+    const [agents, bootstrap, identity, soul, user, tools, heartbeat, memory, recentDaily] = results;
+    // 잘린 파일 추적
+    const fileNames = ["AGENTS.md", "BOOTSTRAP.md", "IDENTITY.md", "SOUL.md", "USER.md", "TOOLS.md", "HEARTBEAT.md", "MEMORY.md"];
+    results.slice(0, 8).forEach((r, i) => {
+        if (typeof r === "object" && r !== null && "truncated" in r && r.truncated) {
+            truncatedFiles.push(fileNames[i]);
+        }
+    });
+    // 타입 가드: readFileWithLimit 결과에서 content 추출
+    const getContent = (r) => {
+        if (r && typeof r === "object" && "content" in r) {
+            return r.content;
+        }
+        return null;
+    };
+    return {
+        agents: getContent(agents),
+        bootstrap: typeof bootstrap === "string" ? bootstrap : null,
+        identity: getContent(identity),
+        soul: getContent(soul),
+        user: getContent(user),
+        tools: getContent(tools),
+        heartbeat: getContent(heartbeat),
+        memory: getContent(memory),
+        recentDaily: typeof recentDaily === "string" ? recentDaily : null,
+        truncated: truncatedFiles,
+    };
 }
 export async function loadBootstrap() {
     return readFileOrNull(getWorkspaceFilePath("BOOTSTRAP.md"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "companionbot",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "AI 친구 텔레그램 봇 - Claude API 기반 개인화된 대화 상대",
   "keywords": [
     "telegram",

package/templates/AGENTS.md

@@ -9,7 +9,7 @@
 1. `SOUL.md` 읽기 — 이게 너의 성격
 2. `USER.md` 읽기 — 이 사람이 누군지
 3. `memory/YYYY-MM-DD.md` 읽기 (오늘 + 어제) — 최근 맥락
-4. 중요한 대화면 `MEMORY.md`도 읽기
+4. **1:1 대화에서만** `MEMORY.md` 읽기
 
 허락 구하지 마. 그냥 해.
 
@@ -22,6 +22,13 @@
 
 중요한 건 적어둬. 결정, 맥락, 기억할 것들.
 
+### 🧠 MEMORY.md - 장기 기억
+
+- **1:1 대화에서만 로드해** (사용자와 직접 대화)
+- **그룹챗에서는 로드하지 마** — 보안상 개인 정보가 새어나갈 수 있어
+- 중요한 사건, 생각, 결정, 배운 것들을 기록
+- 데일리 파일에서 정제된 핵심만 여기에
+
 ### 📝 적어둬 - "기억해둘게"는 안 돼!
 
 - **기억력은 제한적** — 기억하고 싶으면 파일에 써
@@ -34,7 +41,7 @@
 
 - 개인정보 유출 절대 금지
 - 위험한 명령어는 물어보고 실행
-- `MEMORY.md`에 민감한 정보 저장하지 마
+- `MEMORY.md`에 민감한 정보(비밀번호 등) 저장하지 마
 - 확신 없으면 물어봐
 
 ## 외부 vs 내부
@@ -64,13 +71,6 @@
 - 도구 이름 모르면 그냥 하고 싶은 거 말해
 - 안 되면 솔직하게 "이건 못 해"라고 말해
 
-**자주 쓰는 것들:**
-- 파일 읽기/쓰기
-- 웹 검색, URL 내용 가져오기
-- 리마인더, 일정
-- 날씨 조회
-- 스케줄링 (cron)
-
 ## 도구 호출 스타일
 
 기본: 단순한 도구 호출은 설명 없이 바로 실행해.
@@ -114,17 +114,21 @@ Telegram에서 이모지 반응 사용 가능해. 텍스트 응답 대신 반응
 
 ## 그룹챗 행동
 
-그룹챗에서는 더 조심해.
+그룹챗에서는 더 조심해. 너는 참여자지, 사용자의 대리인이 아니야.
 
 **말해야 할 때:**
 - 직접 멘션되었을 때
 - 내가 답할 수 있는 질문
 - 유용한 정보 추가할 수 있을 때
+- 자연스럽게 재치있는 말이 맞을 때
 
 **조용히 있어야 할 때:**
 - 사람들끼리 대화 중
 - 누군가 이미 답변함
-- 단순 잡담
+- "ㅇㅇ", "ㅋㅋ" 정도면 충분할 때
+- 대화 흐름이 잘 가고 있을 때
+
+**사람 규칙:** 사람들도 그룹챗에서 모든 메시지에 답하지 않아. 너도 마찬가지. 질 > 양.
 
 그룹에서는 참여하되, 지배하지 마.
 
@@ -157,18 +161,49 @@ Telegram에서 이모지 반응 사용 가능해. 텍스트 응답 대신 반응
 - 명령/지시
 - 중요한 정보 공유
 
-**HEARTBEAT_OK:**
-하트비트 메시지 받았는데 특별히 할 일 없으면 `HEARTBEAT_OK`만 응답.
-
 ## 💓 Heartbeat
 
 주기적으로 HEARTBEAT.md를 체크해. 할 일이 있으면 알려주고, 없으면 조용히 있어.
 
+**할 일 없으면:** `HEARTBEAT_OK`만 응답.
+
 **알림 보낼 때:**
 - 중요한 것만
 - 심야 (23:00-08:00)엔 급한 거 아니면 조용히
 - 최근 30분 내 체크했으면 스킵
 
+**하트비트 중 할 수 있는 일:**
+- 메모리 파일 정리
+- 프로젝트 상태 확인
+- 문서 업데이트
+- MEMORY.md 리뷰 및 업데이트
+
+### Heartbeat vs Cron
+
+**Heartbeat 쓸 때:**
+- 여러 체크를 묶어서 (캘린더 + 리마인더 + 알림)
+- 최근 대화 맥락이 필요할 때
+- 타이밍이 정확하지 않아도 될 때 (~30분 간격)
+
+**Cron 쓸 때:**
+- 정확한 시간이 필요할 때 ("매주 월요일 9시")
+- 메인 세션과 독립적으로 실행해야 할 때
+- 단발성 리마인더 ("20분 후 알려줘")
+- 결과를 바로 채널로 보내야 할 때
+
+**팁:** 비슷한 주기적 체크는 HEARTBEAT.md에 묶어서. Cron은 정확한 스케줄과 단독 작업용.
+
+### 🔄 메모리 정리 (하트비트 중)
+
+주기적으로 (며칠에 한 번):
+
+1. 최근 `memory/YYYY-MM-DD.md` 파일들 읽기
+2. 장기적으로 중요한 사건, 교훈, 인사이트 찾기
+3. `MEMORY.md`에 정제해서 업데이트
+4. 더 이상 관련 없는 정보는 MEMORY.md에서 제거
+
+데일리 파일은 원본 기록, MEMORY.md는 정제된 지혜.
+
 ## 이 파일을 수정해도 돼
 
 이건 시작점이야. 너만의 규칙, 스타일, 컨벤션을 추가해.