coreweave/forge-agent-lens-for-google-antigravity

coreweave/forge-agent-lens-for-google-antigravity

Language: Python

License: Apache-2.0

Stars: 0

Forks: 0

Open issues: 0

Created: 2026-09-28T22:15:13Z

Pushed: 2026-09-28T23:12:51Z

Default branch: main

Fork: no

Archived: no

README:

Forge Agent Lens for Google Antigravity


Forge Agent Lens tracing for the Google Antigravity™ coding harness. When an agent turn becomes fully idle, the plugin translates its transcript into typed Forge agent spans.

Antigravity Stop hook + transcript
-> Forge Turn, LLM, Tool, and SubAgent models
-> Forge SDK OpenTelemetry exporter
-> Agent Lens

This repository is only the Antigravity adapter. It has no Agent Lens client, trace-query client, or transport implementation. The CoreWeave Forge SDK (coreweave==0.1.0b0, installed from PyPI) owns W&B credential discovery, endpoint selection, OpenTelemetry encoding, export, flushing, and shutdown.

The installed forge-agent-lens-for-google-antigravity executable is the plugin's stdin/stdout hook entrypoint, not a user-facing CLI.

Requirements

• macOS or Linux.
• Python 3.10 or newer.
• Antigravity CLI 1.1.10 or newer; the current release is recommended.
• A W&B API key and destination in entity/project form.
• `uv` for source installation.

See Google's official hook reference, plugin documentation, and CLI repository.

Install

git clone https://github.com/coreweave/forge-agent-lens-for-google-antigravity.git
cd forge-agent-lens-for-google-antigravity
uv tool install .
command -v forge-agent-lens-for-google-antigravity
agy plugin validate plugin
agy plugin install plugin

The executable must be on PATH in the environment that launches Antigravity.

Set the destination in the environment that launches Antigravity. The Forge SDK reads WANDB_API_KEY directly or resolves it from the W&B entry in .netrc.

export FORGE_TRACE_PROJECT=entity/project
export WANDB_API_KEY=...
agy

Antigravity copies plugins during installation. Reinstall after changing files under plugin/:

agy plugin uninstall forge-agent-lens-for-google-antigravity
agy plugin install plugin

How export works

The plugin registers one observability-only Stop hook. It waits for fullyIdle=true, reads the untruncated sibling transcript_full.jsonl when available, and maps the completed turn through Forge SDK models:

| Antigravity record | Forge span | |---|---| | User request through fully-idle stop | invoke_agent Antigravity | | PLANNER_RESPONSE | chat | | Tool request and following result | execute_tool | | invoke_subagent request and result | nested invoke_agent |

Forge emits one trace per turn and links those traces with the hook's conversationId. User and assistant text, reasoning, tool names, arguments, and results are preserved when present; step timestamps bound the spans. The transcript does not currently expose token usage, exact model request settings or response IDs, or a delegated subagent's internal LLM and tool activity, so the adapter does not synthesize those fields. The delegation itself is still exported as a nested subagent span.

Forge supplies the standard gen_ai.* fields from its typed models. The adapter adds only integration provenance and Antigravity metadata without a semantic-convention equivalent:

| Attribute | Value | |---|---| | forge.integration.name | antigravity | | forge.integration.version | Installed adapter version | | forge.integration.antigravity.workspace.paths | Hook workspacePaths | | forge.integration.antigravity.execution.number | Stop-hook execution attempt | | forge.integration.antigravity.termination.reason | Stop reason |

The adapter calls tracing.init(), log_conversation(), and the returned session's force_flush() and shutdown(). Production code never constructs an HTTP request or OpenTelemetry exporter.

The first observed stop exports only the newest turn, so installing the plugin does not upload earlier conversation history. A small checkpoint under the conversation's Antigravity artifact directory prevents duplicate export. Later turns include history observed after installation. The checkpoint advances only after the Forge SDK reports a successful flush; a failed export stays eligible for retry.

Configuration and privacy

| Variable | Owner | Purpose | |---|---|---| | FORGE_TRACE_PROJECT | adapter | Required destination in entity/project form | | FORGE_ANTIGRAVITY_INCLUDE_CONTENT | adapter | Set to false to omit prompts, outputs, reasoning, and tool payloads | | WANDB_API_KEY | Forge SDK | W&B authentication; .netrc is also supported | | WANDB_BASE_URL | Forge SDK | W&B base URL for endpoint derivation | | WF_TRACE_SERVER_URL | Forge SDK | Explicit trace-server override |

Content capture defaults to enabled. For sensitive workspaces, set:

export FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false

Workspace paths and Stop metadata remain queryable when content capture is disabled.

Runtime export failures are fail-open: the entrypoint logs the error, returns a neutral stop decision, and never extends the agent loop. The plugin registers no tool or invocation hooks and does not alter permissions, prompts, or results.

Validate

The example runs the installed hook entrypoint against a synthetic transcript and an in-process OTLP receiver. It exercises the parser, Forge models, and the real Forge SDK exporter without contacting an external service:

uv sync --locked --group test
uv run python examples/local_smoke_test.py

Run the release checks:

uv run ruff format --check .
uv run ruff check .
uv run mypy
uv run coverage run -m pytest
uv run coverage report
uvx --from bandit==1.8.6 bandit -q -r src examples
AUDIT_SITE_PACKAGES="$(uv run python -c 'import site; print(site.getsitepackages()[0])')"
uvx --from pip-audit==2.9.0 pip-audit --path "$AUDIT_SITE_PACKAGES" --skip-editable
uvx --from zizmor==1.30.1 zizmor --pedantic .
uvx --from 'reuse[charset-normalizer]==6.2.0' reuse lint
uv build
uvx --from twine==7.0.0 twine check dist/*
agy plugin...