Agent Executor (AX) is Google's open agentic orchestration runtime
Go
TUI: add interactive /config menu for per-request harness config (#235)
Junjie Wang89276a1246de
diff --git a/cmd/ax/exec.go b/cmd/ax/exec.goindex 67878d2..bf739b6 100644--- a/cmd/ax/exec.go+++ b/cmd/ax/exec.go@@ -145,7 +145,7 @@ func execLoop(ctx context.Context, id string, harnessID string, harnessConfig []if !execResume {var quit boolvar err error- input, quit, err = promptUser(d, input)+ input, harnessConfig, quit, err = promptUser(d, input, harnessConfig)if err != nil {return err}@@ -260,8 +260,11 @@ func execLoop(ctx context.Context, id string, harnessID string, harnessConfig []}}+ // Per-request config: clear the config after each turn.+ harnessConfig = nil+var quit bool- input, quit, err = promptUser(d, "")+ input, harnessConfig, quit, err = promptUser(d, "", harnessConfig)if err != nil {return err}@@ -363,32 +366,47 @@ func displayContents(d *internal.Display, contents []*proto.Message) {}// promptUser loops until the user provides a non-empty input string.+// The "/config" command opens the harness config menu.// It returns:// - string: the valid user input+// - []byte: the (possibly updated) harness config// - bool: true if the user entered a quit command// - error: any error that occurred during prompting-func promptUser(d *internal.Display, input string) (string, bool, error) {- for strings.TrimSpace(input) == "" {- var err error- input, err = d.PromptForInput()- if err != nil {- if errors.Is(err, internal.ErrUserAborted) {- if interruptHandler.HandleInterrupt() {- return "", true, nil+func promptUser(d *internal.Display, input string, harnessConfig []byte) (string, []byte, bool, error) {+ for {+ for strings.TrimSpace(input) == "" {+ var err error+ input, err = d.PromptForInput()+ if err != nil {+ if errors.Is(err, internal.ErrUserAborted) {+ if interruptHandler.HandleInterrupt() {+ return "", harnessConfig, true, nil+ }+ input = "" // Continue loop to prompt again+ continue}- input = "" // Continue loop to prompt again- continue+ return "", harnessConfig, false, err}- return "", false, err}- }- d.DisplayInput(input)- if strings.ToLower(strings.TrimSpace(input)) == "q" {- d.ShowResumption(execConversationID, execServerAddr)- return "", true, nil+ trimmed := strings.TrimSpace(input)+ if trimmed == "/config" {+ cfg, err := runConfigMenu(d, harnessConfig)+ if err != nil {+ return "", harnessConfig, false, err+ }+ harnessConfig = cfg+ input = "" // Re-prompt after handling the config.+ continue+ }++ d.DisplayInput(input)+ if strings.ToLower(trimmed) == "q" {+ d.ShowResumption(execConversationID, execServerAddr)+ return "", harnessConfig, true, nil+ }+ return input, harnessConfig, false, nil}- return input, false, nil}// InterruptHandler encapsulates the cancellation and signal handling state.diff --git a/cmd/ax/harnessconfig.go b/cmd/ax/harnessconfig.gonew file mode 100644index 0000000..24492ab--- /dev/null+++ b/cmd/ax/harnessconfig.go@@ -0,0 +1,138 @@+// 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.++package main++import (+ "bytes"+ "encoding/json"+ "errors"+ "fmt"+ "os"+ "strings"++ "github.com/google/ax/cmd/ax/internal"+)++// runConfigMenu shows the /config menu and returns the (possibly updated) config.+// An updated config is sent on subsequent requests.+func runConfigMenu(d *internal.Display, harnessConfig []byte) ([]byte, error) {+ for {+ action, err := d.PromptForConfigAction()+ if err != nil {+ if errors.Is(err, internal.ErrUserAborted) {+ return harnessConfig, nil // Esc/Ctrl+C on the menu cancels /config.+ }+ return harnessConfig, err+ }++ switch action {+ case "edit":+ cfg, done, err := editHarnessConfig(d, harnessConfig)+ if err != nil {+ return harnessConfig, err+ }+ if done {+ return cfg, nil+ }+ case "load":+ cfg, done, err := loadHarnessConfig(d)+ if err != nil {+ return harnessConfig, err+ }+ if done {+ return cfg, nil+ }+ default: // "cancel" or anything else+ return harnessConfig, nil+ }+ }+}++// editHarnessConfig opens the JSON editor pre-filled with the current config. It+// returns the updated config with done=true if the config was updated, or+// done=false (config ignored) if the user cancelled back to the menu. Invalid+// JSON is reported and the editor re-opens with the user's draft so they can fix+// it.+func editHarnessConfig(d *internal.Display, harnessConfig []byte) ([]byte, bool, error) {+ draft := prettyHarnessConfig(harnessConfig)+ for {+ edited, err := d.PromptForConfigEdit(draft)+ if err != nil {+ if errors.Is(err, internal.ErrUserAborted) {+ return nil, false, nil // Back to the menu.+ }+ return nil, false, err+ }+ normalized, err := normalizeHarnessConfigJSON(edited)+ if err != nil {+ d.ShowNotice(fmt.Sprintf("Invalid config: %v", err))+ draft = edited // Preserve the user's input so they can fix it.+ continue+ }+ return normalized, true, nil+ }+}++// loadHarnessConfig lets the user pick a JSON file and loads it. It returns the+// loaded config with done=true, or done=false (config ignored) if the user+// cancelled back to the menu or the file could not be used.+func loadHarnessConfig(d *internal.Display) ([]byte, bool, error) {+ path, err := d.PromptForConfigFile()+ if err != nil {+ if errors.Is(err, internal.ErrUserAborted) {+ return nil, false, nil // Back to the menu.+ }+ return nil, false, err+ }+ b, err := os.ReadFile(strings.TrimSpace(path))+ if err != nil {+ d.ShowNotice(fmt.Sprintf("Failed to read file: %v", err))+ return nil, false, nil+ }+ normalized, err := normalizeHarnessConfigJSON(string(b))+ if err != nil {+ d.ShowNotice(fmt.Sprintf("Invalid config: %v", err))+ return nil, false, nil+ }+ return normalized, true, nil+}++// normalizeHarnessConfigJSON trims and validates the given JSON config, returning+// the bytes to send on the wire. Empty input clears the config (returns nil). The+// config must be a JSON object.+func normalizeHarnessConfigJSON(s string) ([]byte, error) {+ s = strings.TrimSpace(s)+ if s == "" {+ return nil, nil+ }+ var obj map[string]any+ if err := json.Unmarshal([]byte(s), &obj); err != nil {+ return nil, err+ }+ return []byte(s), nil+}++// prettyHarnessConfig returns an indented JSON rendering of the config bytes for+// display, falling back to the raw bytes if they cannot be parsed.+func prettyHarnessConfig(b []byte) string {+ if len(b) == 0 {+ return ""+ }+ var buf bytes.Buffer+ if err := json.Indent(&buf, b, "", " "); err != nil {+ return string(b)+ }+ return buf.String()+}diff --git a/cmd/ax/harnessconfig_test.go b/cmd/ax/harnessconfig_test.gonew file mode 100644index 0000000..869759b--- /dev/null+++ b/cmd/ax/harnessconfig_test.go@@ -0,0 +1,81 @@+// 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.++package main++import (+ "strings"+ "testing"+)++func TestNormalizeHarnessConfigJSON(t *testing.T) {+ tests := []struct {+ name string+ in string+ want string+ wantErr bool+ }{+ {name: "empty", in: "", want: ""},+ {name: "whitespace clears", in: " \n\t ", want: ""},+ {name: "valid object", in: `{"model":"gemini"}`, want: `{"model":"gemini"}`},+ {name: "trims surrounding whitespace", in: " {\"model\":\"gemini\"}\n", want: `{"model":"gemini"}`},+ {name: "nested object", in: `{"a":{"b":1},"c":[1,2]}`, want: `{"a":{"b":1},"c":[1,2]}`},+ {name: "invalid json", in: `{bad}`, wantErr: true},+ {name: "non-object array", in: `[1,2,3]`, wantErr: true},+ {name: "non-object scalar", in: `42`, wantErr: true},+ }+ for _, tt := range tests {+ t.Run(tt.name, func(t *testing.T) {+ got, err := normalizeHarnessConfigJSON(tt.in)+ if tt.wantErr {+ if err == nil {+ t.Fatalf("expected error, got nil (result %q)", got)+ }+ return+ }+ if err != nil {+ t.Fatalf("unexpected error: %v", err)+ }+ if string(got) != tt.want {+ t.Errorf("got %q, want %q", got, tt.want)+ }+ if tt.want == "" && got != nil {+ t.Errorf("expected nil for cleared config, got %q", got)+ }+ })+ }+}++func TestPrettyHarnessConfig(t *testing.T) {+ if got := prettyHarnessConfig(nil); got != "" {+ t.Errorf("nil: got %q, want empty string", got)+ }+ if got := prettyHarnessConfig([]byte{}); got != "" {+ t.Errorf("empty: got %q, want empty string", got)+ }++ // Invalid JSON falls back to the raw bytes.+ if got := prettyHarnessConfig([]byte("not json")); got != "not json" {+ t.Errorf("invalid: got %q, want raw passthrough", got)+ }++ // Valid JSON is rendered multi-line and indented.+ got := prettyHarnessConfig([]byte(`{"model":"gemini"}`))+ if !strings.Contains(got, "model") || !strings.Contains(got, "gemini") {+ t.Errorf("valid: got %q, want it to contain the key and value", got)+ }+ if !strings.Contains(got, "\n") {+ t.Errorf("valid: got %q, want indented multi-line output", got)+ }+}diff --git a/cmd/ax/internal/display.go b/cmd/ax/internal/display.goindex 5c413ff..d980bbb 100644--- a/cmd/ax/internal/display.go+++ b/cmd/ax/internal/display.go@@ -19,6 +19,8 @@ import ("io""os"+ "charm.land/bubbles/v2/key"+ tea "charm.land/bubbletea/v2""charm.land/huh/v2""charm.land/lipgloss/v2""github.com/google/ax/proto"@@ -149,6 +151,12 @@ func (d *Display) displaySystem(text string) {fmt.Fprintln(d.w, text)}+// ShowNotice prints an informational message (e.g. the current harness config+// or a validation error) on its own line.+func (d *Display) ShowNotice(text string) {+ d.displaySystem(text)+}+// FinishOutput completes the streaming output and shows info if providedfunc (d *Display) FinishOutput(info string) {if d.state != stateNone {@@ -162,7 +170,7 @@ func (d *Display) FinishOutput(info string) {}func (d *Display) DisplayHeader() {- fmt.Fprintln(d.w, d.idStyle.Render("Conversation: " + d.id))+ fmt.Fprintln(d.w, d.idStyle.Render("Conversation: "+d.id))fmt.Fprintln(d.w)}@@ -190,13 +198,20 @@ func (d *Display) PromptForApproval(question string) (bool, error) {// Returns the input string and an error if the user cancelled (Ctrl+C)func (d *Display) PromptForInput() (string, error) {var userInput string++ // Rebind tab to complete the suggestion and enter to submit.+ keymap := huh.NewDefaultKeyMap()+ keymap.Input.AcceptSuggestion = key.NewBinding(key.WithKeys("tab"), key.WithHelp("tab", "complete"))+ keymap.Input.Next = key.NewBinding(key.WithKeys("enter"), key.WithHelp("enter", "submit"))+form := huh.NewForm(huh.NewGroup(huh.NewInput().Placeholder("Enter prompt... (type `q` to quit)").+ Suggestions([]string{"/config"}).Value(&userInput),),- ).WithWidth(boxWidth)+ ).WithWidth(boxWidth).WithShowHelp(false).WithKeyMap(keymap)if err := form.Run(); err != nil {return "", err@@ -204,6 +219,99 @@ func (d *Display) PromptForInput() (string, error) {return userInput, nil}+// configKeyMap returns a huh keymap for the /config menu that cancels on esc in+// addition to the default ctrl+c, and shows a consistent "esc close" hint in+// every field's help footer.+func configKeyMap() *huh.KeyMap {+ km := huh.NewDefaultKeyMap()+ km.Quit = key.NewBinding(key.WithKeys("ctrl+c", "esc"), key.WithHelp("esc", "close"))++ // Surface the esc hint through a slot that stays enabled.+ closeHint := key.NewBinding(key.WithKeys("esc"), key.WithHelp("esc", "close"))+ km.Select.Filter = closeHint+ km.Text.Editor = closeHint+ return km+}++// clearMenuOnCancel converts the interrupt huh emits on cancel (esc/ctrl+c) into+// a graceful quit.+var clearMenuOnCancel = tea.WithFilter(func(_ tea.Model, msg tea.Msg) tea.Msg {+ if _, ok := msg.(tea.InterruptMsg); ok {+ return tea.QuitMsg{}+ }+ return msg+})++// PromptForConfigAction shows the /config menu and returns the chosen action,+// one of "edit", "load", or "cancel". It returns an error if the user cancelled+// (Ctrl+C or Esc).+func (d *Display) PromptForConfigAction() (string, error) {+ var action string+ form := huh.NewForm(+ huh.NewGroup(+ huh.NewSelect[string]().+ Title("Harness config").+ Options(+ huh.NewOption("View/edit config", "edit"),+ huh.NewOption("Load from file", "load"),+ huh.NewOption("Cancel", "cancel"),+ ).+ Value(&action),+ ),+ ).WithWidth(boxWidth).WithKeyMap(configKeyMap()).WithProgramOptions(clearMenuOnCancel)++ if err := form.Run(); err != nil {+ return "", err+ }+ return action, nil+}++// PromptForConfigEdit shows a multi-line editor pre-filled with current and+// returns the edited text. It returns an error if the user cancelled (Ctrl+C or+// Esc).+func (d *Display) PromptForConfigEdit(current string) (string, error) {+ text := current+ form := huh.NewForm(+ huh.NewGroup(+ huh.NewText().+ Title("Harness config (JSON, leave empty to clear)").+ Lines(10).+ ExternalEditor(true).+ Value(&text),+ ),+ ).WithWidth(boxWidth).WithKeyMap(configKeyMap()).WithProgramOptions(clearMenuOnCancel)++ if err := form.Run(); err != nil {+ return "", err+ }+ return text, nil+}++// PromptForConfigFile shows a file browser for selecting a JSON config file and+// returns the chosen path. It returns an error if the user cancelled (Ctrl+C or+// Esc).+func (d *Display) PromptForConfigFile() (string, error) {+ var path string+ form := huh.NewForm(+ huh.NewGroup(+ huh.NewFilePicker().+ Title("Load harness config").+ CurrentDirectory(".").+ AllowedTypes([]string{".json"}).+ FileAllowed(true).+ DirAllowed(false).+ Picking(true).+ Height(10).+ Value(&path),+ ),+ ).WithWidth(boxWidth).WithKeyMap(configKeyMap()).WithProgramOptions(clearMenuOnCancel)++ if err := form.Run(); err != nil {+ return "", err+ }+ return path, nil+}+func (d *Display) ShowResumption(id string, server string) {fmt.Fprintln(d.w, d.resumeStyle.Render("To resume the conversation,"))if server != "" {diff --git a/go.mod b/go.modindex 1aaf333..308e648 100644--- a/go.mod+++ b/go.mod@@ -3,6 +3,8 @@ module github.com/google/axgo 1.26.3require (+ charm.land/bubbles/v2 v2.0.0+ charm.land/bubbletea/v2 v2.0.2charm.land/huh/v2 v2.0.3charm.land/lipgloss/v2 v2.0.3cloud.google.com/go/compute/metadata v0.9.0@@ -23,8 +25,6 @@ require ()require (- charm.land/bubbles/v2 v2.0.0 // indirect- charm.land/bubbletea/v2 v2.0.2 // indirectgithub.com/atotto/clipboard v0.1.4 // indirectgithub.com/catppuccin/go v0.3.0 // indirectgithub.com/cenkalti/backoff/v5 v5.0.3 // indirect