casabot 1.0.0

package/skills/service/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: 시스템 서비스 등록
+description: 자동 시작 및 서비스 연동을 설정하기 위한 매뉴얼
+metadata:
+  casabot:
+    requires:
+      bins: [systemctl]
+---
+
+# 시스템 서비스 등록
+
+이 매뉴얼은 CasAbot을 systemd 서비스로 등록하고, 에이전트 자동 재시작 및 cron 스케줄링을 설정하는 방법을 설명합니다.
+
+---
+
+## 1. base 자동 시작 (systemd 사용자 서비스)
+
+CasAbot base 에이전트를 systemd 사용자 서비스로 등록하면 로그인 시 자동으로 시작됩니다.
+
+### 서비스 파일 생성
+
+```bash
+# 디렉토리 생성
+mkdir -p ~/.config/systemd/user
+
+# 서비스 파일 작성
+cat > ~/.config/systemd/user/casabot.service << 'EOF'
+[Unit]
+Description=CasAbot Base Agent
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=/usr/bin/env casabot
+Restart=on-failure
+RestartSec=10
+WorkingDirectory=%h/casabot
+Environment=NODE_ENV=production
+
+[Install]
+WantedBy=default.target
+EOF
+```
+
+### 서비스 활성화 및 시작
+
+```bash
+# 데몬 리로드
+systemctl --user daemon-reload
+
+# 서비스 활성화 (부팅 시 자동 시작)
+systemctl --user enable casabot
+
+# 서비스 시작
+systemctl --user start casabot
+```
+
+### 로그인 없이도 서비스 유지
+
+기본적으로 사용자 서비스는 로그인 세션이 없으면 종료됩니다. 항상 실행되게 하려면:
+
+```bash
+# lingering 활성화 (로그아웃 후에도 서비스 유지)
+loginctl enable-linger $(whoami)
+```
+
+## 2. 서비스 상태 확인 및 관리
+
+```bash
+# 상태 확인
+systemctl --user status casabot
+
+# 실시간 로그 보기
+journalctl --user -u casabot -f
+
+# 최근 100줄 로그
+journalctl --user -u casabot -n 100
+
+# 오늘 로그만
+journalctl --user -u casabot --since today
+
+# 서비스 재시작
+systemctl --user restart casabot
+
+# 서비스 중지
+systemctl --user stop casabot
+
+# 서비스 비활성화 (자동 시작 해제)
+systemctl --user disable casabot
+```
+
+## 3. 서브에이전트 자동 재시작
+
+podman 컨테이너의 `--restart` 옵션을 사용하여 서브에이전트가 자동으로 재시작되도록 설정합니다.
+
+### 컨테이너 생성 시 설정
+
+```bash
+# 항상 재시작 (수동 중지 전까지)
+podman run -d \
+  --restart=always \
+  --name <agent-name> \
+  --label casabot=true \
+  -v ~/casabot/workspaces/<agent-name>:/workspace \
+  -v ~/casabot/skills:/skills:ro \
+  node:20-slim sleep infinity
+```
+
+### 재시작 정책 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `no` | 재시작하지 않음 (기본값) |
+| `on-failure` | 비정상 종료 시에만 재시작 |
+| `always` | 항상 재시작 (수동 중지 제외) |
+| `unless-stopped` | 수동 중지 전까지 항상 재시작 |
+
+### 기존 컨테이너에 재시작 정책 변경
+
+```bash
+podman update --restart=always <agent-name>
+```
+
+### 서브에이전트를 systemd 서비스로 등록
+
+특정 서브에이전트를 개별 systemd 서비스로 등록할 수도 있습니다:
+
+```bash
+# podman에서 systemd 서비스 파일 자동 생성
+podman generate systemd --name <agent-name> --new > \
+  ~/.config/systemd/user/casabot-<agent-name>.service
+
+systemctl --user daemon-reload
+systemctl --user enable casabot-<agent-name>
+systemctl --user start casabot-<agent-name>
+```
+
+## 4. cron 스케줄링
+
+주기적으로 실행해야 하는 작업은 cron 또는 systemd timer를 사용합니다.
+
+### cron을 사용한 주기적 작업
+
+```bash
+# crontab 편집
+crontab -e
+```
+
+#### 예시: 모니터링 에이전트 주기적 실행
+
+```cron
+# 매 5분마다 모니터링 에이전트 실행
+*/5 * * * * podman exec monitor node /workspace/check.js >> ~/casabot/workspaces/monitor/cron.log 2>&1
+
+# 매일 자정에 정리 작업 실행
+0 0 * * * podman exec cleaner node /workspace/cleanup.js >> ~/casabot/workspaces/cleaner/cron.log 2>&1
+
+# 매주 월요일 오전 9시에 주간 보고서 생성
+0 9 * * 1 podman exec reporter node /workspace/weekly-report.js >> ~/casabot/workspaces/reporter/cron.log 2>&1
+```
+
+### systemd timer를 사용한 주기적 작업
+
+cron 대신 systemd timer를 사용하면 로그 관리가 더 편리합니다.
+
+```bash
+# 타이머 서비스 파일 생성
+cat > ~/.config/systemd/user/casabot-monitor.service << 'EOF'
+[Unit]
+Description=CasAbot Monitor Check
+
+[Service]
+Type=oneshot
+ExecStart=/usr/bin/podman exec monitor node /workspace/check.js
+EOF
+
+# 타이머 파일 생성
+cat > ~/.config/systemd/user/casabot-monitor.timer << 'EOF'
+[Unit]
+Description=CasAbot Monitor Timer
+
+[Timer]
+OnCalendar=*:0/5
+Persistent=true
+
+[Install]
+WantedBy=timers.target
+EOF
+
+# 타이머 활성화
+systemctl --user daemon-reload
+systemctl --user enable casabot-monitor.timer
+systemctl --user start casabot-monitor.timer
+```
+
+### 타이머 상태 확인
+
+```bash
+# 활성 타이머 목록
+systemctl --user list-timers
+
+# 특정 타이머 상태
+systemctl --user status casabot-monitor.timer
+```
+
+## 5. 서비스 문제 해결
+
+### 서비스가 시작되지 않을 때
+
+```bash
+# 상세 로그 확인
+journalctl --user -u casabot -n 50 --no-pager
+
+# 서비스 파일 문법 검증
+systemd-analyze verify ~/.config/systemd/user/casabot.service
+```
+
+### 서비스 파일 변경 후
+
+```bash
+# 반드시 daemon-reload 실행
+systemctl --user daemon-reload
+systemctl --user restart casabot
+```

package/src/agent/base.ts

@@ -0,0 +1,98 @@
+import type { ChatProvider } from "../providers/base.js";
+import type { Message, Skill, ConversationHistory } from "../config/types.js";
+import { TERMINAL_TOOL, executeCommand } from "./tools.js";
+import { appendMessage } from "../history/store.js";
+import { formatSkillsForPrompt } from "../skills/loader.js";
+import { CASABOT_HOME } from "../config/manager.js";
+
+const MAX_ITERATIONS = 20;
+
+export function buildSystemPrompt(skills: Skill[]): string {
+  const skillList = formatSkillsForPrompt(skills);
+
+  return `당신은 CasAbot의 base 에이전트입니다. Cassiopeia A — 초신성 폭발과 같이 모든 것을 자유롭게 창조합니다.
+
+## 핵심 원칙
+1. 당신은 오케스트레이터입니다. 실제 작업을 직접 수행하지 마세요.
+2. 스킬 문서를 우선적으로 참조하세요. 필요한 스킬의 SKILL.md를 읽고 지침을 따르세요.
+3. 적합한 서브에이전트가 있으면 위임하고, 없으면 새로 만들어서 위임하세요.
+4. 오케스트레이션(에이전트 생성/위임/관리)만 직접 수행하세요.
+
+## 사용 가능한 도구
+- \`run_command\`: 터미널 명령어를 실행합니다. 이 도구 하나로 스킬을 읽고, 서브에이전트를 관리하고, 모든 오케스트레이션을 수행합니다.
+
+## 작업 순서
+1. 사용자의 요청을 분석합니다.
+2. 관련 스킬 문서를 읽습니다: \`cat <스킬경로>\`
+3. 스킬 지침에 따라 서브에이전트를 생성하거나 기존 에이전트에 위임합니다.
+4. 결과를 수집하여 사용자에게 보고합니다.
+
+## CasAbot 디렉토리 구조
+- 홈: ${CASABOT_HOME}
+- 스킬: ${CASABOT_HOME}/skills/
+- 워크스페이스: ${CASABOT_HOME}/workspaces/
+- 대화 기록: ${CASABOT_HOME}/history/
+- 기록(메모): ${CASABOT_HOME}/memory/
+- 설정: ${CASABOT_HOME}/casabot.json
+
+## ${skillList}
+`;
+}
+
+export async function* runAgent(
+  provider: ChatProvider,
+  userMessage: string,
+  conversation: ConversationHistory,
+  skills: Skill[],
+): AsyncGenerator<Message> {
+  const systemPrompt = buildSystemPrompt(skills);
+
+  const userMsg: Message = { role: "user", content: userMessage };
+  await appendMessage(conversation, userMsg);
+
+  const tools = [TERMINAL_TOOL];
+
+  for (let i = 0; i < MAX_ITERATIONS; i++) {
+    const messagesWithSystem: Message[] = [
+      { role: "system", content: systemPrompt },
+      ...conversation.messages,
+    ];
+    const assistantMsg = await provider.chat(messagesWithSystem, tools);
+    await appendMessage(conversation, assistantMsg);
+    yield assistantMsg;
+
+    if (!assistantMsg.toolCalls?.length) {
+      return;
+    }
+
+    for (const toolCall of assistantMsg.toolCalls) {
+      let result: string;
+
+      if (toolCall.name === "run_command") {
+        try {
+          const args = JSON.parse(toolCall.arguments) as { command: string };
+          result = await executeCommand(args.command);
+        } catch {
+          result = `오류: 도구 인자 파싱 실패 — ${toolCall.arguments}`;
+        }
+      } else {
+        result = `알 수 없는 도구: ${toolCall.name}`;
+      }
+
+      const toolMsg: Message = {
+        role: "tool",
+        content: result,
+        toolCallId: toolCall.id,
+      };
+      await appendMessage(conversation, toolMsg);
+      yield toolMsg;
+    }
+  }
+
+  const limitMsg: Message = {
+    role: "assistant",
+    content: "⚠️ 최대 반복 횟수에 도달했습니다. 요청을 다시 시도해 주세요.",
+  };
+  await appendMessage(conversation, limitMsg);
+  yield limitMsg;
+}

package/src/agent/tools.ts

@@ -0,0 +1,40 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import type { ToolDefinition } from "../providers/base.js";
+
+const execAsync = promisify(exec);
+
+const MAX_BUFFER = 10 * 1024 * 1024;
+const TIMEOUT_MS = 60_000;
+
+export const TERMINAL_TOOL: ToolDefinition = {
+  name: "run_command",
+  description:
+    "터미널에서 명령어를 실행합니다. 스킬 문서를 읽거나, 서브에이전트를 관리하거나, 시스템 작업을 수행할 때 사용합니다.",
+  parameters: {
+    type: "object",
+    properties: {
+      command: {
+        type: "string",
+        description: "실행할 터미널 명령어",
+      },
+    },
+    required: ["command"],
+  },
+};
+
+export async function executeCommand(command: string): Promise<string> {
+  try {
+    const { stdout, stderr } = await execAsync(command, {
+      timeout: TIMEOUT_MS,
+      maxBuffer: MAX_BUFFER,
+      shell: "/bin/bash",
+    });
+    const output = [stdout, stderr].filter(Boolean).join("\n");
+    return output || "(명령어가 출력 없이 완료되었습니다)";
+  } catch (err: unknown) {
+    const error = err as { stdout?: string; stderr?: string; message: string };
+    const parts = [error.stdout, error.stderr, error.message].filter(Boolean);
+    return `오류 발생:\n${parts.join("\n")}`;
+  }
+}

package/src/cli/index.ts

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { loadConfig, saveConfig, getDefaultConfig, ensureDirectories } from "../config/manager.js";
+import { createProvider } from "../providers/index.js";
+import { loadSkills } from "../skills/loader.js";
+import { createConversation } from "../history/store.js";
+import { startTUI } from "../tui/app.js";
+import { setupWizard } from "./setup.js";
+
+const program = new Command();
+
+program
+  .name("casabot")
+  .description("CasAbot — 스킬 중심 멀티에이전트 오케스트레이터")
+  .version("1.0.0");
+
+program
+  .command("setup")
+  .description("최초 설정 (공급자, 모델 등 전체 설정)")
+  .action(async () => {
+    try {
+      await setupWizard();
+    } catch (err: unknown) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`❌ 설정 중 오류 발생: ${msg}`);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("reset")
+  .description("초기 설정으로 되돌리기")
+  .action(async () => {
+    try {
+      await saveConfig(getDefaultConfig());
+      console.log("✅ 설정이 초기화되었습니다.");
+      console.log("'casabot setup' 명령어로 다시 설정하세요.");
+    } catch (err: unknown) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`❌ 초기화 중 오류 발생: ${msg}`);
+      process.exit(1);
+    }
+  });
+
+program
+  .action(async () => {
+    try {
+      await ensureDirectories();
+
+      const config = await loadConfig();
+
+      if (!config.activeProvider || config.providers.length === 0) {
+        console.log("⚠️  공급자가 설정되지 않았습니다.");
+        console.log("'casabot setup' 명령어로 먼저 설정하세요.\n");
+        process.exit(1);
+      }
+
+      const providerConfig = config.providers.find(
+        (p) => p.name === config.activeProvider,
+      );
+
+      if (!providerConfig) {
+        console.error(`❌ 활성 공급자 '${config.activeProvider}'를 찾을 수 없습니다.`);
+        console.error("'casabot setup' 명령어로 다시 설정하세요.");
+        process.exit(1);
+      }
+
+      const provider = createProvider(providerConfig);
+      const skills = await loadSkills();
+      const conversation = createConversation();
+
+      startTUI(provider, conversation, skills);
+    } catch (err: unknown) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`❌ 시작 중 오류 발생: ${msg}`);
+      process.exit(1);
+    }
+  });
+
+program.parse();