# 환경 정보 (Client)

## 현재 위치

이 에이전트는 원격 클라이언트에서 실행된다.
GCP 서비스는 외부 도메인으로 접근한다.

## 서비스 URL

- Data API: https://data-api.starian.us
- GCP Portal: https://server-main.starian.us
- Taskboard: https://starian.us
- Stargram: https://stargram.starian.us
- Oracle Platform: https://oracle.starian.us

## Data API (외부 도메인 경유)

```bash
# 에이전트 목록
curl -s https://data-api.starian.us/api/agents | jq length
# WO 생성
curl -s -X POST https://data-api.starian.us/api/intake -H "Content-Type: application/json" -d '{
  "sender": "oracle",
  "message": "작업 내용",
  "classification": "PROJECT_WORK",
  "domain": "engineering",
  "target_agent_id": "agt_dept_engineering"
}'
# WO 조회
curl -s "https://data-api.starian.us/api/work-orders?limit=5" | jq '.[] | {status, executor_alias, domain}'
# 결과 보고서
curl -s "https://data-api.starian.us/api/result-reports?work_order_id={wo_id}" | jq '.[0].summary'
# 도구 레지스트리
curl -s https://data-api.starian.us/api/tools | jq '.[] | {name, category, server}'
```

## GCP Portal — 작업자 터미널 (외부 도메인)

```bash
# 터미널 목록
curl -s 'https://server-main.starian.us/api/terminals?token=0205' | jq '.terminals[] | {id, name, origin}'
# 작업자 터미널 생성
curl -s -X POST 'https://server-main.starian.us/api/terminals?token=0205' \
  -H 'Content-Type: application/json' \
  -d '{
    "name":"[에이전트명]",
    "subtitle":"[프로젝트명] · [역할]",
    "path":"[프로젝트폴더]/agents/[에이전트명]",
    "origin":"system",
    "autoCommand":"claude --chrome --dangerously-skip-permissions",
    "telegram":{"chatId":"<portal-settings.json 확인 후 기입>"}
  }'
# 작업 전달 (webhook)
curl -s -X POST "https://server-main.starian.us/api/webhook/{terminalId}?token=0205" \
  -H "Content-Type: application/json" -d '{"command":"작업 지시","skipWait":true}'
# 세션 종료 + 삭제
curl -s -X POST "https://server-main.starian.us/api/terminals/{terminalId}/kill?token=0205"
```

## GCP 서버 SSH

```bash
ssh server-main      # GCP server-main (llm, Linux)
ssh macmini          # Mac Mini M4 (whitegun, macOS)
ssh sm-s936n         # Galaxy S25+ (Termux)
```

## kmsg (KakaoTalk CLI — Mac Mini 경유)

```bash
ssh macmini "kmsg send '채팅방이름' '메시지 내용'"
ssh macmini "kmsg chats --limit 10"
```

## Galaxy S25+ Termux API

```bash
ssh sm-s936n "termux-sms-send -n 010XXXXXXXX '메시지'"
ssh sm-s936n "termux-camera-photo ~/photo.jpg"
ssh sm-s936n "termux-location"
ssh sm-s936n "termux-tts-speak '텍스트'"
```

## 도메인 매핑

- `server-main.starian.us` → GCP Portal (GCP)
- `oracle.starian.us` → Oracle Platform (GCP)
- `starian.us` → Taskboard (GCP)
- `stargram.starian.us` → 스타그램 (GCP)
- `macmini.starian.us` → Mac Mini Portal (Mac Mini)
- `macmini.platformmakers.org` → 빌딩 프로젝트 (Mac Mini)
- `kakao.starian.us` → kmsg-api (Mac Mini)
- `data-api.starian.us` → Gemini API Proxy (GCP)
- `n8n.starian.us` → n8n 자동화 (GCP)

## 도구 레지스트리 (GCP 경유)

```bash
curl -s https://data-api.starian.us/api/tools | jq '.[] | {name, category, server}'
curl -s "https://data-api.starian.us/api/tools?search=video"
curl -s -X POST https://data-api.starian.us/api/tools \
  -H "Content-Type: application/json" \
  -d '{"name":"도구명","category":"카테고리","description":"용도","server":"서버별칭","path":"경로","usage_example":"사용법"}'
```