vrr/codeburn
2
0
Fork 0
mirror of https://github.com/AgentSeal/codeburn.git synced 2026-05-17 03:56:45 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
codeburn/docs/providers/antigravity.md
ozymandiashh 929c66e7d1 Fix Antigravity Windows discovery
2026-05-13 00:51:39 +03:00

2.6 KiB
Raw Blame History

Antigravity

Google Antigravity. The only provider that does not read files off disk: it speaks to a local language-server RPC endpoint instead.

  • Source: src/providers/antigravity.ts
  • Loading: lazy via src/providers/index.ts. Lazy because the protobuf dependency is heavy.
  • Test: focused helper coverage in tests/providers/antigravity.test.ts.

Where it reads from

A local HTTPS RPC endpoint exposed by Antigravity's language server. The parser:

  1. Locates the running language-server process via ps on POSIX or Get-CimInstance Win32_Process on Windows.
  2. Reads its port and CSRF token from process metadata.
  3. Calls GetCascadeTrajectoryGeneratorMetadata over HTTPS.
  4. Validates the response (capped at 16 MB).

Antigravity exposes slightly different process flags across platforms: POSIX builds have used --https_server_port and --csrf_token; Windows builds can expose --extension_server_port and --extension_server_csrf_token. Both space-separated and --flag=value forms are supported.

If the language server is not running, the parser falls back to the cached results file.

Storage format

Protobuf. Cascade and response objects map to ParsedProviderCall directly.

Caching

Custom file cache at $CODEBURN_CACHE_DIR/antigravity-results.json (defaults to ~/.cache/codeburn/). The cache is also used as the data source when the RPC endpoint is unavailable, not just as an optimization. Bumping the cache version forces a recompute.

Deduplication

Per <cascadeId>:<responseId>.

Quirks

  • Antigravity is the only provider that requires a live process. A user who closes Antigravity loses the most-recent data until next launch (the cache covers older runs).
  • The 16 MB cap on RPC responses is necessary because individual cascades can balloon. Raising it risks OOM on the user's machine.
  • Token types are split across inputTokens, responseOutputTokens, and thinkingOutputTokens. Thinking is billed at output rate.

When fixing a bug here

  1. Reproducing the full provider path requires Antigravity running locally. The unit tests cover process flag parsing and wrapped/unwrapped RPC response extraction, but they do not stand up a live Antigravity RPC endpoint.
  2. Before any change, capture a sample protobuf response (anonymized) so future regressions can be tested against a recording.
  3. If the bug is "no data after Antigravity update", the protobuf schema may have shifted. The parser's response handling is the place to look.
  4. If the bug is "stale data", check whether the RPC is reachable; the cache fallback can mask connectivity issues.