AntigravityCliSdk (AntigravityCliSdk v0.2.0)

Copy Markdown View Source

Elixir SDK for the Google Antigravity CLI (agy).

The primary API is execute/2 for typed streaming events and run/2 for a one-shot text result. The SDK delegates process execution to cli_subprocess_core and uses the same Antigravity provider profile as agent_session_manager.

Summary

Functions

Builds and validates an %AntigravityCliSdk.Options{} struct.

Streams typed Antigravity events for one prompt.

Alias for run/2, provided for ASM runtime-kit symmetry.

Lists known Antigravity provider sessions.

Executes one prompt and returns the completed assistant text.

Starts a supervised SDK session.

Types

event()

Functions

create_options(attrs)

@spec create_options(keyword() | map() | AntigravityCliSdk.Options.t()) ::
  {:ok, AntigravityCliSdk.Options.t()} | {:error, term()}

Builds and validates an %AntigravityCliSdk.Options{} struct.

execute(prompt, options \\ %Options{})

Streams typed Antigravity events for one prompt.

execute_text(prompt, options \\ %Options{})

@spec execute_text(String.t(), AntigravityCliSdk.Options.t()) ::
  {:ok, String.t()} | {:error, AntigravityCliSdk.Error.t()}

Alias for run/2, provided for ASM runtime-kit symmetry.

list_provider_sessions(opts \\ [])

@spec list_provider_sessions(keyword()) ::
  {:ok, [term()]} | {:error, AntigravityCliSdk.Error.t()}

Lists known Antigravity provider sessions.

The current agy --print surface does not expose a portable session-list command, so this returns an empty list while preserving the SDK contract.

run(prompt, options \\ %Options{})

@spec run(String.t(), AntigravityCliSdk.Options.t()) ::
  {:ok, String.t()} | {:error, AntigravityCliSdk.Error.t()}

Executes one prompt and returns the completed assistant text.

start_session(opts)

@spec start_session(keyword()) ::
  {:ok, pid(),
   %{info: map(), projection_state: map(), temp_dir: String.t() | nil}}
  | {:error, term()}

Starts a supervised SDK session.