docs: LS ConnectRPC reference (100+ RPC methods) + devlog + commands update

2026-03-07 19:16:33 +09:00
parent be6fae71de
commit e4b98af308
4 changed files with 250 additions and 0 deletions
--- a/docs/antigravity-commands.md
+++ b/docs/antigravity-commands.md
@@ -232,3 +232,37 @@
 | `git.antigravityCloneNonInteractive` | Clone non-interactive |
 | `git.antigravityGetRemoteUrl` | Get remote URL |
 | `git.antigravityReportCloneProgress` | Report clone progress |
+
+---
+
+## 🔌 Language Server ConnectRPC (Direct RPC)
+
+> LS Go 바이너리에서 추출한 RPC 메서드. ConnectRPC(HTTPS) 프로토콜 사용.
+> 서비스: `exa.language_server_pb.LanguageServerService`
+> 상세: [ls-rpc-reference.md](ls-rpc-reference.md)
+
+### 대화/Trajectory
+
+| 메서드 | 용도 |
+|--------|------|
+| `GetUserTrajectoryDescriptions` | 모든 대화 목록 (googleAgentId, summary, lastStepIndex) |
+| `GetCascadeTrajectory` | 대화 전체 내용 |
+| `GetCascadeTrajectorySteps` | 대화 단계별 데이터 (startStepIndex 지원) |
+| `StartCascade` | 새 대화 생성 (headless) |
+| `SendUserCascadeMessage` | 기존 대화에 메시지 전송 |
+
+### 실시간 스트림
+
+| 메서드 | 용도 |
+|--------|------|
+| `StreamCascadeReactiveUpdates` | Cascade 실시간 업데이트 |
+| `StreamAgentStateUpdates` | 에이전트 상태 스트림 |
+
+### 에이전트 제어
+
+| 메서드 | 용도 |
+|--------|------|
+| `HandleCascadeUserInteraction` | 사용자 상호작용 (승인/거절) |
+| `AcknowledgeCascadeCodeEdit` | 코드 편집 승인 |
+| `ResolveOutstandingSteps` | 미해결 단계 처리 |
+
--- a/docs/devlog/2026-03-07.md
+++ b/docs/devlog/2026-03-07.md
@@ -14,3 +14,6 @@
 | 10 | 15:00 | @bridge→@gravity 이름 변경 + 슬래시 명령어 /stop /auto /send | `02e9e4d`~`0bd525a` | ✅ |
 | 11 | 16:00 | sendTextToChat 탐색 → sendPromptToAgentPanel 발견 | `e4eb756`~`8d5e59c` | ✅ |
 | 12 | 17:15 | 양방향 통신 완성 + 171개 명령어 문서화 + scanner 시작 수정 | `befa5d7` | ✅ |
+| 13 | 17:50 | getDiagnostics 구조 프로브 → 대화 텍스트 미포함 확인 | `952883d`~`150967d` | 🔧 |
+| 14 | 18:15 | LS ConnectRPC 브릿지 구현 + HTTPS 프로토콜 감지 수정 | `91b3a7e`~`f2ed431` | 🔧 |
+| 15 | 18:45 | Go 바이너리에서 100+ RPC 메서드 추출 → 정확한 메서드명 적용 | `be6fae7` | 🔧 |
--- a/docs/devlog/entries/20260307-003.md
+++ b/docs/devlog/entries/20260307-003.md
@@ -0,0 +1,38 @@
+# LS ConnectRPC 브릿지 역설계 + AI 응답 릴레이 구현
+
+- **시간**: 2026-03-07 17:30~19:00
+- **Commit**: `952883d`~`be6fae7` (6 commits)
+- **Vikunja**: #223 → 진행중
+
+## 핵심 발견
+
+### AI 대화 텍스트는 brain/ 파일에 없다
+- brain/에는 artifact (task.md, walkthrough.md, implementation_plan.md)만 저장
+- .system_generated/logs/ 디렉토리도 없음
+- AI 응답 텍스트는 **LS 내부 메모리**에만 존재
+- getDiagnostics에는 시스템 로그와 대화 **메타데이터**(제목, step 수)만 포함
+
+### LS ConnectRPC 접속
+- LS 바이너리: `language_server_windows_x64.exe` (160MB Go)
+- 프로토콜: ConnectRPC over HTTPS (자체 서명 인증서)
+- 인증: `x-codeium-csrf-token` 헤더 + `--csrf_token` CLI값
+- 포트: `--random_port` 사용 → netstat + PID 기반 탐색 필요
+
+### Go 바이너리에서 100+ RPC 메서드 추출
+- Python regex로 `/exa.language_server_pb.LanguageServerService/` 패턴 추출
+- 핵심 메서드: `GetUserTrajectoryDescriptions`, `GetCascadeTrajectorySteps`, `StreamCascadeReactiveUpdates`
+- `GetTrajectoryDescriptions`는 존재하지 않음 → SDK 타입 정의가 부정확
+
+## 실패한 접근법
+
+1. `onDidChangeTextDocument` — WebView 기반 채팅은 TextDocument 이벤트 미발생
+2. `getManagerTrace` / `getWorkbenchTrace` — undefined 반환
+3. brain/ 파일 모니터링 — artifact만 존재, 대화 텍스트 없음
+4. getDiagnostics → 메타데이터만, 대화 내용 없음
+5. antigravity-sdk — d.ts만 있고 JS 구현 없는 vaporware
+
+## 미완료
+
+- [ ] LS ConnectRPC 호출이 실제로 대화 데이터 반환하는지 검증 필요
+- [ ] `GetCascadeTrajectorySteps` 응답 구조 파악 → AI 텍스트 추출 로직
+- [ ] `StreamCascadeReactiveUpdates`로 실시간 릴레이 가능성 탐색
--- a/docs/ls-rpc-reference.md
+++ b/docs/ls-rpc-reference.md
@@ -0,0 +1,175 @@
+# Antigravity Language Server RPC Reference
+
+> Extracted from `language_server_windows_x64.exe` (160MB Go binary, v2026-03)
+> Protocol: ConnectRPC over HTTPS on localhost
+> Service: `exa.language_server_pb.LanguageServerService`
+
+---
+
+## 연결 정보
+
+| 항목 | 값 |
+|------|-----|
+| **프로세스명** | `language_server_windows_x64.exe` |
+| **CSRF 헤더** | `x-codeium-csrf-token` |
+| **CSRF 값** | `--csrf_token` CLI 인자에서 추출 |
+| **프로토콜** | HTTPS (자체 서명 인증서) |
+| **포트** | `--random_port` → netstat에서 PID 기반 탐색 |
+| **Content-Type** | `application/json` |
+
+### 포트 발견 절차
+
+1. `Get-CimInstance Win32_Process` → LS PID + `--csrf_token` 추출
+2. `netstat -ano | findstr LISTENING | findstr <PID>` → 리스닝 포트 목록
+3. 각 포트에 `Heartbeat` 요청 시도 (HTTP → HTTPS fallback)
+4. 200 응답 포트 = ConnectRPC 포트
+
+### 주의사항
+
+- LS 포트 3개: LSP JSON-RPC, HTTP ConnectRPC, HTTPS ConnectRPC
+- `--extension_server_port`는 별도 (Extension Host IPC 전용)
+- `port 404 page not found` = 해당 경로에 서비스 없음 (Go HTTP mux)
+- HTTP 요청 → "Client sent an HTTP request to an HTTPS server." → HTTPS 사용
+
+---
+
+## 🎯 핵심 RPC 메서드 (채팅/대화)
+
+| 메서드 | 용도 | 비고 |
+|--------|------|------|
+| `GetUserTrajectoryDescriptions` | 모든 대화 목록 조회 | googleAgentId, summary, lastStepIndex |
+| `GetCascadeTrajectory` | 대화 전체 내용 | 무거움 |
+| `GetCascadeTrajectorySteps` | 대화 단계 데이터 | startStepIndex로 범위 지정 가능 |
+| `StartCascade` | 새 대화 생성 | headless 지원 |
+| `SendUserCascadeMessage` | 기존 대화에 메시지 전송 | |
+| `AddCascadeInput` | Cascade에 입력 추가 | |
+| `HandleCascadeUserInteraction` | 사용자 상호작용 처리 | 승인/거절 등 |
+| `LoadTrajectory` | 대화 로드 | |
+| `LoadReplayConversation*` | 대화 리플레이 | |
+| `SmartFocusConversation` | UI에서 대화 포커스 | |
+
+## 📡 스트리밍 RPC (실시간)
+
+| 메서드 | 용도 |
+|--------|------|
+| `StreamCascadeReactiveUpdates` | Cascade 실시간 업데이트 스트림 |
+| `StreamCascadePanelReactiveUpdates*` | 패널 상태 실시간 스트림 |
+| `StreamCascadeSummariesReactiveUpdates` | 대화 요약 실시간 스트림 |
+| `StreamAgentStateUpdates` | 에이전트 상태 스트림 |
+| `StreamUserTrajectoryReactiveUpdates*` | 사용자 trajectory 실시간 스트림 |
+| `StreamTerminalShellCommand` | 터미널 명령어 스트림 |
+
+## 🛠️ 에이전트 제어
+
+| 메서드 | 용도 |
+|--------|------|
+| `ResolveOutstandingSteps` | 미해결 단계 처리 |
+| `AcknowledgeCascadeCodeEdit` | 코드 편집 승인 |
+| `RevertToCascadeStep` | 특정 단계로 롤백 |
+| `GetCascadeTrajectoryGeneratorMetadata` | 생성기 메타데이터 |
+| `RecordUserStepSnapshot` | 사용자 단계 스냅샷 기록 |
+| `SendActionToChatPanel` | 채팅 패널에 액션 전송 |
+
+## 📋 설정/상태
+
+| 메서드 | 용도 |
+|--------|------|
+| `Heartbeat` | 연결 검증 |
+| `GetStatus` | LS 상태 |
+| `GetUserStatus` | 사용자 상태 (크레딧 등) |
+| `GetUserSettings` | 사용자 설정 |
+| `SetUserSettings` | 사용자 설정 변경 |
+| `GetWorkingDirectories` | 작업 디렉토리 |
+| `SetWorkingDirectories` | 작업 디렉토리 설정 |
+| `GetDebugDiagnostics` | 디버그 진단 |
+| `GetModelStatuses` | 모델 상태 |
+| `GetCascadeModelConfigs` | Cascade 모델 설정 |
+
+## 🧩 MCP / 플러그인
+
+| 메서드 | 용도 |
+|--------|------|
+| `GetMcpServerStates` | MCP 서버 상태 |
+| `RefreshMcpServers` | MCP 서버 새로고침 |
+| `ListMcpResources` | MCP 리소스 목록 |
+| `ListMcpPrompts` | MCP 프롬프트 목록 |
+| `GetAvailableCascadePlugins` | 사용 가능한 플러그인 |
+| `InstallCascadePlugin` | 플러그인 설치 |
+| `GetCascadePluginById` | 플러그인 상세 |
+
+## 📊 분석/기록
+
+| 메서드 | 용도 |
+|--------|------|
+| `RecordAnalyticsEvent` | 분석 이벤트 기록 |
+| `RecordChatFeedback` | 채팅 피드백 기록 |
+| `RecordEvent` | 일반 이벤트 기록 |
+| `GetUserAnalyticsSummary` | 사용자 분석 요약 |
+
+## 🗂️ Artifact / Memory
+
+| 메서드 | 용도 |
+|--------|------|
+| `GetArtifactSnapshots` | 아티팩트 스냅샷 |
+| `GetRevisionArtifact` | 특정 리비전 아티팩트 |
+| `SaveMediaAsArtifact` | 미디어 → 아티팩트 저장 |
+| `GetCascadeMemories` | Cascade 메모리 |
+| `UpdateCascadeMemory` | Cascade 메모리 업데이트 |
+| `GetUserMemories` | 사용자 메모리 |
+| `UpdateConversationAnnotations` | 대화 주석(태그,제목) 업데이트 |
+
+## 🔧 기타
+
+| 메서드 | 용도 |
+|--------|------|
+| `GetRepoInfos` | 저장소 정보 |
+| `GetWorkspaceInfos` | 워크스페이스 정보 |
+| `GetAllRules` | 모든 규칙 |
+| `GetAllSkills` | 모든 스킬 |
+| `GetAllWorkflows` | 모든 워크플로우 |
+| `GetAllCustomAgentConfigs` | 커스텀 에이전트 설정 |
+| `GetBrowserOpenConversation` | 브라우저에 열린 대화 |
+| `SkipBrowserSubagent` | 브라우저 서브에이전트 스킵 |
+
+---
+
+## getDiagnostics 구조 (VS Code 명령)
+
+`antigravity.getDiagnostics` → 176KB JSON string:
+
+| 키 | 타입 | 내용 |
+|-----|------|------|
+| `isRemote` | boolean | 원격 여부 |
+| `systemInfo` | object | OS, 타임스탬프, 이메일, 사용자명 |
+| `extensionLogs` | Array(426) | Extension 로그 문자열 배열 |
+| `rendererLogs` | object | 렌더러별 로그 (artifacts, interactive-editor) |
+| `mainThreadLogs` | object | 메인 스레드 로그 (auth, cloudcode) |
+| `languageServerLogs` | object | LS 디버그 로그 |
+| `recentTrajectories` | Array(10) | 최근 대화 메타데이터 |
+
+### recentTrajectories 항목 구조
+
+```json
+{
+  "googleAgentId": "uuid",
+  "trajectoryId": "uuid",
+  "summary": "대화 제목",
+  "lastStepIndex": 56,
+  "lastModifiedTime": "2026-03-07T05:53:11.1492Z"
+}
+```
+
+> ⚠️ `recentTrajectories`는 **대화 텍스트를 포함하지 않음** — 메타데이터만.
+> AI 응답 텍스트를 얻으려면 LS ConnectRPC의 `GetCascadeTrajectorySteps` 필요.
+
+---
+
+## 실패한 접근법 (참고)
+
+| 접근 | 결과 | 이유 |
+|------|------|------|
+| `onDidChangeTextDocument` | ❌ | Agent 패널은 WebView, TextDocument 이벤트 미발생 |
+| `antigravity.getManagerTrace` | ❌ undefined | 가용 데이터 없음 |
+| `antigravity.getWorkbenchTrace` | ❌ undefined | 가용 데이터 없음 |
+| `brain/` 파일 모니터링 | △ partial | task.md/walkthrough.md만 — AI 응답 텍스트 없음 |
+| `getDiagnostics.agentWindowConsoleLogs` | ❌ 없음 | 시스템 로그뿐 |