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.yamlindex 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.goindex 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 sif 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 sreturn 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.goindex 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.Contreturn nil, fmt.Errorf("custom substrate harnesses require AX_SUBSTRATE=1")}- // Built-in harnesses.var defaultHarnessID string- var antigravityHarness harness.Harnessvar err error++ // Built-in Antigravity harness.+ var antigravityHarness harness.Harnessif !substrateMode {address := cfg.Harnesses.Antigravity.Endpointif address == "" {@@ -77,16 +77,47 @@ func NewControllerFromConfig(ctx context.Context, cfg *Config) (*controller.Contreturn 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.goindex 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.goindex 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.goindex 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.goindex 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.goindex 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.yamlindex bc33465..49035cc 100644--- a/manifests/ax-deployment.yaml+++ b/manifests/ax-deployment.yaml@@ -133,3 +133,4 @@ data:harnesses:antigravity:default: true+ antigravity-interactions: {}