fix(antigravity): resume pending executions via empty-input continue (#190)

.dockerignore

@@ -0,0 +1,8 @@
+.git
+.idea
+.vscode
+*.log
+eventlog/
+tmp/
+node_modules/
+bin/

.github/workflows/go.yml

@@ -0,0 +1,73 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This workflow will build a golang project
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-go
+
+name: Go
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Cache addlicense
+      id: cache-addlicense
+      uses: actions/cache@v4
+      with:
+        path: ~/go/bin/addlicense
+        key: ${{ runner.os }}-addlicense-v1.2.0
+
+    - name: Install addlicense
+      if: steps.cache-addlicense.outputs.cache-hit != 'true'
+      run: go install github.com/google/addlicense@v1.2.0
+
+    - name: Check license headers
+      run: |
+        $(go env GOPATH)/bin/addlicense -check .
+
+    - name: Set up Go
+      uses: actions/setup-go@v4
+      with:
+        go-version-file: go.mod
+
+    - name: Verify go mod tidy
+      run: |
+        go mod tidy
+        git diff --exit-code go.mod go.sum
+
+    - name: Build
+      run: go build -v ./...
+
+    - name: Test
+      run: go test -v ./...
+
+    - name: Check for binary files in PR
+      run: |
+        # Get the list of files where Git shows no line count (binary)
+        BINARIES=$(git diff --numstat origin/${{ github.base_ref }}...HEAD | grep "^-" | cut -f3)
+
+        if [ -n "$BINARIES" ]; then
+          echo "Binary files detected in diff:"
+          echo "$BINARIES"
+          exit 1 # Fail the check if binaries are found
+        fi

.github/workflows/python.yml

@@ -0,0 +1,51 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Runs pytest against the antigravity harness sidecar
+# (python/antigravity/harness_server_test.py). Split from go.yml so the
+# Go workflow stays Go-only and this can evolve independently as more
+# Python surface area lands.
+
+name: Python
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install Python deps
+      # Runtime deps from python/antigravity/requirements.txt plus test-only
+      # tooling. Version floors on pytest match the upstream google-antigravity
+      # SDK's own dev extras (see google-antigravity/antigravity-sdk-python
+      # pyproject.toml) so this doesn't drift. pytest-timeout is added here
+      # only -- our tests spin up real gRPC servers on random ports and can hang.
+      run: pip install -r python/antigravity/requirements.txt 'pytest>=7.0' 'pytest-timeout>=2.0'
+
+    - name: Run Python tests
+      # --timeout guards against hung gRPC servers so a stuck test can't
+      # eat the whole workflow budget.
+      run: python -m pytest python/antigravity/ --timeout=30 --timeout-method=thread -v

.gitignore

@@ -1,2 +1,8 @@
 bin/*
-eventlog/*
+eventlog/*
+/ax
+*.log
+ax-bin
+python/__pycache__
+python/proto/__pycache__
+__pycache__/

.ko.yaml

@@ -0,0 +1,15 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+defaultBaseImage: gcr.io/distroless/static

CONTRIBUTING.md

@@ -1,6 +1,17 @@
 # How to contribute
 
-We'd love to accept your patches and contributions to this project.
+We'd love to accept your patches and contributions to this project. However, please note our current temporary policy below.
+
+> [!IMPORTANT]
+> **Temporary Pause on External Contributions**
+> 
+> AX is currently undergoing a significant architectural redesign, and the codebase is highly unstable. To ensure we can focus on stabilizing the core framework, we are temporarily **pausing the acceptance of external Pull Requests**.
+> 
+> Please do not open Pull Requests at this time, as they are likely to conflict with ongoing changes and may be closed without review. Instead, we encourage you to:
+> - Open an **Issue** to propose feature requests or report bugs.
+> - Join discussions on existing issues to share your feedback.
+> 
+> We will update this guide once the core architecture stabilizes and we are ready to welcome contributions again. Thank you for your understanding and patience!
 
 ## Before you begin
 
@@ -49,8 +60,81 @@ make proto
 make test
 ```
 
-### Run local agent
+### Install the ax CLI
 
 ```bash
-make run-local
+make install
+```
+
+Ensure that $GOPATH/bin is in your $PATH.
+
+```bash
+export PATH="$PATH:$(go env GOPATH)/bin"
+```
+
+If you have the `GOBIN` environment variable set, it will be installed there instead.
+Make sure the installation directory is in your `$PATH`.
+
+To add the default location to your `PATH` for the current session, run:
+
+```bash
+export PATH="$PATH:$(go env GOPATH)/bin"
+```
+
+### Creating a pull request
+
+First, clone the repo:
+
+```
+git clone git@github.com:google/ax.git
+```
+
+If you already have cloned the repo locally, make sure that
+your main branch is up to date:
+
+```
+git checkout main
+git pull -q -r origin main
+```
+
+Check a new feature branch:
+
+```
+git checkout -b my-feature
+```
+
+Make edits to files, and test them locally. Add the changes (e.g. git add .) to stage.
+Commit the changes once you staged the changes:
+
+```
+git commit -m "Describe he changes made"
+```
+
+Push the branch to the origin and open a pull request:
+
+```
+git push origin my-feature
+```
+
+Visit https://github.com/google/ax to open a pull request.
+
+
+## Troubleshooting
+
+### Outdated table schema
+
+AX is still under heavy development and the database schema is not yet stable. If you encounter errors related to outdated table schemas, you can reset the database by deleting the `eventlog` directory.
+
+An example:
+
+```bash
+ax exec --input "hello"
+
+Error: error creating controller: failed to create event log: sqlite_eventlog: create index exec_checkpoint_id: SQL logic error: no such column: checkpoint_id (1)
+```
+
+Delete the `eventlog` directory and try again.
+
+```bash
+rm -rf ./eventlog
 ```

Makefile

@@ -1,58 +1,62 @@
-.PHONY: all build proto test clean install
+.PHONY: all build proto test test-python clean install deps clean-logs
 
 # Build all binaries
 all: proto build
 
 # Build binaries
 build:
-	@echo "Building gar..."
+	@echo "Building ax..."
 	@mkdir -p bin
-	@go build -o bin/gar ./cmd/gar
-	@echo "Building local agent example..."
-	@go build -o bin/local_agent ./examples/local_agent
-	@echo "Building remote agent example..."
-	@go build -o bin/remote_agent ./examples/remote_agent
+	@go build -o bin/ax ./cmd/ax
 	@echo "Build complete!"
 
+
 # Generate protobuf code
 proto:
 	@echo "Generating protobuf code..."
 	@export PATH=$$PATH:$$(go env GOPATH)/bin && \
 		protoc --go_out=. --go_opt=paths=source_relative \
 		       --go-grpc_out=. --go-grpc_opt=paths=source_relative \
-		       proto/gar.proto
+		       proto/ax.proto proto/content.proto
+	@python3 -m grpc_tools.protoc -I. --python_out=python --grpc_python_out=python proto/ax.proto proto/content.proto
 	@echo "Protobuf generation complete!"
 
-# Run tests
+# Run Go tests
 test:
-	@echo "Running tests..."
+	@echo "Running Go tests..."
 	@go test -v ./...
 
+# Run Python tests for the antigravity harness sidecar.
+# Assumes deps are installed for the same interpreter as `python3`, e.g.:
+#   python3 -m pip install -r python/antigravity/requirements.txt \
+#     'pytest>=7.0' 'pytest-timeout>=2.0'
+# --timeout guards against hung gRPC servers.
+test-python:
+	@echo "Running Python tests..."
+	@python3 -m pytest python/antigravity/ --timeout=30 --timeout-method=thread
+
 # Clean build artifacts
 clean:
 	@echo "Cleaning..."
 	@rm -rf bin/
 	@rm -rf eventlog/
 	@echo "Clean complete!"
 
-# Install gar to GOPATH/bin
+# Install ax to GOPATH/bin
 install:
-	@echo "Installing gar..."
-	@go install ./cmd/gar
+	@echo "Installing ax..."
+	@go install ./cmd/ax
 	@echo "Install complete!"
 
-# Run local agent example
-run-local:
-	@go run ./examples/local_agent
-
-# Run remote agent example
-run-remote:
-	@go run ./examples/remote_agent
-
 # Install dependencies
 deps:
 	@echo "Installing dependencies..."
 	@go mod download
 	@go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
 	@go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
 	@echo "Dependencies installed!"
+
+clean-logs:
+	@echo "Cleaning the event logs..."
+	rm -rf ./eventlog
+	mkdir ./eventlog