companionbot 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DinN0000
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# CompanionBot
+
+Claude 기반의 개인화된 페르소나를 가진 AI Companion Bot
+
+## 기능
+
+- 자연스러운 대화 (Claude Sonnet/Opus/Haiku)
+- 첫 실행 시 온보딩으로 페르소나 설정
+- 이미지 분석 (사진 보내면 분석)
+- 링크 요약 (URL 보내면 내용 요약)
+- 날씨 조회 ("서울 날씨 어때?")
+- 리마인더 ("10분 뒤에 알려줘")
+- Google Calendar 연동
+- 일일 브리핑 (매일 아침 날씨/일정)
+- Heartbeat (주기적 체크 후 알림)
+- 일일 메모리 자동 저장
+
+## 설치
+
+### 간편 설치 (일반 사용자)
+
+```bash
+npm install -g companionbot
+companionbot
+```
+
+첫 실행 시 자동으로 설정을 안내합니다.
+
+### 개발자 설치 (소스코드 수정)
+
+```bash
+git clone https://github.com/hwai/companionbot.git
+cd companionbot
+npm install
+npm run build
+npm start
+```
+
+### 사전 준비
+
+- **Node.js 18+**
+- **Telegram Bot Token** - @BotFather에서 발급
+- **Anthropic API Key** - console.anthropic.com
+
+#### Linux 사용자 (keytar 의존성)
+
+```bash
+# Debian/Ubuntu
+sudo apt-get install libsecret-1-dev
+
+# Fedora
+sudo dnf install libsecret-devel
+
+# Arch
+sudo pacman -S libsecret
+```
+
+## 첫 실행
+
+```
+🤖 CompanionBot 첫 실행입니다!
+
+[1/2] Telegram Bot Token
+      @BotFather에서 봇 생성 후 토큰을 붙여넣으세요.
+      Token: _
+
+[2/2] Anthropic API Key
+      console.anthropic.com에서 발급받으세요.
+      API Key: _
+
+📁 워크스페이스 생성 중...
+   → ~/.companionbot/ 생성 완료
+
+🚀 봇을 시작합니다!
+```
+
+## 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `/start` | 봇 시작 (첫 실행 시 온보딩) |
+| `/setup` | 기능 설정 메뉴 |
+| `/briefing` | 일일 브리핑 토글 |
+| `/heartbeat` | Heartbeat 토글 |
+| `/reminders` | 알림 목록 |
+| `/calendar` | 오늘 일정 |
+| `/compact` | 대화 정리 |
+| `/memory` | 최근 기억 |
+| `/reset` | 페르소나 초기화 |
+
+### 자연어 명령
+
+명령어 대신 자연어로 말해도 됩니다:
+
+- "하이쿠로 바꿔줘" → 모델 변경
+- "10분 뒤에 알려줘" → 리마인더
+- "브리핑 꺼줘" → 브리핑 비활성화
+- "아침 9시에 브리핑 해줘" → 브리핑 시간 설정
+- "지금 브리핑 해줘" → 즉시 브리핑
+- "하트비트 켜줘" → Heartbeat 활성화
+- "서울 날씨 어때?" → 날씨 조회
+- "이거 기억해둬" → 메모리 저장
+
+## PM2로 상시 실행
+
+```bash
+npm install -g pm2
+pm2 start npm --name companionbot -- start
+pm2 startup && pm2 save
+```
+
+## 워크스페이스
+
+`~/.companionbot/` 구조:
+
+```
+├── AGENTS.md      # 운영 지침
+├── BOOTSTRAP.md   # 온보딩 (완료 후 삭제)
+├── HEARTBEAT.md   # 주기적 체크 항목
+├── IDENTITY.md    # 봇 정체성
+├── MEMORY.md      # 장기 기억
+├── SOUL.md        # 봇 성격
+├── TOOLS.md       # 도구 설정
+├── USER.md        # 사용자 정보
+├── canvas/        # 봇 작업 디렉토리
+└── memory/        # 일일 로그
+    └── YYYY-MM-DD.md
+```
+
+## 시크릿 저장
+
+OS 키체인에 안전하게 저장됩니다:
+- macOS: Keychain Access
+- Windows: Credential Manager
+- Linux: libsecret
+
+재설정: `~/.companionbot/` 삭제 후 다시 실행
+
+## 개발
+
+```bash
+npm run dev    # 개발 모드
+npm run build  # 빌드
+npm start      # 실행
+```
+
+## License
+
+MIT

package/bin/companionbot.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli/main.js";

package/dist/ai/claude.js

@@ -0,0 +1,104 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { tools, executeTool } from "../tools/index.js";
+let anthropic = null;
+function getClient() {
+    if (!anthropic) {
+        anthropic = new Anthropic();
+    }
+    return anthropic;
+}
+export const MODELS = {
+    sonnet: { id: "claude-sonnet-4-20250514", name: "Claude Sonnet 4" },
+    opus: { id: "claude-opus-4-20250514", name: "Claude Opus 4" },
+    haiku: { id: "claude-haiku-3-5-20241022", name: "Claude Haiku 3.5" },
+};
+export async function chat(messages, systemPrompt, modelId = "sonnet") {
+    const client = getClient();
+    const model = MODELS[modelId].id;
+    // 메시지를 API 형식으로 변환
+    const apiMessages = messages.map((m) => ({
+        role: m.role,
+        content: m.content,
+    }));
+    let response;
+    try {
+        response = await client.messages.create({
+            model,
+            max_tokens: 4096,
+            system: systemPrompt,
+            messages: apiMessages,
+            tools: tools,
+        });
+    }
+    catch (error) {
+        if (error instanceof Anthropic.APIError) {
+            if (error.status === 429) {
+                throw new Error("API 요청이 너무 많아. 잠시 후 다시 시도해줘.");
+            }
+            if (error.status >= 500) {
+                throw new Error("AI 서버에 문제가 생겼어. 잠시 후 다시 시도해줘.");
+            }
+        }
+        throw error;
+    }
+    // Tool use 루프 - Claude가 도구 사용을 멈출 때까지 반복 (최대 10회)
+    const MAX_TOOL_ITERATIONS = 10;
+    let iterations = 0;
+    while (response.stop_reason === "tool_use" && iterations < MAX_TOOL_ITERATIONS) {
+        iterations++;
+        const toolUseBlocks = response.content.filter((block) => block.type === "tool_use");
+        // 도구 실행 결과 수집
+        const toolResults = [];
+        for (const toolUse of toolUseBlocks) {
+            console.log(`[Tool] ${toolUse.name}:`, JSON.stringify(toolUse.input));
+            const result = await executeTool(toolUse.name, toolUse.input);
+            // 결과가 너무 길면 자르기
+            const truncatedResult = result.length > 10000
+                ? result.slice(0, 10000) + "\n... (truncated)"
+                : result;
+            toolResults.push({
+                type: "tool_result",
+                tool_use_id: toolUse.id,
+                content: truncatedResult,
+            });
+        }
+        // 어시스턴트 메시지와 도구 결과 추가
+        apiMessages.push({
+            role: "assistant",
+            content: response.content,
+        });
+        apiMessages.push({
+            role: "user",
+            content: toolResults,
+        });
+        // 다음 응답 요청
+        try {
+            response = await client.messages.create({
+                model,
+                max_tokens: 4096,
+                system: systemPrompt,
+                messages: apiMessages,
+                tools: tools,
+            });
+        }
+        catch (error) {
+            if (error instanceof Anthropic.APIError) {
+                if (error.status === 429) {
+                    throw new Error("API 요청이 너무 많아. 잠시 후 다시 시도해줘.");
+                }
+                if (error.status >= 500) {
+                    throw new Error("AI 서버에 문제가 생겼어. 잠시 후 다시 시도해줘.");
+                }
+            }
+            throw error;
+        }
+    }
+    // 반복 횟수 초과 시 경고
+    if (iterations >= MAX_TOOL_ITERATIONS) {
+        console.warn(`[Warning] Tool use loop reached max iterations (${MAX_TOOL_ITERATIONS})`);
+        return "도구 실행이 너무 많이 반복됐어. 다시 시도해줄래?";
+    }
+    // 최종 텍스트 응답 추출
+    const textBlock = response.content.find((block) => block.type === "text");
+    return textBlock?.text ?? "응답을 생성하지 못했어. 다시 시도해줄래?";
+}

package/dist/briefing/index.js

@@ -0,0 +1,202 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import cron from "node-cron";
+import { getWorkspacePath } from "../workspace/index.js";
+import { getSecret } from "../config/secrets.js";
+import { isCalendarConfigured, getTodayEvents, formatEvent } from "../calendar/index.js";
+// 활성 스케줄
+const activeJobs = new Map();
+// 봇 인스턴스
+let botInstance = null;
+export function setBriefingBot(bot) {
+    botInstance = bot;
+}
+function getConfigPath() {
+    return path.join(getWorkspacePath(), "briefing.json");
+}
+async function loadStore() {
+    try {
+        const data = await fs.readFile(getConfigPath(), "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return { configs: [] };
+    }
+}
+async function saveStore(store) {
+    await fs.writeFile(getConfigPath(), JSON.stringify(store, null, 2));
+}
+// 날씨 가져오기
+async function fetchWeather(city) {
+    const apiKey = await getSecret("openweathermap-api-key");
+    if (!apiKey)
+        return null;
+    try {
+        const url = `https://api.openweathermap.org/data/2.5/weather?q=${encodeURIComponent(city)}&appid=${apiKey}&units=metric&lang=kr`;
+        const response = await fetch(url);
+        const data = await response.json();
+        if (data.cod !== 200)
+            return null;
+        const temp = Math.round(data.main.temp);
+        const description = data.weather[0].description;
+        const icon = getWeatherEmoji(data.weather[0].icon);
+        return `${icon} ${city} ${temp}°C, ${description}`;
+    }
+    catch {
+        return null;
+    }
+}
+function getWeatherEmoji(iconCode) {
+    const map = {
+        "01d": "☀️", "01n": "🌙",
+        "02d": "⛅", "02n": "☁️",
+        "03d": "☁️", "03n": "☁️",
+        "04d": "☁️", "04n": "☁️",
+        "09d": "🌧️", "09n": "🌧️",
+        "10d": "🌦️", "10n": "🌧️",
+        "11d": "⛈️", "11n": "⛈️",
+        "13d": "❄️", "13n": "❄️",
+        "50d": "🌫️", "50n": "🌫️",
+    };
+    return map[iconCode] || "🌤️";
+}
+// 브리핑 실행
+async function executeBriefing(config) {
+    if (!botInstance) {
+        console.error("[Briefing] Bot instance not set");
+        return;
+    }
+    const parts = [];
+    // 인사
+    const hour = new Date().getHours();
+    const greeting = hour < 12 ? "좋은 아침!" : hour < 18 ? "좋은 오후!" : "좋은 저녁!";
+    parts.push(`☀️ ${greeting}\n`);
+    // 날씨
+    const weather = await fetchWeather(config.city);
+    if (weather) {
+        parts.push(`🌤️ 오늘 날씨\n${weather}\n`);
+    }
+    // 캘린더
+    const calendarConfigured = await isCalendarConfigured();
+    if (calendarConfigured) {
+        try {
+            const events = await getTodayEvents();
+            if (events.length > 0) {
+                const eventList = events.slice(0, 5).map(formatEvent).join("\n• ");
+                parts.push(`📅 오늘 일정\n• ${eventList}\n`);
+            }
+            else {
+                parts.push(`📅 오늘 일정 없음\n`);
+            }
+        }
+        catch (error) {
+            console.error("[Briefing] Calendar error:", error);
+        }
+    }
+    // 마무리
+    parts.push(`좋은 하루 보내세요! 🙂`);
+    const message = parts.join("\n");
+    try {
+        await botInstance.api.sendMessage(config.chatId, message);
+        console.log(`[Briefing] Sent to ${config.chatId}`);
+    }
+    catch (error) {
+        console.error("[Briefing] Send error:", error);
+    }
+}
+// 스케줄 설정
+function scheduleBriefing(config) {
+    // 기존 job 취소
+    const existing = activeJobs.get(config.chatId);
+    if (existing) {
+        existing.stop();
+        activeJobs.delete(config.chatId);
+    }
+    if (!config.enabled)
+        return;
+    const [hour, minute] = config.time.split(":").map(Number);
+    const cronExpr = `${minute} ${hour} * * *`;
+    const job = cron.schedule(cronExpr, () => {
+        executeBriefing(config);
+    }, {
+        timezone: config.timezone,
+    });
+    activeJobs.set(config.chatId, job);
+    console.log(`[Briefing] Scheduled for ${config.chatId} at ${config.time}`);
+}
+// 브리핑 설정
+export async function setBriefingConfig(chatId, enabled, time = "08:00", city = "Seoul", timezone = "Asia/Seoul") {
+    const store = await loadStore();
+    const existingIndex = store.configs.findIndex((c) => c.chatId === chatId);
+    const config = {
+        chatId,
+        enabled,
+        time,
+        city,
+        timezone,
+    };
+    if (existingIndex >= 0) {
+        store.configs[existingIndex] = config;
+    }
+    else {
+        store.configs.push(config);
+    }
+    await saveStore(store);
+    scheduleBriefing(config);
+    return config;
+}
+// 브리핑 설정 가져오기
+export async function getBriefingConfig(chatId) {
+    const store = await loadStore();
+    return store.configs.find((c) => c.chatId === chatId) || null;
+}
+// 브리핑 비활성화
+export async function disableBriefing(chatId) {
+    const store = await loadStore();
+    const config = store.configs.find((c) => c.chatId === chatId);
+    if (config) {
+        config.enabled = false;
+        await saveStore(store);
+        const job = activeJobs.get(chatId);
+        if (job) {
+            job.stop();
+            activeJobs.delete(chatId);
+        }
+    }
+}
+// 모든 브리핑 복원 (봇 시작 시)
+export async function restoreBriefings() {
+    const store = await loadStore();
+    for (const config of store.configs) {
+        if (config.enabled) {
+            scheduleBriefing(config);
+        }
+    }
+    console.log(`[Briefing] Restored ${activeJobs.size} briefings`);
+}
+// 즉시 브리핑 실행 (테스트용)
+export async function sendBriefingNow(chatId) {
+    const config = await getBriefingConfig(chatId);
+    if (!config) {
+        // 기본 설정으로 실행
+        const defaultConfig = {
+            chatId,
+            enabled: false,
+            time: "08:00",
+            city: "Seoul",
+            timezone: "Asia/Seoul",
+        };
+        await executeBriefing(defaultConfig);
+        return true;
+    }
+    await executeBriefing(config);
+    return true;
+}
+// 모든 스케줄 정리 (graceful shutdown)
+export function cleanupBriefings() {
+    for (const [chatId, job] of activeJobs) {
+        job.stop();
+    }
+    activeJobs.clear();
+    console.log("[Briefing] Cleanup complete");
+}