Antigravity (Gemini)

Antigravity 어댑터는 Google의 공식 agy CLI를 Adapter 계약 뒤에서 헤드리스로 구동합니다: 원샷 실행에는 agy --output-format json -p, 대화 수정에는 agy --conversation <id> -p, 증분 이벤트에는 agy --output-format stream-json -p를 사용하며 — 모두 본인 Google 로그인으로 동작합니다.

비공식

Google과 제휴하거나 그로부터 승인받지 않았습니다. 이 패키지는 이미 설치되고 인증된 agy 바이너리를 그대로 실행합니다 — 서비스를 사칭하거나, 자격증명을 공유하거나, 레이트리밋을 우회하지 않습니다.

설치

npm install @toragonite/agent-mesh @toragonite/agent-mesh-gemini

agy CLI가 설치되고 로그인되어 있어야 합니다. Antigravity는 자격증명을 Electron 앱의 데이터 디렉터리에 보관합니다 — CLI login/status 서브커맨드가 없으므로, 아래 인증은 파일을 읽는 대신 CLI를 직접 실행합니다.

옵션

new GeminiAdapter(options?) — 모든 옵션은 실제 구현으로 기본 설정되며 테스트를 위해 재정의할 수 있습니다:

옵션	타입	기본값	설명
exec	ExecFn	nodeExec	완료까지 실행하는 프로세스 seam.
lineStream	LineStreamFn	nodeLineStream	stream()을 뒷받침하는 스트리밍 프로세스 seam.
binary	string	'agy'	agy 실행 파일 경로 또는 명령 이름.
defaultAccount	Account	—	호출이 계정을 넘기지 않을 때 사용할 계정. configDir이 AGY_HOME을 설정합니다(agy에는 문서화되지 않은 변수 — 동작 참고사항 참고).
env	Record<string, string | undefined>	process.env	환경 변수 seam — 모든 자식 프로세스 환경과 모든 환경 읽기의 기반.
authTimeoutMs	number	20000	agy models 인증 프로브의 최대 대기 시간.
quotaTimeoutMs	number	90000	quota()가 사용하는 agy -p /usage 읽기의 최대 대기 시간.
quotaCacheMs	number	60000	quota() 결과(스냅샷 또는 null)를 계정별로 재사용하는 시간. 0이면 캐시를 끕니다.

실행과 재개

import { Fleet } from '@toragonite/agent-mesh'
import { GeminiAdapter } from '@toragonite/agent-mesh-gemini'

const fleet = new Fleet().register(new GeminiAdapter())

// Antigravity는 한 단어 답변에 약 12-15초가 걸립니다 — timeoutMs를 넉넉하게
// 설정하세요(아래 지연시간 참고).
const res = await fleet.run(
  { prompt: 'Reply with exactly: MESH-OK', timeoutMs: 60_000 },
  { policy: { prefer: ['gemini'] } },
)
console.log(res.status, res.conversationId, res.text)

// 같은 대화를 id로 이어갑니다.
const more = await fleet.resume('gemini', res.conversationId, 'Now say it backwards.', {
  timeoutMs: 60_000,
})
console.log(more.text)

어댑터를 직접 사용할 수도 있습니다:

const agy = new GeminiAdapter({ binary: 'agy' /* 기본값 */ })
const res = await agy.run({ prompt: 'hello', model: 'gemini-3.6-flash-high' })

스트림

const agy = new GeminiAdapter()
for await (const ev of agy.stream({ prompt: 'Write a haiku about routing.', timeoutMs: 60_000 })) {
  if (ev.type === 'text') process.stdout.write(ev.text)
  else if (ev.type === 'usage') console.error('usage', ev.usage)
  else if (ev.type === 'done') console.error('\ndone', ev.result.status, ev.result.conversationId)
  else if (ev.type === 'error') console.error('error', ev.message)
}

스트리밍은 agy --output-format stream-json을 agent-mesh RunEvent로 매핑합니다: init 이벤트는 대화 id만 기록합니다. agent_response 단계에서 비어 있지 않은 text_delta가 있을 때만 text 이벤트가 됩니다(user_input, checkpoint 등 다른 단계 타입은 건너뜁니다 — 계약에 해당 이벤트가 없고, 단계별 usage는 부분값이라 권위 있는 값이 아니기 때문입니다). 마지막 result 이벤트는 usage 이벤트를 내보낸 뒤, 스트리밍이 아닌 run()이 만드는 것과 같은 RunResult를 담은 done 이벤트를 내보냅니다. 빈 프롬프트는 프로세스가 스폰되기 전, stream() 호출 시점에 동기적으로 예외를 던집니다. result 이벤트 없이 스트림이 끝나면: 타임아웃은 status: 'incomplete'인 done 결과를 내보내고(절대 error 이벤트가 아닙니다), 0이 아닌 종료 코드는 종료 코드와 자식 프로세스의 stderr 꼬리를 담은 error 이벤트를 내보냅니다.

모델

availableModels()는 정적 카탈로그를 반환하며 아무것도 스폰하지 않습니다 — Fleet.route()가 라우팅 핫 패스에서 이 메서드를 호출하기 때문입니다:

id	지연시간	비고
gemini-3.6-flash-high	fast
gemini-3.6-flash-medium	fast
gemini-3.6-flash-low	fast
gemini-3.5-flash-high	fast
gemini-3.5-flash-medium	fast
gemini-3.5-flash-low	fast
gemini-3.1-pro-high	slow
gemini-3.1-pro-low	slow
claude-sonnet-4-6	fast	리셀 — 선택하면 Gemini가 아니라 Anthropic의 쿼터를 소모합니다
claude-opus-4-6-thinking	slow	리셀 — 선택하면 Gemini가 아니라 Anthropic의 쿼터를 소모합니다
gpt-oss-120b-medium	fast	리셀 — 선택하면 Gemini가 아니라 해당 제공사의 쿼터를 소모합니다

리셀 모델

카탈로그 항목 중 세 개는 agy를 통해 접근할 수 있지만 Google이 아닌 다른 벤더의 쿼터를 청구합니다. Gemini 어댑터로 다른 벤더의 쿼터를 라우팅하는 것은 멀티 벤더 플릿의 취지를 무색하게 합니다 — 그 벤더 자신의 어댑터를 등록하는 편이 낫습니다.

인증 모드 게이팅은 없습니다 — 모든 항목이 하나의 Google 로그인에서 선택 가능합니다. latency 클래스는 잠정적인 추정치입니다(인터랙티브 대 심층 추론 행동에 대한 최선의 추측이며, 실측이 아닙니다). 어떤 항목도 default로 표시되지 않습니다: 작업이 모델을 지정하지 않으면 run()은 --model을 생략하고 CLI가 자체 기본값을 적용합니다 — 여기서 기본값을 표시하면 거짓이 됩니다. 이 카탈로그 밖의 모델 id도 그대로 실행되며, 결과에 model <id> not in known catalog 주석이 남습니다.

정적 vs 라이브

availableModels()는 라우팅을 위한 빠르고 hermetic한 경로입니다. 느리지만 권위 있는 대응은 fetchLiveModels()로, agy models를 실행하고 Fetching available models... 안내 줄을 건너뛴 뒤 TAB으로 구분된 id\tlabel 행을 각각 파싱합니다:

import { fetchLiveModels } from '@toragonite/agent-mesh-gemini'
const live = await fetchLiveModels() // ModelInfo[] — 실패 시 []

어떤 실패든(스폰 오류, 0이 아닌 종료 코드, 타임아웃, 파싱 불가능한 출력) []로 귀결됩니다 — 절대 예외를 던지지 않습니다.

인증

authStatus()는 agy models를 실행합니다 — 읽을 수 있는 로컬 자격증명 파일도, status/login 서브커맨드도 없기 때문에 Antigravity가 노출하는 유일한 인증 프로브입니다. 종료 코드 0이고 파싱 가능한 모델 줄이 하나 이상이면 { loggedIn: true, mode: 'google' }를 반환합니다. 그 외(0이 아닌 종료 코드, 바이너리 없음, 타임아웃, 파싱 불가능한 출력)는 { loggedIn: false }를 반환합니다. 절대 예외를 던지지 않고, detail도 반환하지 않습니다 — CLI가 계정 식별자를 노출하지 않기 때문입니다.

이 호출은 네트워크 왕복이 발생하므로, 의도적으로 라우팅 경로에는 포함되지 않습니다 — 라우팅에는 정적인 availableModels()만 쓰입니다.

쿼터

quota()는 agy에게 직접 묻습니다. agy -p /usage --output-format json을 실행하는데, agy(1.1.11 이상)는 이를 프린트 모드에서 에이전트 턴 없이, 쿼터를 소모하지 않고 답합니다 — 수치는 agy가 자체 로그인으로 가져오므로 이 어댑터는 토큰을 읽거나 보관하거나 갱신하지 않습니다. capabilities.quota는 true입니다.

const snap = await new GeminiAdapter().quota()
// { vendor: 'gemini', allowed: true, windows: [
//     { label: 'gemini-weekly', usedPercent: 0, resetAt: '2026-10-20T07:57:54.000Z' },
//     { label: 'gemini-5h',     usedPercent: 0, resetAt: '2026-10-15T15:10:03.000Z' },
//     { label: '3p-weekly',     usedPercent: 0, resetAt: '2026-10-22T10:10:03.000Z' },
//     { label: '3p-5h',         usedPercent: 0, resetAt: '2026-10-15T15:10:03.000Z' } ],
//   raw: { groups: [...] } }

• 윈도우. 활성화된 버킷마다 하나씩이며, 그룹 순서대로 그다음 버킷 순서대로 나열됩니다. agy 1.3.5에서 "Gemini Models" 그룹에는 gemini-weekly와 gemini-5h가, "Claude and GPT models" 그룹(리셀 모델)에는 3p-weekly와 3p-5h가 있습니다. label은 버킷 id입니다(없으면 <그룹 이름> <윈도우>). usedPercent는 (1 − remaining_fraction) × 100을 소수점 한 자리로 반올림해 0..100으로 제한한 값입니다. resetAt은 버킷의 RFC 3339 reset_time을 ISO 시각으로 바꾼 값입니다.
• 제외되며, 0으로 보고되지 않는 경우. 비활성화된 버킷, remaining_amount만 있는 버킷(나눌 한도가 없음)이나 두 필드 모두 없는 버킷(분수 없이 amount가 0이면 소진이 아니라 알 수 없음), 그리고 1을 넘는 remaining_fraction.
• **allowed**는 모델 그룹별 윈도우에서 파생됩니다: 어느 윈도우든 100%이면 false입니다. 리셀 모델의 윈도우도 포함되므로 소진된 3p-* 윈도우는 어댑터 전체를 막습니다. raw는 command.data 객체입니다.
• 어떤 실패든 null("헤드룸 알 수 없음") — 로그인되지 않음, API 키 / ADC 세션, 0이 아닌 종료 코드, AGY_ERROR: 또는 error: 줄, SUCCESS가 아닌 상태, 다른 형태의 본문, 쓸 수 있는 버킷 없음, 1 MiB를 넘는 stdout, 또는 타임아웃. Fleet은 null을 "헤드룸 미확인"으로 취급하고 어댑터를 계속 후보로 둡니다. { allowed: true, windows: [] }를 임의로 만들어 반환하는 일은 없습니다. quota()는 예외를 던지지 않습니다.
• 비용과 한계. 읽을 때마다 agy의 language server가 기동됩니다(수 초). 읽기는 90초 뒤 타임아웃됩니다(quotaTimeoutMs, 프로세스 그룹 전체를 종료). 결과(스냅샷 또는 null)는 60초 동안 캐시됩니다(quotaCacheMs, 0이면 캐시 끔). 어댑터 인스턴스·계정별로 읽기는 동시에 하나만 실행되며, 동시에 호출한 쪽은 그 결과를 기다립니다. 자식 프로세스는 run()과 같은 계정 env, /dev/null stdin, 사용자별 비공개 작업 디렉터리(<os tmpdir>/agent-mesh-agy-usage-<uid>, uid가 없는 플랫폼에서는 정리된 -<username>; 0.1.4부터 — 이전에는 모든 로컬 사용자가 한 이름을 공유)로 어댑터의 exec 시임을 통해 시작됩니다. 디렉터리는 0700으로 만들어지며, 이 사용자 소유의 실제 디렉터리이고 모드가 0700이 아니면 거부됩니다(읽기는 null, 아무것도 실행하지 않음).

계정 격리는 제공되지 않습니다

agy 1.3.5는 AGY_HOME을 읽지 않으므로, quota()가 보고하는 계정을 포함해 모든 계정이 agy의 기본 로그인을 공유합니다. 동작 참고사항을 참고하세요.

동작 참고사항

• 후행 개행 정규화. agy는 다른 agent-mesh 벤더들과 달리 출력한 답변 끝에 개행을 하나 붙입니다. 벤더 간 비교 가능성을 위해 run()/resume()과 스트림의 done 결과는 최종 텍스트에서 후행 개행(\r\n 또는 \n)을 정확히 하나만 제거합니다. 중간의 개행은 그대로 유지되며, 두 번째 후행 개행도 그대로 남습니다. 스트리밍 text 델타는 가공하지 않고 그대로 전달됩니다 — 최종 조립된 텍스트만 정규화됩니다.
• allowedTools는 무시됩니다. agy에는 대응하는 플래그가 없으므로 task.allowedTools는 버려지고, 결과에는 allowedTools not supported by agy; ignored 주석이 남습니다.
• agy 1.3.5는 계정 격리를 제공하지 않으며, 모든 계정이 기본 로그인을 공유합니다. agy에는 문서화된 config-dir 환경 변수가 없고, agy 1.3.5 바이너리에는 AGY_HOME 문자열도 없습니다. account.configDir을 넘기면 어댑터는 여전히 이를 AGY_HOME으로 설정하고(언젠가 이를 읽는 agy가 받을 수 있도록) agy 1.3.5는 이를 읽지 않는다는 주석을 추가합니다. 하지만 모든 계정은 agy의 기본 로그인으로 실행되며 quota()도 그 로그인의 사용량을 보고합니다. configDir 없이 명시적으로 넘긴 account는 앰비언트 로그인을 의미하며 기본 계정의 디렉터리를 물려받지 않습니다.
• 지연시간. 한 단어 답변이 12–15초로 관측되었습니다(Claude Code/Codex의 약 5초와 대비됩니다). agy 자체의 --print-timeout 기본값은 5m0s입니다. timeoutMs를 넉넉하게 설정하세요 — 타임아웃은 status: 'incomplete'로 해석되므로(절대 예외를 던지지 않습니다) 너무 짧게 잡으면 실제 답변이 조용히 잘려나갈 수 있습니다.
• 비밀값 없음. 어떤 결과, 주석, detail, 오류, raw에도 토큰이나 자격증명 값이 등장하지 않습니다. 이 경로에는 애초에 토큰이 없지만, 규칙은 변함없이 적용됩니다.