# 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` | ❌ 없음 | 시스템 로그뿐 |
