antigravityinteractions

type AntigravityInteractionsConfig struct {

	// Agent is the Interactions API agent name to run. Required: the API rejects a
	// request with no agent.
	Agent string

	// StateDir is the directory where each conversation's resume cursor is
	// persisted, so a conversation can resume after a restart. Required: New
	// returns an error if it is empty.
	//
	// Correctness relies on a single writer per conversation: writes are
	// last-write-wins with no compare-and-swap. This is an expectation the caller
	// must satisfy (e.g. by routing a conversation id to one worker, or resuming
	// a worker from that conversation's snapshot) -- it is not currently enforced
	// by the controller.
	StateDir string

	// WorkDir is the working directory the agent operates in. When set, it is the
	// authoritative base for built-in env tools: run_command executes there (and
	// resolves a relative Cwd against it). This makes tool execution independent
	// of the process's ambient cwd. Empty means "use the process cwd" (the
	// previous behavior). Defaults from AX_HARNESS_WORKDIR.
	WorkDir string

	// SystemInstruction, if set, is sent as the interaction's system_instruction
	// (a free-form system prompt prepended to the agent's own instructions). It
	// is sent on every turn of the interaction loop so it persists across them.
	SystemInstruction string
	// MaxTurns caps the number of interaction turns the harness will drive within
	// a single Run before giving up. Defaults to 100.
	MaxTurns int
	// Debug, if true, logs concise per-conversation tool activity to stderr: a
	// line for each function call (FC) the agent yields and each function result
	// (FR) the harness produces. Useful for observing the FC/FR exchange that is
	// otherwise internal to the harness.
	Debug bool
	// ThirdPartyExecutor executes third-party (non-built-in) function tool calls
	// and declares them to the agent. It is the seam for the controller to inject
	// the caller's tool implementations. If nil, the harness advertises no
	// third-party tools and any non-built-in call the agent attempts yields an
	// error result.
	ThirdPartyExecutor ThirdPartyExecutor
	// TokenSource overrides how the bearer token is obtained. If nil, the harness
	// builds an auto-refreshing source from Application Default Credentials.
	TokenSource oauth2.TokenSource
}

type AntigravityInteractionsHarness struct {
	// contains filtered or unexported fields
}

type FunctionTool struct {
	Type   string `json:"type"` // "function"
	Name   string `json:"name"`
	Desc   string `json:"description,omitempty"`
	Params any    `json:"parameters,omitempty"`
}

type ThirdPartyExecutor interface {
	// Declarations returns the tool declarations advertised to the agent.
	Declarations() []FunctionTool
	// Execute runs the named tool with the given arguments and returns the result
	// value to send back to the agent (wrapped into the function_result step).
	Execute(ctx context.Context, name string, args map[string]any) any
}