Skip to content

armgit / ax

Public Imported from GitHub
0

Agent Executor (AX) is Google's open agentic orchestration runtime

Go

Antigravity interactions harness registry and config (#277)

Junjie Wang3ed25c7ec5f3
diff --git a/ax.yaml b/ax.yaml
index 0155cac..56a980a 100644
--- a/ax.yaml
+++ b/ax.yaml
@@ -27,6 +27,7 @@ eventlog:
harnesses:
antigravity:
default: true
+ antigravity-interactions: {}
telemetry:
otlp:
diff --git a/cmd/ax/harness.go b/cmd/ax/harness.go
index fc72be8..8eaafae 100644
--- a/cmd/ax/harness.go
+++ b/cmd/ax/harness.go
@@ -25,7 +25,6 @@ import (
"net/http"
"os"
"os/signal"
- "path/filepath"
"strconv"
"syscall"
"time"
@@ -122,7 +121,7 @@ func runAntigravityInteractionsHarness(ctx context.Context, systemInstructions s
if err := setHarnessWorkDir(); err != nil {
return err
}
- stateDir, err := harnessStateDir()
+ stateDir, err := antigravityinteractions.DefaultStateDir()
if err != nil {
return err
}
@@ -133,19 +132,6 @@ func runAntigravityInteractionsHarness(ctx context.Context, systemInstructions s
return antigravityinteractions.Serve(ctx, cfg, harnessHost, harnessPort, harnessReadyzPort)
}
-// harnessStateDir returns the directory for persisting resume cursors: a
-// dedicated "~/.ax/cursors" under the user's home directory. It lives OUTSIDE the
-// agent's working directory on purpose -- the working directory is the agent's
-// operating surface (it reads and edits files there, including hidden ones), so
-// AX's internal state is kept separate to avoid the agent seeing or clobbering it.
-func harnessStateDir() (string, error) {
- home, err := os.UserHomeDir()
- if err != nil {
- return "", fmt.Errorf("resolving home directory for resume-cursor state: %w", err)
- }
- return filepath.Join(home, ".ax", "cursors"), nil
-}
-
// serveReadyz serves the HTTP /readyz endpoint on readyzPort that substrate's
// readiness probe polls (during golden snapshotting and per-actor Run/Restore).
// Each request forwards to the forked harness's gRPC health Check.
diff --git a/cmd/ax/internal/cliutil/cliutil.go b/cmd/ax/internal/cliutil/cliutil.go
index f4f35bb..3e99c75 100644
--- a/cmd/ax/internal/cliutil/cliutil.go
+++ b/cmd/ax/internal/cliutil/cliutil.go
@@ -24,11 +24,10 @@ import (
"github.com/google/ax/internal/controller/eventlog"
"github.com/google/ax/internal/harness"
"github.com/google/ax/internal/harness/antigravity"
+ "github.com/google/ax/internal/harness/antigravityinteractions"
"github.com/google/ax/internal/harness/substrate"
)
-const antigravityHarnessID = "antigravity"
-
// Controller is the active controller type for this build.
type Controller = *controller.Controller
@@ -62,10 +61,11 @@ func NewControllerFromConfig(ctx context.Context, cfg *Config) (*controller.Cont
return nil, fmt.Errorf("custom substrate harnesses require AX_SUBSTRATE=1")
}
- // Built-in harnesses.
var defaultHarnessID string
- var antigravityHarness harness.Harness
var err error
+
+ // Built-in Antigravity harness.
+ var antigravityHarness harness.Harness
if !substrateMode {
address := cfg.Harnesses.Antigravity.Endpoint
if address == "" {
@@ -77,16 +77,47 @@ func NewControllerFromConfig(ctx context.Context, cfg *Config) (*controller.Cont
return nil, fmt.Errorf("antigravity harness: %w", err)
}
} else {
- antigravityHarness, err = substrate.New(antigravityHarnessID, "", "", "", 80)
+ antigravityHarness, err = substrate.New(config.AntigravityHarnessID, "", "", "", 80)
if err != nil {
return nil, fmt.Errorf("antigravity harness: %w", err)
}
}
- if err := reg.RegisterHarness(antigravityHarnessID, antigravityHarness); err != nil {
+ if err := reg.RegisterHarness(config.AntigravityHarnessID, antigravityHarness); err != nil {
return nil, fmt.Errorf("register antigravity harness: %w", err)
}
if cfg.Harnesses.Antigravity.Default {
- defaultHarnessID = antigravityHarnessID
+ defaultHarnessID = config.AntigravityHarnessID
+ }
+
+ // Built-in Antigravity Interactions harness.
+ var antigravityInteractionsHarness harness.Harness
+ if !substrateMode {
+ agent := cfg.Harnesses.AntigravityInteractions.Agent
+ if agent == "" {
+ agent = antigravityinteractions.DefaultAgent
+ }
+ stateDir := cfg.Harnesses.AntigravityInteractions.StateDir
+ if stateDir == "" {
+ stateDir, err = antigravityinteractions.DefaultStateDir()
+ if err != nil {
+ return nil, fmt.Errorf("antigravity-interactions harness: %w", err)
+ }
+ }
+ antigravityInteractionsHarness, err = antigravityinteractions.New(antigravityinteractions.AntigravityInteractionsConfig{
+ Agent: agent,
+ StateDir: stateDir,
+ })
+ } else {
+ antigravityInteractionsHarness, err = substrate.New(config.AntigravityInteractionsHarnessID, "", "", "", 80)
+ }
+ if err != nil {
+ return nil, fmt.Errorf("antigravity-interactions harness: %w", err)
+ }
+ if err := reg.RegisterHarness(config.AntigravityInteractionsHarnessID, antigravityInteractionsHarness); err != nil {
+ return nil, fmt.Errorf("register antigravity-interactions harness: %w", err)
+ }
+ if cfg.Harnesses.AntigravityInteractions.Default {
+ defaultHarnessID = config.AntigravityInteractionsHarnessID
}
for _, sc := range cfg.Harnesses.Substrate {
diff --git a/cmd/ax/internal/cliutil/cliutil_test.go b/cmd/ax/internal/cliutil/cliutil_test.go
index 77dbb6b..31fe2e7 100644
--- a/cmd/ax/internal/cliutil/cliutil_test.go
+++ b/cmd/ax/internal/cliutil/cliutil_test.go
@@ -49,6 +49,34 @@ func TestNewControllerFromConfig_BuiltinSubstrate(t *testing.T) {
c.Close()
}
+func TestNewControllerFromConfig_InteractionsSubstrate(t *testing.T) {
+ t.Setenv("AX_SUBSTRATE", "1")
+
+ cfg := &config.Config{
+ EventLog: config.EventLogConfig{
+ SQLiteConfig: config.SQLiteConfig{
+ Filename: filepath.Join(t.TempDir(), "log.sqlite"),
+ },
+ },
+ Harnesses: config.HarnessesConfig{
+ Antigravity: config.AntigravityHarnessConfig{Default: true},
+ },
+ }
+
+ c, err := NewControllerFromConfig(context.Background(), cfg)
+ if err != nil {
+ t.Fatalf("NewControllerFromConfig: %v", err)
+ }
+ if c == nil {
+ t.Fatal("expected non-nil controller")
+ }
+ defer c.Close()
+
+ if _, err := c.Registry().Harness(config.AntigravityInteractionsHarnessID); err != nil {
+ t.Errorf("interactions harness not registered in substrate mode: %v", err)
+ }
+}
+
func TestNewControllerFromConfig_CustomHarnessRequiresSubstrateMode(t *testing.T) {
t.Setenv("AX_SUBSTRATE", "")
diff --git a/internal/config/config.go b/internal/config/config.go
index 32770ec..2af5580 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -30,6 +30,9 @@ const (
// The port for harnesses running as substrate actors. Substrate's
// actor networking DNATs inbound workerPodIP:80 to the actor.
substrateDefaultPort = 80
+ // Harness IDs reserved for AX's built-in harnesses.
+ AntigravityHarnessID = "antigravity"
+ AntigravityInteractionsHarnessID = "antigravity-interactions"
)
// Config represents the main configuration for the AX harness server.
@@ -74,13 +77,14 @@ type EventLogConfig struct {
}
// HarnessesConfig groups harnesses to serve by type. There are two categories:
-// - Built-in harnesses (e.g. Antigravity) whose implementation and container
-// image are provided by AX.
+// - Built-in harnesses (e.g. Antigravity, AntigravityInteractions) whose
+// implementation and container image are provided by AX.
// - Custom harnesses on substrate whose implementation and container image are
// provided by the user via their own ActorTemplate.
type HarnessesConfig struct {
- Antigravity AntigravityHarnessConfig `yaml:"antigravity,omitempty"`
- Substrate []SubstrateHarnessConfig `yaml:"substrate,omitempty"`
+ Antigravity AntigravityHarnessConfig `yaml:"antigravity,omitempty"`
+ AntigravityInteractions AntigravityInteractionsHarnessConfig `yaml:"antigravity-interactions,omitempty"`
+ Substrate []SubstrateHarnessConfig `yaml:"substrate,omitempty"`
}
// AntigravityHarnessConfig registers the built-in Antigravity harness.
@@ -89,6 +93,14 @@ type AntigravityHarnessConfig struct {
Endpoint string `yaml:"endpoint,omitempty"` // HarnessService address
}
+// AntigravityInteractionsHarnessConfig registers the built-in Antigravity
+// Interactions harness (over the Vertex GenAI Interactions API).
+type AntigravityInteractionsHarnessConfig struct {
+ Default bool `yaml:"default,omitempty"` // Default harness or not
+ Agent string `yaml:"agent,omitempty"` // Interactions API agent (default: antigravityinteractions.DefaultAgent)
+ StateDir string `yaml:"state_dir,omitempty"` // Resume-cursor directory (optional; defaults to ~/.ax/antigravityinteractions/cursors)
+}
+
// SubstrateHarnessConfig registers a custom harness deployed on substrate
// from a user-provided container image.
type SubstrateHarnessConfig struct {
@@ -165,13 +177,16 @@ func (c *Config) Validate() error {
if c.Harnesses.Antigravity.Default {
defaultCount++
}
+ if c.Harnesses.AntigravityInteractions.Default {
+ defaultCount++
+ }
for _, sc := range c.Harnesses.Substrate {
if sc.ID == "" {
return fmt.Errorf("substrate harness id is required")
}
- if sc.ID == "antigravity" {
- return fmt.Errorf("substrate harness id %q is reserved for the built-in antigravity harness", sc.ID)
+ if sc.ID == AntigravityHarnessID || sc.ID == AntigravityInteractionsHarnessID {
+ return fmt.Errorf("substrate harness id %q is reserved for built-in harnesses", sc.ID)
}
if sc.Namespace == "" {
return fmt.Errorf("substrate harness %q: namespace is required", sc.ID)
diff --git a/internal/config/config_test.go b/internal/config/config_test.go
index cd8d358..0c88010 100644
--- a/internal/config/config_test.go
+++ b/internal/config/config_test.go
@@ -103,6 +103,26 @@ func TestValidate_MultipleDefaults(t *testing.T) {
}
}
+func TestValidate_InteractionsIDReserved(t *testing.T) {
+ c := validConfig()
+ c.Harnesses.Substrate[0].ID = "antigravity-interactions"
+ err := c.Validate()
+ if err == nil || !strings.Contains(err.Error(), "reserved") {
+ t.Fatalf("Validate() = %v, want reserved id error", err)
+ }
+}
+
+func TestValidate_InteractionsValid(t *testing.T) {
+ c := validConfig()
+ c.Harnesses.AntigravityInteractions = AntigravityInteractionsHarnessConfig{
+ Agent: "projects/p/locations/global/agents/a",
+ StateDir: "interactions-state",
+ }
+ if err := c.Validate(); err != nil {
+ t.Fatalf("Validate() = %v, want nil", err)
+ }
+}
+
func TestLoadFromFile_Version(t *testing.T) {
data := `
version: "1.2.3"
diff --git a/internal/harness/antigravityinteractions/antigravityinteractions.go b/internal/harness/antigravityinteractions/antigravityinteractions.go
index d2e956f..d3370b6 100644
--- a/internal/harness/antigravityinteractions/antigravityinteractions.go
+++ b/internal/harness/antigravityinteractions/antigravityinteractions.go
@@ -52,6 +52,7 @@ import (
"math/rand"
"net/http"
"os"
+ "path/filepath"
"sort"
"strconv"
"strings"
@@ -65,27 +66,29 @@ import (
"golang.org/x/oauth2/google"
)
-// cloudPlatformScope is the OAuth2 scope required to call Vertex AI.
-const cloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
-
-// Compile-time interface assertions.
-var _ harness.Harness = (*AntigravityInteractionsHarness)(nil)
-var _ harness.Execution = (*antigravityInteractionsExecution)(nil)
-
-const interactionsAPIVersion = "v1beta1"
-
-// interactionsEndpoint is the public Vertex GenAI dataplane endpoint.
-const interactionsEndpoint = "https://aiplatform.googleapis.com"
-
-// Cloud project and location are read from these standard environment variables
-// (see https://github.com/google/ax#authentication).
const (
+ // interactionsEndpoint is the public Vertex GenAI dataplane endpoint.
+ interactionsEndpoint = "https://aiplatform.googleapis.com"
+ // interactionsAPIVersion is the Interactions API version this harness targets.
+ interactionsAPIVersion = "v1beta1"
+ // cloudPlatformScope is the OAuth2 scope required to call Vertex AI.
+ cloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
+
+ // Cloud project and location are read from these standard environment
+ // variables (see https://github.com/google/ax#authentication).
envCloudProject = "GOOGLE_CLOUD_PROJECT"
envCloudLocation = "GOOGLE_CLOUD_LOCATION"
+ // defaultLocation is used when GOOGLE_CLOUD_LOCATION is unset.
+ defaultLocation = "global"
+
+ // DefaultAgent is the Interactions API agent used when the harness is
+ // registered without an explicit agent override.
+ DefaultAgent = "antigravity-preview-05-2026"
)
-// defaultLocation is used when GOOGLE_CLOUD_LOCATION is unset.
-const defaultLocation = "global"
+// Compile-time interface assertions.
+var _ harness.Harness = (*AntigravityInteractionsHarness)(nil)
+var _ harness.Execution = (*antigravityInteractionsExecution)(nil)
// AntigravityInteractionsConfig configures an AntigravityInteractionsHarness.
// Use New, which fills sensible defaults.
@@ -154,6 +157,20 @@ func cloudLocation() string {
return defaultLocation
}
+// DefaultStateDir returns the default resume-cursor directory, ~/.ax/antigravityinteractions/cursors,
+// used when a caller does not set StateDir explicitly. It lives outside the
+// agent's working directory on purpose: the working directory is the agent's
+// operating surface (it reads and edits files there), so AX's internal state is
+// kept separate to avoid the agent seeing or clobbering it. New still requires a
+// non-empty StateDir; callers apply this default.
+func DefaultStateDir() (string, error) {
+ home, err := os.UserHomeDir()
+ if err != nil {
+ return "", fmt.Errorf("resolving home directory for resume-cursor state: %w", err)
+ }
+ return filepath.Join(home, ".ax", "antigravityinteractions", "cursors"), nil
+}
+
// AntigravityInteractionsHarness implements Harness by talking to the public
// Vertex GenAI Interactions API.
type AntigravityInteractionsHarness struct {
diff --git a/internal/harness/antigravityinteractions/antigravityinteractions_test.go b/internal/harness/antigravityinteractions/antigravityinteractions_test.go
index 1138d1f..2a4f19d 100644
--- a/internal/harness/antigravityinteractions/antigravityinteractions_test.go
+++ b/internal/harness/antigravityinteractions/antigravityinteractions_test.go
@@ -20,6 +20,7 @@ import (
"fmt"
"io"
"net/http"
+ "path/filepath"
"strings"
"sync"
"testing"
@@ -221,3 +222,18 @@ func TestCursorStoreLoadSave(t *testing.T) {
t.Errorf("after overwrite PrevInteractionID = %q, want %q", cur.PrevInteractionID, "INT-8")
}
}
+
+// TestDefaultStateDir returns ~/.ax/antigravityinteractions/cursors under the
+// user's home directory.
+func TestDefaultStateDir(t *testing.T) {
+ home := t.TempDir()
+ t.Setenv("HOME", home)
+
+ got, err := DefaultStateDir()
+ if err != nil {
+ t.Fatalf("DefaultStateDir: %v", err)
+ }
+ if want := filepath.Join(home, ".ax", "antigravityinteractions", "cursors"); got != want {
+ t.Errorf("DefaultStateDir() = %q, want %q", got, want)
+ }
+}
diff --git a/manifests/ax-deployment.yaml b/manifests/ax-deployment.yaml
index bc33465..49035cc 100644
--- a/manifests/ax-deployment.yaml
+++ b/manifests/ax-deployment.yaml
@@ -133,3 +133,4 @@ data:
harnesses:
antigravity:
default: true
+ antigravity-interactions: {}