@spec cancel(
  String.t(),
  keyword()
) :: result(Gemini.Types.Interactions.Interaction.t())

Cancel a background interaction by id.

@spec create(
  Gemini.Types.Interactions.Input.t(),
  keyword()
) :: result(Gemini.Types.Interactions.Interaction.t() | Enumerable.t())

Create a new interaction.

Required options

Provide either:

• model: "..." (model-based), or
• agent: "..." (agent-based)

Streaming

• stream: true returns {:ok, stream} where stream yields InteractionSSEEvent variants.
• Stream ends when the server sends [DONE] (independent of interaction.complete).

@spec delete(
  String.t(),
  keyword()
) :: :ok | {:error, Gemini.Error.t() | term()}

Delete an interaction by id.

@spec get(
  String.t(),
  keyword()
) :: result(Gemini.Types.Interactions.Interaction.t() | Enumerable.t())

Get an interaction by id.

If stream: true, returns an SSE stream. Resumption uses last_event_id.

@spec wait_for_completion(
  String.t(),
  keyword()
) :: result(Gemini.Types.Interactions.Interaction.t())

Poll an interaction until it reaches a terminal state.

Options:

• :poll_interval_ms (default: 2000)
• :timeout_ms (default: 300000)
• :on_status optional callback fn(Interaction.t()) -> any()
• plus all get/2 options (auth, api_version, timeout, etc.)