# `Minga.Extension.AgentAPI`
[🔗](https://github.com/jsmestad/minga/blob/main/sdk/lib/minga/extension/agent_api.ex#L1)

Read-only facade for querying agent session state from extensions.

This is a compile-time stub. At runtime, the real module in Minga's
BEAM VM provides the implementation.

# `session_info`

```elixir
@type session_info() :: %{
  id: String.t(),
  pid: pid(),
  status: :idle | :plan | :thinking | :tool_executing | :error,
  label: String.t(),
  model: String.t(),
  active_tool: String.t() | nil,
  created_at: DateTime.t(),
  cost: float(),
  input_tokens: non_neg_integer(),
  output_tokens: non_neg_integer(),
  turn_count: non_neg_integer(),
  files_touched: [String.t()]
}
```

# `session_summary`

```elixir
@type session_summary() :: %{
  id: String.t(),
  pid: pid(),
  status: :idle | :plan | :thinking | :tool_executing | :error,
  label: String.t(),
  model: String.t(),
  active_tool: String.t() | nil,
  created_at: DateTime.t()
}
```

# `list_sessions`

```elixir
@spec list_sessions(keyword()) :: [session_summary()]
```

# `session_info`

```elixir
@spec session_info(pid(), keyword()) ::
  {:ok, session_info()} | {:error, :not_found | :unavailable}
```

# `subscribe`

```elixir
@spec subscribe() :: :ok
```

# `subscribe_edits`

```elixir
@spec subscribe_edits() :: :ok
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
