companionbot 0.16.0 → 0.16.2

package/dist/telegram/handlers/messages.js

@@ -3,7 +3,7 @@ import { recordActivity, recordError } from "../../health/index.js";
 import { getHistory, getModel, getThinkingLevel, runWithChatId, trimHistoryByTokens, smartTrimHistory, detectImportantContext, pinContext, addMessage, } from "../../session/state.js";
 import * as persistence from "../../session/persistence.js";
 import { updateLastMessageTime } from "../../heartbeat/index.js";
-import { extractUrls, fetchWebContent, formatUrlContent, buildSystemPrompt, } from "../utils/index.js";
+import { extractUrls, fetchWebContent, formatUrlContent, buildSystemPrompt, formatMessageTimestamp, } from "../utils/index.js";
 import { estimateMessagesTokens } from "../../utils/tokens.js";
 import { TOKENS, TELEGRAM } from "../../config/constants.js";
 import { toUserFriendlyError } from "../../utils/retry.js";
@@ -155,8 +155,9 @@ export function registerMessageHandlers(bot) {
                 const response = await fetch(fileUrl);
                 const buffer = await response.arrayBuffer();
                 const base64 = Buffer.from(buffer).toString("base64");
-                // 캡션이 있으면 사용, 없으면 기본 질문
-                const caption = ctx.message.caption || "이 사진에 뭐가 있어?";
+                // 캡션이 있으면 사용, 없으면 기본 질문 (타임스탬프 포함)
+                const rawCaption = ctx.message.caption || "이 사진에 뭐가 있어?";
+                const caption = `${formatMessageTimestamp()} ${rawCaption}`;
                 // 이미지와 텍스트를 함께 전송
                 const imageContent = [
                     {
@@ -174,7 +175,7 @@ export function registerMessageHandlers(bot) {
                 ];
                 // API용 메모리 히스토리에는 이미지 데이터 포함
                 history.push({ role: "user", content: imageContent });
-                // JSONL에는 캡션만 저장 (이미지 base64는 너무 큼)
+                // JSONL에는 캡션만 저장 (이미지 base64는 너무 큼) - caption에 이미 타임스탬프 포함
                 persistence.appendMessage(chatId, "user", `[이미지] ${caption}`);
                 try {
                     const systemPrompt = await buildSystemPrompt(modelId, history);
@@ -267,8 +268,9 @@ export function registerMessageHandlers(bot) {
                     messageForHistory = userMessage + "\n\n" + urlRefs.join("\n");
                 }
             }
-            // 히스토리에는 간략 버전 저장 + JSONL에 영구 저장
-            addMessage(chatId, "user", messageForHistory);
+            // 히스토리에는 간략 버전 저장 + JSONL에 영구 저장 (타임스탬프 포함)
+            const timestampedMessage = formatMessageTimestamp() + " " + messageForHistory;
+            addMessage(chatId, "user", timestampedMessage);
             // Typing indicator 시작 (긴 작업 동안 유지)
             const typingIndicator = new TypingIndicator(ctx);
             typingIndicator.start();

package/dist/telegram/utils/index.js

@@ -4,3 +4,5 @@ export { extractUrls, fetchWebContent, isSafeUrl, formatUrlContent, clearUrlCach
 export { buildSystemPrompt, extractName } from "./prompt.js";
 // Cache utilities
 export { getWorkspace, invalidateWorkspaceCache, preloadWorkspace, isWorkspaceCached } from "./cache.js";
+// Timestamp utilities
+export { formatMessageTimestamp, addTimestampToMessage } from "./timestamp.js";

package/dist/telegram/utils/timestamp.js

@@ -0,0 +1,43 @@
+/**
+ * 메시지에 타임스탬프를 추가하는 유틸리티
+ * LLM이 시간 순서와 오늘/어제를 구분할 수 있도록 함
+ */
+/**
+ * 현재 시간을 간결한 형식으로 반환
+ * 예: "[10:35]" 또는 "[어제 23:15]"
+ */
+export function formatMessageTimestamp(date = new Date()) {
+    const now = new Date();
+    const isToday = date.toDateString() === now.toDateString();
+    const yesterday = new Date(now);
+    yesterday.setDate(yesterday.getDate() - 1);
+    const isYesterday = date.toDateString() === yesterday.toDateString();
+    const time = date.toLocaleTimeString("ko-KR", {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+        timeZone: "Asia/Seoul",
+    });
+    if (isToday) {
+        return `[${time}]`;
+    }
+    else if (isYesterday) {
+        return `[어제 ${time}]`;
+    }
+    else {
+        // 더 오래된 경우 날짜도 포함
+        const dateStr = date.toLocaleDateString("ko-KR", {
+            month: "short",
+            day: "numeric",
+            timeZone: "Asia/Seoul",
+        });
+        return `[${dateStr} ${time}]`;
+    }
+}
+/**
+ * 메시지 내용에 타임스탬프 prefix 추가
+ */
+export function addTimestampToMessage(content, date = new Date()) {
+    const timestamp = formatMessageTimestamp(date);
+    return `${timestamp} ${content}`;
+}

package/dist/tools/definitions.js

@@ -100,11 +100,11 @@ export const compactTools = [
     },
     {
         name: "save_memory",
-        description: "Save important info to daily memory (user_info, preference, event, etc.)",
+        description: "중요한 정보 저장. 사용자 정보, 선호도, 약속, 결정 등 나중에 기억해야 할 것들",
         input_schema: {
             type: "object",
             properties: {
-                content: { type: "string", description: "Information to remember" },
+                content: { type: "string", description: "기억할 내용" },
                 category: { type: "string", enum: ["user_info", "preference", "event", "project", "decision", "emotion", "other"] },
             },
             required: ["content"],
@@ -112,11 +112,11 @@ export const compactTools = [
     },
     {
         name: "memory_search",
-        description: "Semantic search through long-term memories",
+        description: "과거 기억 검색. 이전에 나눈 대화, 저장한 정보, 사용자 선호도 등을 찾을 때 사용",
         input_schema: {
             type: "object",
             properties: {
-                query: { type: "string" },
+                query: { type: "string", description: "검색할 내용" },
                 limit: { type: "number", description: "Max results (default: 5)" },
                 minScore: { type: "number", description: "Min similarity 0-1 (default: 0.3)" },
             },
@@ -131,11 +131,11 @@ export const compactTools = [
     // === 날씨/웹 ===
     {
         name: "get_weather",
-        description: "Get current weather for a city",
+        description: "현재 날씨 조회. 외출, 옷차림, 우산 필요 여부 등 물어볼 때 사용",
         input_schema: {
             type: "object",
             properties: {
-                city: { type: "string" },
+                city: { type: "string", description: "도시명 (예: Seoul, Tokyo)" },
                 country: { type: "string", description: "Country code (optional)" },
             },
             required: ["city"],
@@ -143,11 +143,11 @@ export const compactTools = [
     },
     {
         name: "web_search",
-        description: "Search web via Brave API",
+        description: "웹 검색 (Brave API). 최신 정보, 뉴스, 사실 확인이 필요할 때 사용. 검색어로 관련 결과 반환",
         input_schema: {
             type: "object",
             properties: {
-                query: { type: "string" },
+                query: { type: "string", description: "검색어" },
                 count: { type: "number", description: "Results count (default: 5, max: 20)" },
             },
             required: ["query"],
@@ -155,11 +155,11 @@ export const compactTools = [
     },
     {
         name: "web_fetch",
-        description: "Extract readable content from URL",
+        description: "URL에서 웹페이지 본문 추출. 링크 내용 확인, 기사 읽기, 문서 요약 등에 사용. HTML → 텍스트 변환",
         input_schema: {
             type: "object",
             properties: {
-                url: { type: "string" },
+                url: { type: "string", description: "가져올 웹페이지 URL" },
                 maxChars: { type: "number", description: "Max chars (default: 5000)" },
             },
             required: ["url"],

package/package.json

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