choavis-agent 1.4.0 → 1.4.2

package/.env.example

@@ -23,8 +23,9 @@ SLACK_APP_TOKEN=xapp-your-app-token
 # 프로젝트 레지스트리 (JSON) - Slack에서 "프로젝트: 이름"으로 전환 가능
 # AGENT_PROJECTS={"my-project":"/path/to/project"}
 
-# 허용된 Slack 사용자 ID (쉼표 구분, 미설정 시 모든 사용자 허용)
-# ALLOWED_SLACK_USERS=U12345678,U87654321
+# 허용된 Slack 사용자 ID (쉼표 구분) — 반드시 설정해야 함
+# 미설정 시 아무도 사용할 수 없음 (전체 거부)
+ALLOWED_SLACK_USERS=U12345678,U87654321
 
 # 동시 Claude 프로세스 제한 (기본값: 5)
 # MAX_CONCURRENT_AGENTS=5

package/README.md

@@ -1,271 +1,186 @@
 # Choavis Agent
 
-**언제 어디서든, 내 코딩 에이전트를 호출한다.**
+**Slack에서 Claude Code를 제어하는 로컬 에이전트.**
 
-Choavis Agent는 로컬 PC에 설치된 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)를 Slack을 통해 제어하는 개인 AI 코딩 에이전트입니다.
+[![npm version](https://img.shields.io/npm/v/choavis-agent)](https://www.npmjs.com/package/choavis-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
 
-카페에서 커피를 마시며 스마트폰으로 Slack 메시지 하나를 보내면, 집에 있는 내 개발 머신의 Claude Code가 코드를 작성하고, 테스트를 실행하고, Git에 커밋합니다. 출퇴근 지하철에서 버그 리포트를 보고, Slack에서 바로 수정을 지시할 수 있습니다.
+Choavis Agent는 로컬 [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)를 Slack과 연결합니다. 터미널 앞에 앉아 있지 않아도 Slack 메시지 하나로 로컬 머신에서 개발 작업을 수행할 수 있습니다.
 
-> [OpenClaw](https://github.com/anthropics/claude-code)의 개념에서 영감을 받았습니다.
-> 외부 서버에 코드를 올리는 보안 리스크 없이, **내 로컬 머신에서 직접 실행**되는 구조로 설계했습니다.
+<!-- 데모 GIF가 있다면 여기에 추가 -->
+<!-- ![demo](docs/assets/demo.gif) -->
 
----
-
-## 왜 Choavis Agent인가?
-
-### 문제
-- Claude Code는 강력하지만, **터미널 앞에 앉아있어야** 사용할 수 있다
-- 클라우드 기반 코딩 에이전트는 편리하지만, **내 코드가 외부 서버를 거친다**
-- 팀원들과 AI 에이전트를 공유하려면 별도 인프라가 필요하다
-
-### 해결
-- Slack이 리모컨, 내 PC가 실행 머신. **코드는 내 로컬에서만 돌아간다**
-- `npm install` 한 번으로 설치, 대화형 셋업으로 3분 만에 시작
-- Slack만 있으면 스마트폰, 태블릿, 어디서든 접근 가능
-
----
-
-## 이런 것들이 가능합니다
-
-### 코드 작성 & 수정
-> "UserService에 이메일 중복 체크 로직 추가해줘"
-
-슬랙 메시지 하나로 코드 수정, 파일 생성, 리팩토링이 실행됩니다.
-
-### 버그 분석 & 수정
-> "로그인 API에서 500 에러 나는데, AuthController 확인해봐"
-
-에이전트가 코드를 읽고, 원인을 분석하고, 수정안을 제시하거나 직접 고칩니다.
-
-### Git & 배포
-> "지금까지 변경사항 커밋하고 PR 만들어줘"
-
-Git add, commit, push, PR 생성까지 한 번에 처리합니다.
-
-### 코드 리뷰 & 분석
-> "src/services/ 디렉토리 구조 분석해줘"
-
-프로젝트 구조를 파악하고, 코드 품질을 분석하고, 개선안을 제안합니다.
-
-### 업무 자동화
-> "테스트 돌려서 결과 알려줘"
-
-반복 작업을 에이전트에게 위임하여 개발 워크플로우를 자동화합니다.
-
-### 멀티 프로젝트
-> "프로젝트: mss-backend" → "회원 API 엔드포인트 목록 보여줘"
-
-여러 프로젝트를 등록하고 Slack에서 자유롭게 전환하며 작업합니다.
+> Claude Code CLI가 할 수 있는 건 전부 Slack에서 가능합니다. 터미널로 할 수 있는 모든 것을 Slack으로 제어할 수 있습니다.
 
 ---
 
-## 활용 시나리오
-
-**출퇴근 중**
-지하철에서 Jira 티켓을 보고, Slack으로 "JIRA-123 이슈 수정해줘"라고 보내면 집에 있는 PC가 코드를 수정하고 PR을 올립니다.
-
-**카페에서**
-노트북 없이 스마트폰만으로 "어제 작업한 feature 브랜치 테스트 돌려봐" → 테스트 결과를 Slack으로 받습니다.
+## 빠른 시작
 
-**재택 중**
-업무용 PC가 회사에 있어도, Slack으로 회사 PC의 Claude Code를 제어하여 개발합니다.
+**사전 준비:** Node.js 20+, [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
 
-**팀 공유**
-팀원들의 Slack ID를 등록하면, 하나의 에이전트를 팀이 함께 사용할 수 있습니다. 각자의 스레드에서 독립적인 세션으로 작업합니다.
+```bash
+# 설치
+npm install -g choavis-agent
 
----
+# 대화형 설정 (Slack 앱 생성 안내 + .env 생성)
+choavis-agent onboard
 
-## 주요 기능
+# 실행
+choavis-agent start
+```
 
-| 기능 | 설명 |
-|------|------|
-| 대화형 코딩 | 자연어로 코드 작성, 수정, 리팩토링 지시 |
-| 스레드 세션 | Slack 스레드별 독립 세션, 컨텍스트 유지 |
-| 스트리밍 응답 | 실시간 진행 상황 표시 |
-| 도구 승인 | Slack 버튼으로 도구 사용 승인/거부 (PreToolUse Hook 기반) |
-| 에러 자동 복구 | 컨텍스트 오버플로우 자동 압축, 세션 오류 자동 리셋 |
-| 사용량 추적 | 토큰 사용량, 비용 추정, 사용자별 통계 |
-| 모델 선택 | opus, sonnet, haiku 또는 직접 모델명 입력 |
+> **Slack 앱 설정이 처음이라면?** → [Slack 앱 설정 가이드](docs/slack-app-setup.md)
 
 ---
 
-## 사전 준비
+## 동작 원리
 
-1. **Node.js 20 이상** - [다운로드](https://nodejs.org/)
-2. **Claude Code CLI** - [설치 가이드](https://docs.anthropic.com/en/docs/claude-code)
-   ```bash
-   npm install -g @anthropic-ai/claude-code
-   ```
-3. **Slack 앱** - 아래 가이드를 따라 생성
+Choavis Agent는 Claude Code를 subprocess로 실행하고, Slack을 UI로 연결하는 브릿지입니다. Slack 스레드 하나가 Claude Code 세션 하나에 대응하며, 각 스레드는 독립적인 컨텍스트를 유지합니다.
 
 ---
 
-## 빠른 시작
+## 활용 예시
 
-```bash
-# 1. 설치
-npm install -g choavis-agent
+### 언제 어디서나 코딩
 
-# 2. 설정 (대화형 온보딩)
-choavis-agent init
+지하철, 카페, 침대 — 스마트폰에 Slack만 있으면 됩니다.
 
-# 3. 실행
-choavis-agent start
 ```
-
-설정을 변경하고 싶다면:
-```bash
-choavis-agent config
+나: "AuthController에 JWT 리프레시 토큰 로직 추가해줘"
+나: "테스트 돌려보고 실패하면 고쳐줘"
+나: "커밋하고 PR 만들어줘"
 ```
 
----
-
-## Slack 앱 설정 가이드
+Claude Code를 subprocess로 호출하기 때문에 프로젝트에 정의된 **CLAUDE.md, sub agent, skill**을 그대로 활용합니다. 터미널에서 직접 `claude`를 실행하는 것과 동일한 환경입니다.
 
-### 1. 앱 생성
-1. [Slack API](https://api.slack.com/apps)에서 **Create New App** → **From scratch**
-2. 앱 이름 입력 (예: `Choavis Agent`), 워크스페이스 선택
+### 여러 프로젝트를 동시에
 
-### 2. Socket Mode 활성화
-1. **Settings > Socket Mode** → Enable Socket Mode
-2. App-Level Token 생성 (이름: `socket`, Scope: `connections:write`)
-3. 생성된 토큰 복사 (`xapp-...`) → 온보딩에서 입력
+`$project` 커맨드로 프로젝트를 전환하면서 작업할 수 있습니다.
 
-### 3. 봇 권한 설정
-**Features > OAuth & Permissions > Bot Token Scopes**에 추가:
-
-| Scope | 용도 |
-|-------|------|
-| `app_mentions:read` | @멘션 감지 |
-| `channels:history` | 채널 메시지 읽기 |
-| `chat:write` | 메시지 전송 |
-| `files:write` | 코드 스니펫 업로드 |
-| `groups:history` | 비공개 채널 메시지 읽기 |
-| `im:history` | DM 메시지 읽기 |
-| `im:write` | DM 전송 |
-| `reactions:read` | 리액션 읽기 |
-| `reactions:write` | 리액션 추가/제거 |
+```
+나: "$project api"
+나: "주문 API에 페이지네이션 추가해줘"
 
-### 4. 이벤트 구독
-**Features > Event Subscriptions** → Enable Events
+나: "$project frontend"
+나: "주문 목록 페이지에 무한 스크롤 적용해줘"
+```
 
-**Subscribe to bot events:**
-- `app_mention` - 채널에서 @멘션 시
-- `message.channels` - 채널 메시지
-- `message.groups` - 비공개 채널 메시지
-- `message.im` - DM 메시지
+### 개발 외 작업
 
-### 5. 앱 설치
-**Settings > Install App** → Install to Workspace → 권한 승인
+터미널로 할 수 있는 건 뭐든 가능합니다.
 
-Bot User OAuth Token 복사 (`xoxb-...`) → 온보딩에서 입력
+```
+나: "Downloads 폴더에 있는 PDF 파일들 날짜별로 정리해줘"
+나: "지난주 회의록 초안 작성해줘, 프로젝트 커밋 로그 참고해서"
+나: "afplay로 ~/Music에 있는 mp3 틀어줘"
+```
 
 ---
 
-## 명령어
+## 기능
 
-대부분의 작업은 자연어로 요청하면 에이전트가 알아서 처리합니다.
-유일한 특수 명령어는 실행 중인 작업을 즉시 중단하는 `$중지`입니다.
+| 기능 | 설명 |
+|---|---|
+| **실시간 스트리밍** | Claude가 작업하는 동안 Slack 메시지가 실시간으로 업데이트 |
+| **스레드 = 세션** | 각 Slack 스레드가 독립적인 Claude Code 세션을 유지 |
+| **멀티 프로젝트** | 여러 저장소를 등록하고 `$project` 커맨드로 전환 |
+| **14개 내장 커맨드** | 중지, 재개, 압축, 모델 전환, 권한 모드 등 |
+| **도구 승인** | `plan`/`acceptEdits` 모드에서 Slack 버튼으로 도구 사용 승인/거부 |
+| **사용량 추적** | 사용자별 토큰 소비량 및 비용을 일/주/월 단위로 집계 |
+| **영구 메모리** | `$memory`로 저장한 메모가 이후 모든 대화에 자동 주입 |
+| **자동 컨텍스트 압축** | 컨텍스트 창이 가득 차면 자동으로 압축 후 계속 |
 
-| 명령어 | 별칭 | 설명 |
-|--------|------|------|
-| `$중지` | `$멈춰`, `$그만`, `$stop` | 현재 처리 중인 작업 즉시 중단 |
+---
 
-그 외 요청은 자연어로 보내면 됩니다:
-- "상태 알려줘" → 에이전트가 현재 상태 안내
-- "세션 초기화해줘" → 새 대화 시작 (또는 새 스레드 열기)
-- "컨텍스트 압축해줘" → 에이전트가 자동 압축
-- "사용량 보여줘" → 토큰 사용량 안내
+## 커맨드
+
+자연어로 요청하되, 에이전트를 직접 제어할 때는 커맨드를 사용합니다.
+
+| 커맨드 | 설명 |
+|---|---|
+| `$stop` | 현재 작업 즉시 중단 |
+| `$new` | 세션 초기화 (새 대화 시작) |
+| `$compact` | 대화 컨텍스트 수동 압축 |
+| `$resume <id>` | 세션 ID로 기존 세션 재연결 |
+| `$model [이름]` | 모델 확인/변경 (`sonnet`, `opus`, `haiku`) |
+| `$status` | 현재 설정 및 에이전트 상태 |
+| `$sessions` | 모든 활성 세션 목록 |
+| `$session-info` | 현재 스레드의 세션 정보 |
+| `$usage [범위]` | 사용량 대시보드 (`me`, `week`, `month`) |
+| `$project <이름>` | 작업 디렉토리 전환 |
+| `$inject <id> <msg>` | 특정 세션에 메시지 주입 |
+| `$memory <내용>` | 영구 메모리에 메모 저장 |
+| `$permission [모드]` | 권한 모드 변경 (`bypass`, `plan`, `accept`) |
+| `$help` | 도움말 |
 
 ---
 
-## 설정 옵션
+## 설정
 
-`choavis-agent config`로 변경하거나, `.env` 파일을 직접 수정할 수 있습니다.
+`choavis-agent init`으로 `.env`를 생성하거나, 직접 환경변수를 설정합니다.
 
-| 환경변수 | 필수 | 기본값 | 설명 |
-|----------|------|--------|------|
-| `SLACK_BOT_TOKEN` | O | - | Slack Bot OAuth Token (`xoxb-...`) |
-| `SLACK_APP_TOKEN` | O | - | Slack App-Level Token (`xapp-...`) |
-| `CLAUDE_MODEL` | - | *(Claude Code 기본값)* | Claude 모델 (opus, sonnet, haiku 또는 전체 모델명) |
-| `AGENT_PERMISSION_MODE` | - | `plan` | Claude Code 권한 모드 |
-| `ALLOWED_SLACK_USERS` | - | *(전체 허용)* | 허용 사용자 ID (쉼표 구분) |
-| `AGENT_WORK_DIR` | - | 현재 디렉토리 | Claude Code 작업 디렉토리 |
-| `CLAUDE_PATH` | - | `claude` | Claude CLI 경로 |
-| `AGENT_PROJECTS` | - | `{}` | 프로젝트 레지스트리 (JSON) |
-| `MAX_CONCURRENT_AGENTS` | - | `5` | 동시 실행 가능한 Claude 프로세스 수 |
-| `SESSION_DAILY_RESET_HOUR` | - | `4` | 매일 세션 자동 리셋 시각 (0-23) |
-| `SESSION_IDLE_RESET_MINUTES` | - | `120` | 유휴 세션 자동 리셋 시간 (분) |
+| 변수 | 필수 | 기본값 | 설명 |
+|---|---|---|---|
+| `SLACK_BOT_TOKEN` | ✅ | — | Bot OAuth Token (`xoxb-...`) |
+| `SLACK_APP_TOKEN` | ✅ | — | App-Level Token (`xapp-...`) |
+| `ALLOWED_SLACK_USERS` | ✅ | — | 허용 사용자 ID (쉼표 구분) |
+| `CLAUDE_MODEL` | — | CLI 기본값 | 모델 (`sonnet`, `opus`, `haiku` 또는 전체 ID) |
+| `AGENT_PERMISSION_MODE` | — | `bypassPermissions` | 권한 모드 |
+| `AGENT_WORK_DIR` | — | 현재 디렉토리 | 기본 작업 디렉토리 |
+| `AGENT_PROJECTS` | — | `{}` | 프로젝트 맵 (JSON). 예: `{"api":"/home/user/api"}` |
+| `MAX_CONCURRENT_AGENTS` | — | `5` | 최대 동시 프로세스 수 |
 
----
+<details>
+<summary>전체 환경변수 목록</summary>
 
-## 아키텍처
+| 변수 | 기본값 | 설명 |
+|---|---|---|
+| `CLAUDE_PATH` | `claude` | Claude Code CLI 경로 |
+| `SESSION_DAILY_RESET_HOUR` | `4` | 세션 자동 리셋 시각 (0–23) |
+| `SESSION_IDLE_RESET_MINUTES` | `120` | 유휴 세션 리셋 시간 (분) |
+| `SESSION_STORE_PATH` | `data/sessions.json` | 세션 데이터 저장 경로 |
+| `USAGE_DATA_DIR` | `data/usage` | 사용량 데이터 디렉토리 |
+| `MEMORY_DATA_DIR` | `.memory` | 메모리 파일 디렉토리 |
 
-```
-┌─────────────┐     Socket Mode     ┌──────────────────┐
-│  Slack App  │◄───────────────────►│  Choavis Agent   │
-│  (UI 역할)  │                     │  (Node.js)       │
-│             │  승인/거부 버튼 클릭  ├──────────────────┤
-└─────────────┘                     │  Command Router  │
-                                    │  Session Manager │
-      사용자가                       │  Queue System    │
-      Slack에서                      │  Memory System   │
-      메시지 전송                     │  Usage Tracker   │
-                                    │  Approval Server │ ← localhost HTTP
-                                    └────────┬─────────┘
-                                             │ subprocess
-                                    ┌────────▼─────────┐
-                                    │   Claude Code    │
-                                    │   CLI (로컬)      │
-                                    │                  │
-                                    │  코드 읽기/쓰기    │
-                                    │  터미널 명령 실행   │
-                                    │  Git 작업         │
-                                    │  ... 무엇이든     │
-                                    ├──────────────────┤
-                                    │  PreToolUse Hook │
-                                    │  → 승인 서버 요청  │
-                                    └──────────────────┘
-```
+</details>
 
-**핵심 설계 원칙:**
-- **코드는 내 로컬에서만** - 외부 서버 없음, Claude Code CLI가 로컬에서 직접 실행
-- **Slack은 리모컨** - 메시지를 전달하고 결과를 보여주는 UI 역할
-- **스레드 = 세션** - 각 Slack 스레드가 독립적인 Claude Code 세션
+---
 
-### 도구 승인 흐름
+## 도구 승인
 
-`bypassPermissions`가 아닌 퍼미션 모드에서는 Claude Code가 도구(Bash, Write 등)를 사용하기 전에 Slack 버튼으로 승인을 요청합니다.
+`AGENT_PERMISSION_MODE`가 `plan` 또는 `acceptEdits`일 때, Claude Code는 도구 사용 전에 Slack 버튼으로 승인을 요청합니다.
 
 ```
-1. Claude가 도구 사용 시도
-2. PreToolUse Hook 발동 → hook 스크립트 실행
-3. hook → localhost 승인 서버에 HTTP 요청 (long-poll)
-4. 승인 서버 → Slack 스레드에 [✅ 승인] [❌ 거부] 버튼 전송
-5. 사용자가 버튼 클릭
-6. 승인 서버 → hook에 결과 반환
-7. Claude 계속 실행 또는 도구 스킵
+🔧 도구 사용 승인 요청
+도구: Bash
+내용: git commit -m "fix: null 체크 추가"
+
+[승인]  [항상 허용]  [거부]
 ```
 
-- Read, Glob, Grep 등 읽기 전용 도구는 자동 허용 (승인 불필요)
-- 2분 내 응답 없으면 자동 거부 (안전 기본값)
-- 승인 서버는 `127.0.0.1`에만 바인딩 (외부 접근 불가)
+- 읽기 전용 도구(Read, Glob, Grep)는 자동 허용
+- 2분 내 응답 없으면 자동 거부
+- 승인 서버는 `127.0.0.1`에만 바인딩 — 외부 접근 불가
 
 ---
 
 ## 개발
 
 ```bash
-# 개발 모드 (tsx로 즉시 실행)
-npm run dev
-
-# 빌드
-npm run build
-
-# 테스트
-npm test
+git clone https://github.com/musinsa/choavis-agent.git
+cd choavis-agent
+npm install
+cp .env.example .env    # 환경변수 설정
+
+npm run dev              # 개발 모드 (tsx)
+npm run build            # 빌드
+npm test                 # 테스트
 ```
 
+기여를 환영합니다. 큰 PR 전에 이슈를 먼저 열어주세요.
+
 ---
 
 ## 라이선스

package/dist/agent/adapters/claude.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Adapter
+ *
+ * Claude Code의 StreamEvent를 통합 SessionEvent로 변환하는 어댑터.
+ * runner.ts의 raw NDJSON 스트림을 받아 protocol.ts의 SessionEvent로 emit.
+ */
+import type { StreamEvent } from '../runner.js';
+import type { SessionEvent } from '../protocol.js';
+/**
+ * Claude Code의 StreamEvent async generator를 SessionEvent로 변환
+ */
+export declare function adaptClaude(rawStream: AsyncGenerator<StreamEvent>): AsyncGenerator<SessionEvent>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agent/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,gBAAgB,CAAC;AAiEjF;;GAEG;AACH,wBAAuB,WAAW,CAChC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,cAAc,CAAC,YAAY,CAAC,CA2J9B"}

package/dist/agent/adapters/claude.js

@@ -0,0 +1,199 @@
+/**
+ * Claude Adapter
+ *
+ * Claude Code의 StreamEvent를 통합 SessionEvent로 변환하는 어댑터.
+ * runner.ts의 raw NDJSON 스트림을 받아 protocol.ts의 SessionEvent로 emit.
+ */
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('adapter:claude');
+/** 파일 관련 도구에서 경로와 액션을 추출 */
+function extractFileInfo(toolName, toolInput) {
+    const filePath = toolInput.file_path ||
+        toolInput.notebook_path ||
+        null;
+    if (!filePath)
+        return null;
+    const actionMap = {
+        Read: 'read',
+        Write: 'write',
+        Edit: 'edit',
+        MultiEdit: 'edit',
+        NotebookEdit: 'edit',
+    };
+    const action = actionMap[toolName];
+    if (!action)
+        return null;
+    return { path: filePath, action };
+}
+/** tool use 이벤트에서 도구 이름과 입력을 추출 (여러 형식 지원) */
+function extractToolUse(raw) {
+    // 형식 1: type === 'tool_use' (tool_name/tool_input)
+    if (raw.type === 'tool_use') {
+        const toolName = raw.tool_name || raw.name || 'unknown';
+        const toolInput = (raw.tool_input || raw.input || {});
+        return { toolName, toolInput };
+    }
+    // 형식 2: content_block_start + content_block.type === 'tool_use'
+    if (raw.type === 'content_block_start') {
+        const block = raw.content_block;
+        if (block?.type === 'tool_use' && block.name) {
+            return {
+                toolName: block.name,
+                toolInput: (block.input || {}),
+            };
+        }
+    }
+    return null;
+}
+/** 에러 이벤트에서 텍스트 메시지를 추출 */
+function extractErrorText(event) {
+    const content = event.message?.content;
+    if (!Array.isArray(content))
+        return 'Unknown error';
+    return content
+        .filter((c) => c.type === 'text')
+        .map((c) => c.text || '')
+        .join('');
+}
+/**
+ * Claude Code의 StreamEvent async generator를 SessionEvent로 변환
+ */
+export async function* adaptClaude(rawStream) {
+    let didEmitTurnStart = false;
+    for await (const raw of rawStream) {
+        const ts = Date.now();
+        // system/init → start
+        if (raw.type === 'system' && raw.subtype === 'init') {
+            yield {
+                type: 'start',
+                timestamp: ts,
+                sessionId: raw.session_id,
+                _raw: raw,
+            };
+            continue;
+        }
+        // assistant → turn-start (첫 번째만) + text(replace: true)
+        if (raw.type === 'assistant') {
+            if (!didEmitTurnStart) {
+                didEmitTurnStart = true;
+                yield { type: 'turn-start', timestamp: ts };
+            }
+            const msg = raw.message;
+            if (msg?.content && Array.isArray(msg.content)) {
+                const fullText = msg.content
+                    .filter((block) => block.type === 'text' && block.text)
+                    .map((block) => block.text)
+                    .join('');
+                if (fullText) {
+                    yield {
+                        type: 'text',
+                        timestamp: ts,
+                        text: { content: fullText, replace: true },
+                        _raw: raw,
+                    };
+                }
+                // assistant 메시지 content에서 tool_use 블록도 추출
+                for (const block of msg.content) {
+                    if (block.type === 'tool_use' && block.name) {
+                        const toolInput = (block.input || {});
+                        yield {
+                            type: 'tool-call-start',
+                            timestamp: ts,
+                            tool: { toolName: block.name, toolInput },
+                        };
+                        const fileInfo = extractFileInfo(block.name, toolInput);
+                        if (fileInfo) {
+                            yield { type: 'file', timestamp: ts, file: fileInfo };
+                        }
+                    }
+                }
+            }
+            continue;
+        }
+        // content_block_delta → text(replace: false)
+        if (raw.type === 'content_block_delta' && raw.delta?.text) {
+            if (!didEmitTurnStart) {
+                didEmitTurnStart = true;
+                yield { type: 'turn-start', timestamp: ts };
+            }
+            yield {
+                type: 'text',
+                timestamp: ts,
+                text: { content: raw.delta.text, replace: false },
+                _raw: raw,
+            };
+            continue;
+        }
+        // tool_use → tool-call-start + optional file
+        // Claude Code stream-json은 여러 형식으로 tool use를 보낼 수 있음:
+        // 1. type: 'tool_use' (tool_name/tool_input 또는 name/input)
+        // 2. type: 'content_block_start' + content_block.type === 'tool_use'
+        {
+            const toolInfo = extractToolUse(raw);
+            if (toolInfo) {
+                yield {
+                    type: 'tool-call-start',
+                    timestamp: ts,
+                    tool: toolInfo,
+                    _raw: raw,
+                };
+                // 파일 관련 도구면 file 이벤트도 emit
+                const fileInfo = extractFileInfo(toolInfo.toolName, toolInfo.toolInput);
+                if (fileInfo) {
+                    yield {
+                        type: 'file',
+                        timestamp: ts,
+                        file: fileInfo,
+                    };
+                }
+                continue;
+            }
+        }
+        // result → turn-end
+        if (raw.type === 'result') {
+            const turnEnd = {
+                type: 'turn-end',
+                timestamp: ts,
+                sessionId: raw.session_id,
+                turn: {
+                    result: raw.result,
+                },
+                _raw: raw,
+            };
+            if (raw.usage) {
+                turnEnd.turn.usage = {
+                    inputTokens: raw.usage.input_tokens || 0,
+                    outputTokens: raw.usage.output_tokens || 0,
+                    model: raw.model,
+                };
+            }
+            yield turnEnd;
+            // 다음 턴을 위해 리셋
+            didEmitTurnStart = false;
+            continue;
+        }
+        // error → service
+        if (raw.type === 'error') {
+            const message = extractErrorText(raw);
+            const errorType = raw.errorType;
+            const retryable = errorType === 'transient';
+            yield {
+                type: 'service',
+                timestamp: ts,
+                service: {
+                    message,
+                    severity: 'error',
+                    errorType,
+                    retryable,
+                },
+                _raw: raw,
+            };
+            continue;
+        }
+        // 그 외 이벤트 디버그 로그 (tool_use 관련 이벤트를 놓치고 있는지 확인용)
+        if (raw.type !== 'content_block_delta' && raw.type !== 'content_block_stop') {
+            log.info('unhandled event', { type: raw.type, subtype: raw.subtype });
+        }
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/agent/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/agent/adapters/claude.ts"],"names":[],"mappings":"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"}