# minga_sdk v0.1.0 - API Reference

## Modules

- [Minga.Events.BufferChangedEvent](Minga.Events.BufferChangedEvent.md): Payload for `:buffer_changed` events.
- [Minga.Events.BufferEvent](Minga.Events.BufferEvent.md): Payload for `:buffer_saved` and `:buffer_opened` events.

- Extension
  - [Minga.Buffer](Minga.Buffer.md): Public API for buffer operations.
  - [Minga.Buffer.EditDelta](Minga.Buffer.EditDelta.md): Describes a single edit applied to a buffer.
  - [Minga.Buffer.EditSource](Minga.Buffer.EditSource.md): Identifies who made an edit to a buffer.
  - [Minga.Events](Minga.Events.md): Event bus for subscribing to editor lifecycle events.
  - [Minga.Extension](Minga.Extension.md): Behaviour and DSL for Minga editor extensions.
  - [Minga.Extension.Agent](Minga.Extension.Agent.md): Agent surface for Minga extensions.
  - [Minga.Extension.Badge](Minga.Extension.Badge.md): Registry for extension-owned decorations on file tree entries and tabs.
  - [Minga.Extension.Diagnostics](Minga.Extension.Diagnostics.md): Sanctioned diagnostics surface for extensions.
  - [Minga.Extension.Editor](Minga.Extension.Editor.md): Editor surface for Minga extensions.
  - [Minga.Extension.Manifest](Minga.Extension.Manifest.md): Public declaration snapshot for an extension before runtime side effects run.
  - [Minga.Extension.Overlay](Minga.Extension.Overlay.md): Registry for extension-owned overlays on the editor surface.
  - [Minga.Extension.Panel](Minga.Extension.Panel.md): Registry for extension-owned panels in the editor.
  - [Minga.Extension.Storage](Minga.Extension.Storage.md): Sanctioned per-extension persistent storage.

- Model routes
  - [Minga.Extension.ModelRoutes](Minga.Extension.ModelRoutes.md): Registers model routes that run inside Minga's agent loop.
  - [MingaAgent.InferenceRoute](MingaAgent.InferenceRoute.md): Contract for a contributed model route that supplies model streams to Minga's native agent loop.
  - [MingaAgent.InferenceRoute.ConversationRef](MingaAgent.InferenceRoute.ConversationRef.md): Minga-owned identity of the conversation one route request belongs to, passed as `opts[:minga_conversation]`.
  - [MingaAgent.InferenceRoute.Credential](MingaAgent.InferenceRoute.Credential.md): The route's `routes.<route_id>.env` entry from `credentials.json`, passed as `Request.credential`.
  - [MingaAgent.InferenceRoute.Event](MingaAgent.InferenceRoute.Event.md): One event in a route's response stream. Emit a tool call only once its arguments are final. A stream without a finish event finishes with `:stop`; `{:finish, {:error, term}}` fails the request and Minga passes `term` to `classify_error/1`.
  - [MingaAgent.InferenceRoute.Message](MingaAgent.InferenceRoute.Message.md): One conversation message sent to a route. The system prompt travels in `Request.system`.
  - [MingaAgent.InferenceRoute.Model](MingaAgent.InferenceRoute.Model.md): One model a contributed route offers. Minga fixes these fields into the selection policy.
  - [MingaAgent.InferenceRoute.Options](MingaAgent.InferenceRoute.Options.md): Request options a route can act on: the output token cap and the selected reasoning level.
  - [MingaAgent.InferenceRoute.PlanWindow](MingaAgent.InferenceRoute.PlanWindow.md): One subscription limit window a route reports through `Minga.Extension.ModelRoutes.report_usage/3`.
  - [MingaAgent.InferenceRoute.Reporter](MingaAgent.InferenceRoute.Reporter.md): Capability returned by `Minga.Extension.ModelRoutes.register/2` to report one route's status from any process.
  - [MingaAgent.InferenceRoute.Request](MingaAgent.InferenceRoute.Request.md): Everything a route receives for one model request. `tools` is empty for `:summary` and `:title` requests.
  - [MingaAgent.InferenceRoute.Response](MingaAgent.InferenceRoute.Response.md): A route's streaming reply: a lazy enumerable of `MingaAgent.InferenceRoute.Event` values and a cancel function.
  - [MingaAgent.InferenceRoute.SetupAction](MingaAgent.InferenceRoute.SetupAction.md): An optional setup row a route shows in `/model`. Selecting it runs the route's `availability/2` check.
  - [MingaAgent.InferenceRoute.Spec](MingaAgent.InferenceRoute.Spec.md): Source-owned declaration of one contributed model route. `short_name` is the optional name used inside sentences, such as "Claude"; without it, sentences use `display_name`.
  - [MingaAgent.InferenceRoute.Status](MingaAgent.InferenceRoute.Status.md): Last known readiness and plan usage of one contributed route. `plan_usage` is nil when the route has reported no usage.
  - [MingaAgent.InferenceRoute.ToolCall](MingaAgent.InferenceRoute.ToolCall.md): One complete tool call. `arguments` is a decoded map. Minga runs the call; a route never does.
  - [MingaAgent.InferenceRoute.ToolDeclaration](MingaAgent.InferenceRoute.ToolDeclaration.md): A tool the model may call. `input_schema` is a JSON Schema map with string keys.
  - [MingaAgent.InferenceRoute.Usage](MingaAgent.InferenceRoute.Usage.md): Token usage a route reports for one request. Counts default to 0.

- Editor
  - [MingaEditor.Extension.EditorAPI](MingaEditor.Extension.EditorAPI.md): High-level editor actions for extensions.
  - [MingaEditor.Extension.EventHandler](MingaEditor.Extension.EventHandler.md): Contract for synchronous runtime editor events declared by an extension.
  - [MingaEditor.Extension.Sidebar](MingaEditor.Extension.Sidebar.md): Compile-time SDK stub for source-owned sidebar contributions.
  - [MingaEditor.Extension.Sidebar.Snapshot](MingaEditor.Extension.Sidebar.Snapshot.md): Compile-time SDK struct for cached sidebar snapshots.

- Agent
  - [Minga.Extension.AI](Minga.Extension.AI.md): Sanctioned text-generation helper for extensions.
  - [Minga.Extension.AgentAPI](Minga.Extension.AgentAPI.md): Read-only facade for querying agent session state from extensions.

