choavis-agent 1.0.0

package/.env.example

@@ -0,0 +1,37 @@
+# Slack Bot Token (xoxb-...)
+SLACK_BOT_TOKEN=xoxb-your-bot-token
+
+# Slack App-Level Token (xapp-...) - Socket Mode에 필요
+SLACK_APP_TOKEN=xapp-your-app-token
+
+# Claude 모델 (비워두면 Claude Code 사용자 설정을 따라감)
+# opus, sonnet, haiku 또는 전체 모델명(claude-opus-4-1-20250414 등) 입력 가능
+# CLAUDE_MODEL=
+
+# Claude Code 권한 모드 (기본값: plan)
+# plan: 작업 전 사용자에게 확인 요청
+# default: 기본 권한
+# bypassPermissions: 모든 도구 자동 승인
+# AGENT_PERMISSION_MODE=plan
+
+# Claude Code가 실행될 작업 디렉토리 (기본값: 현재 디렉토리)
+# AGENT_WORK_DIR=/path/to/workspace
+
+# Claude CLI 경로 (기본값: claude)
+# CLAUDE_PATH=claude
+
+# 프로젝트 레지스트리 (JSON) - Slack에서 "프로젝트: 이름"으로 전환 가능
+# AGENT_PROJECTS={"my-project":"/path/to/project"}
+
+# 허용된 Slack 사용자 ID (쉼표 구분, 미설정 시 모든 사용자 허용)
+# ALLOWED_SLACK_USERS=U12345678,U87654321
+
+# 동시 Claude 프로세스 제한 (기본값: 5)
+# MAX_CONCURRENT_AGENTS=5
+
+# 세션 자동 리셋
+# SESSION_DAILY_RESET_HOUR=4
+# SESSION_IDLE_RESET_MINUTES=120
+
+# 사용량 데이터 경로
+# USAGE_DATA_DIR=./data/usage

package/README.md

@@ -0,0 +1,258 @@
+# Choavis Agent
+
+**언제 어디서든, 내 코딩 에이전트를 호출한다.**
+
+Choavis Agent는 로컬 PC에 설치된 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)를 Slack을 통해 제어하는 개인 AI 코딩 에이전트입니다.
+
+카페에서 커피를 마시며 스마트폰으로 Slack 메시지 하나를 보내면, 집에 있는 내 개발 머신의 Claude Code가 코드를 작성하고, 테스트를 실행하고, Git에 커밋합니다. 출퇴근 지하철에서 버그 리포트를 보고, Slack에서 바로 수정을 지시할 수 있습니다.
+
+> [OpenClaw](https://github.com/anthropics/claude-code)의 개념에서 영감을 받았습니다.
+> 외부 서버에 코드를 올리는 보안 리스크 없이, **내 로컬 머신에서 직접 실행**되는 구조로 설계했습니다.
+
+---
+
+## 왜 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에서 자유롭게 전환하며 작업합니다.
+
+---
+
+## 활용 시나리오
+
+**출퇴근 중**
+지하철에서 Jira 티켓을 보고, Slack으로 "JIRA-123 이슈 수정해줘"라고 보내면 집에 있는 PC가 코드를 수정하고 PR을 올립니다.
+
+**카페에서**
+노트북 없이 스마트폰만으로 "어제 작업한 feature 브랜치 테스트 돌려봐" → 테스트 결과를 Slack으로 받습니다.
+
+**재택 중**
+업무용 PC가 회사에 있어도, Slack으로 회사 PC의 Claude Code를 제어하여 개발합니다.
+
+**팀 공유**
+팀원들의 Slack ID를 등록하면, 하나의 에이전트를 팀이 함께 사용할 수 있습니다. 각자의 스레드에서 독립적인 세션으로 작업합니다.
+
+---
+
+## 주요 기능
+
+| 기능 | 설명 |
+|------|------|
+| 대화형 코딩 | 자연어로 코드 작성, 수정, 리팩토링 지시 |
+| 스레드 세션 | Slack 스레드별 독립 세션, 컨텍스트 유지 |
+| 스트리밍 응답 | 실시간 진행 상황 표시 |
+| 명령어 시스템 | `/help`, `/status`, `/new`, `/compact`, `/stop`, `/usage` |
+| 기억 시스템 | `기억해: ...`로 에이전트에게 영구 정보 저장 |
+| 멀티 프로젝트 | `프로젝트: 이름`으로 작업 디렉토리 전환 |
+| 에러 자동 복구 | 컨텍스트 오버플로우 자동 압축, 세션 오류 자동 리셋 |
+| 사용량 추적 | 토큰 사용량, 비용 추정, 사용자별 통계 |
+| 퍼미션 모드 | plan / default / bypassPermissions 선택 가능 |
+| 모델 선택 | opus, sonnet, haiku 또는 직접 모델명 입력 |
+
+---
+
+## 사전 준비
+
+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 앱** - 아래 가이드를 따라 생성
+
+---
+
+## 빠른 시작
+
+```bash
+# 1. 설치
+npm install -g choavis-agent
+
+# 2. 설정 (대화형 온보딩)
+choavis-agent init
+
+# 3. 실행
+choavis-agent start
+```
+
+설정을 변경하고 싶다면:
+```bash
+choavis-agent config
+```
+
+---
+
+## Slack 앱 설정 가이드
+
+### 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-...`) → 온보딩에서 입력
+
+### 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` | 리액션 추가/제거 |
+
+### 4. 이벤트 구독
+**Features > Event Subscriptions** → Enable Events
+
+**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-...`) → 온보딩에서 입력
+
+---
+
+## 명령어 레퍼런스
+
+Slack에서 에이전트에게 다음 명령어를 보낼 수 있습니다:
+
+| 명령어 | 별칭 | 설명 |
+|--------|------|------|
+| `/help` | `도움말` | 사용 가능한 명령어 목록 |
+| `/status` | `상태` | 현재 설정, 세션, 사용량 요약 |
+| `/usage` | - | 오늘의 사용량 통계 |
+| `/usage me` | - | 내 사용량만 조회 |
+| `/usage week` | - | 최근 7일 사용량 |
+| `/new` | `/reset` | 현재 스레드 세션 초기화 |
+| `/compact` | - | 컨텍스트 압축 (긴 대화 시) |
+| `/stop` | `중지` | 현재 처리 중인 작업 중단 |
+| `프로젝트: 이름` | - | 작업 디렉토리 전환 |
+| `기억해: 내용` | - | 에이전트에 영구 정보 저장 |
+| `기억 목록` | - | 저장된 기억 조회 |
+| `기억 삭제: ID` | - | 저장된 기억 삭제 |
+
+---
+
+## 설정 옵션
+
+`choavis-agent config`로 변경하거나, `.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` | 유휴 세션 자동 리셋 시간 (분) |
+
+---
+
+## 아키텍처
+
+```
+┌─────────────┐     Socket Mode     ┌──────────────────┐
+│  Slack App  │◄───────────────────►│  Choavis Agent   │
+│  (UI 역할)  │                     │  (Node.js)       │
+└─────────────┘                     ├──────────────────┤
+                                    │  Command Router  │
+      사용자가                       │  Session Manager │
+      Slack에서                      │  Queue System    │
+      메시지 전송                     │  Memory System   │
+                                    │  Usage Tracker   │
+                                    └────────┬─────────┘
+                                             │ subprocess
+                                    ┌────────▼─────────┐
+                                    │   Claude Code    │
+                                    │   CLI (로컬)      │
+                                    │                  │
+                                    │  코드 읽기/쓰기    │
+                                    │  터미널 명령 실행   │
+                                    │  Git 작업         │
+                                    │  ... 무엇이든     │
+                                    └──────────────────┘
+```
+
+**핵심 설계 원칙:**
+- **코드는 내 로컬에서만** - 외부 서버 없음, Claude Code CLI가 로컬에서 직접 실행
+- **Slack은 리모컨** - 메시지를 전달하고 결과를 보여주는 UI 역할
+- **스레드 = 세션** - 각 Slack 스레드가 독립적인 Claude Code 세션
+
+---
+
+## 개발
+
+```bash
+# 개발 모드 (tsx로 즉시 실행)
+npm run dev
+
+# 빌드
+npm run build
+
+# 테스트
+npm test
+```
+
+---
+
+## 라이선스
+
+MIT

package/dist/agent/memory.d.ts

@@ -0,0 +1,13 @@
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    createdAt: string;
+}
+export interface MemoryStore {
+    entries: MemoryEntry[];
+}
+export declare function addMemory(baseDir: string, content: string): Promise<MemoryEntry>;
+export declare function listMemories(baseDir: string): Promise<MemoryEntry[]>;
+export declare function deleteMemory(baseDir: string, memoryId: string): Promise<boolean>;
+export declare function buildMemoryContext(baseDir: string): Promise<string>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/agent/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AA+BD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAYtF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAI1E;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASzE"}

package/dist/agent/memory.js

@@ -0,0 +1,70 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('memory');
+function getFilePath(baseDir) {
+    return join(baseDir, 'memories.json');
+}
+async function ensureDir(baseDir) {
+    if (!existsSync(baseDir)) {
+        await mkdir(baseDir, { recursive: true });
+    }
+}
+async function loadStore(filePath) {
+    if (!existsSync(filePath))
+        return { entries: [] };
+    try {
+        const data = await readFile(filePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        log.warn('메모리 파일 파싱 실패', { filePath });
+        return { entries: [] };
+    }
+}
+async function saveStore(filePath, store) {
+    await writeFile(filePath, JSON.stringify(store, null, 2));
+}
+function generateId() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+}
+export async function addMemory(baseDir, content) {
+    await ensureDir(baseDir);
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    const entry = {
+        id: generateId(),
+        content,
+        createdAt: new Date().toISOString(),
+    };
+    store.entries.push(entry);
+    await saveStore(filePath, store);
+    return entry;
+}
+export async function listMemories(baseDir) {
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    return store.entries;
+}
+export async function deleteMemory(baseDir, memoryId) {
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    const idx = store.entries.findIndex((e) => e.id === memoryId);
+    if (idx === -1)
+        return false;
+    store.entries.splice(idx, 1);
+    await saveStore(filePath, store);
+    return true;
+}
+export async function buildMemoryContext(baseDir) {
+    const entries = await listMemories(baseDir);
+    if (entries.length === 0)
+        return '';
+    const lines = ['[기억 컨텍스트]'];
+    for (const e of entries) {
+        lines.push(`- ${e.content}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=memory.js.map

package/dist/agent/memory.js.map

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

package/dist/agent/queue.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 주어진 스레드의 큐에 작업을 추가하고, 실행이 완료되면 resolve되는 Promise를 반환합니다.
+ * 같은 스레드의 작업은 순차적으로 실행되며, 다른 스레드 간에는 병렬로 실행됩니다.
+ */
+export declare function enqueue(threadTs: string, fn: () => Promise<void>): Promise<void>;
+/**
+ * 해당 스레드의 대기 중인 작업을 모두 제거하고 제거된 개수를 반환합니다.
+ */
+export declare function clearQueue(threadTs: string): number;
+/**
+ * 해당 스레드의 대기 중인 작업 수를 반환합니다.
+ */
+export declare function getQueueSize(threadTs: string): number;
+//# sourceMappingURL=queue.d.ts.map

package/dist/agent/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/agent/queue.ts"],"names":[],"mappings":"AA6DA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/agent/queue.js

@@ -0,0 +1,91 @@
+const CLEANUP_DELAY_MS = 60_000;
+const queues = new Map();
+function getOrCreateQueue(threadTs) {
+    let queue = queues.get(threadTs);
+    if (!queue) {
+        queue = { items: [], processing: false, cleanup: null };
+        queues.set(threadTs, queue);
+    }
+    return queue;
+}
+function scheduleCleanup(threadTs, queue) {
+    if (queue.cleanup) {
+        clearTimeout(queue.cleanup);
+        queue.cleanup = null;
+    }
+    queue.cleanup = setTimeout(() => {
+        if (queue.items.length === 0 && !queue.processing) {
+            queues.delete(threadTs);
+            console.log(`[queue] 스레드 ${threadTs} 큐 정리됨`);
+        }
+    }, CLEANUP_DELAY_MS);
+}
+async function processQueue(threadTs, queue) {
+    if (queue.processing)
+        return;
+    queue.processing = true;
+    // cleanup 타이머가 있으면 취소 (처리 중이므로)
+    if (queue.cleanup) {
+        clearTimeout(queue.cleanup);
+        queue.cleanup = null;
+    }
+    while (queue.items.length > 0) {
+        const item = queue.items[0];
+        try {
+            await item.execute();
+        }
+        catch (err) {
+            console.error(`[queue] 스레드 ${threadTs} 작업 실행 중 오류:`, err);
+        }
+        queue.items.shift();
+    }
+    queue.processing = false;
+    scheduleCleanup(threadTs, queue);
+}
+/**
+ * 주어진 스레드의 큐에 작업을 추가하고, 실행이 완료되면 resolve되는 Promise를 반환합니다.
+ * 같은 스레드의 작업은 순차적으로 실행되며, 다른 스레드 간에는 병렬로 실행됩니다.
+ */
+export function enqueue(threadTs, fn) {
+    const queue = getOrCreateQueue(threadTs);
+    return new Promise((resolve, reject) => {
+        const item = {
+            execute: async () => {
+                try {
+                    await fn();
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                    throw err;
+                }
+            },
+        };
+        queue.items.push(item);
+        // 현재 처리 중이 아니면 큐 처리 시작
+        if (!queue.processing) {
+            void processQueue(threadTs, queue);
+        }
+    });
+}
+/**
+ * 해당 스레드의 대기 중인 작업을 모두 제거하고 제거된 개수를 반환합니다.
+ */
+export function clearQueue(threadTs) {
+    const queue = queues.get(threadTs);
+    if (!queue)
+        return 0;
+    const cleared = queue.items.length;
+    queue.items = [];
+    return cleared;
+}
+/**
+ * 해당 스레드의 대기 중인 작업 수를 반환합니다.
+ */
+export function getQueueSize(threadTs) {
+    const queue = queues.get(threadTs);
+    if (!queue)
+        return 0;
+    return queue.items.length;
+}
+//# sourceMappingURL=queue.js.map

package/dist/agent/queue.js.map

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

package/dist/agent/runner.d.ts

@@ -0,0 +1,40 @@
+export type PermissionMode = 'default' | 'plan' | 'acceptEdits' | 'bypassPermissions';
+export interface RunOptions {
+    prompt: string;
+    sessionId?: string;
+    workDir?: string;
+    abortSignal?: AbortSignal;
+    permissionMode?: PermissionMode;
+    allowedTools?: string[];
+}
+export type AgentErrorType = 'transient' | 'session_corrupt' | 'context_overflow' | 'fatal';
+export declare function classifyError(exitCode: number | null, stderr: string): AgentErrorType;
+export interface StreamEvent {
+    type: string;
+    subtype?: string;
+    session_id?: string;
+    errorType?: AgentErrorType;
+    message?: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    };
+    result?: string;
+    tool_name?: string;
+    content_block?: {
+        type: string;
+        text?: string;
+    };
+    delta?: {
+        type: string;
+        text?: string;
+    };
+    [key: string]: any;
+}
+export interface RunResult {
+    stream: AsyncGenerator<StreamEvent>;
+    kill: () => void;
+}
+export declare function runAgent(options: RunOptions): RunResult;
+//# sourceMappingURL=runner.d.ts.map

package/dist/agent/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,mBAAmB,CAAC;AAEtF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE5F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAWrF;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAExC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAuFvD"}