# minga_claude_bridge v0.1.0 - API Reference

## Modules

- [MingaClaudeBridge](MingaClaudeBridge.md): Minga extension that serves the Claude models of the user's Claude subscription through the `claude` CLI.
- [MingaClaudeBridge.Binary](MingaClaudeBridge.Binary.md): Finds the `claude` executable and reads its version.
- [MingaClaudeBridge.DebugLog](MingaClaudeBridge.DebugLog.md): Raw protocol logs for debugging, written only when `CLAUDE_BRIDGE_DEBUG=1`.
- [MingaClaudeBridge.Env](MingaClaudeBridge.Env.md): Computes the environment of a Claude Code child process.
- [MingaClaudeBridge.History](MingaClaudeBridge.History.md): Decides whether a Minga request continues the live Claude Code session or must start a fresh one.
- [MingaClaudeBridge.Launch](MingaClaudeBridge.Launch.md): Builds the `claude` command-line arguments for one session.
- [MingaClaudeBridge.LineBuffer](MingaClaudeBridge.LineBuffer.md): Joins Port line fragments into complete lines.
- [MingaClaudeBridge.MCP](MingaClaudeBridge.MCP.md): Routes the JSON-RPC messages of the in-process MCP server named `"minga"`.
- [MingaClaudeBridge.MCP.CallRequest](MingaClaudeBridge.MCP.CallRequest.md): A validated MCP `tools/call` request that Minga must run.
- [MingaClaudeBridge.MCP.Schema](MingaClaudeBridge.MCP.Schema.md): Prepares tool input schemas for Claude Code's MCP client.
- [MingaClaudeBridge.OsProcess](MingaClaudeBridge.OsProcess.md): Signals an operating-system process by pid and stops it within a bounded time.
- [MingaClaudeBridge.Route](MingaClaudeBridge.Route.md): The `MingaAgent.InferenceRoute` that serves Claude models through the user's Claude Code login.
- [MingaClaudeBridge.Route.Config](MingaClaudeBridge.Route.Config.md): The processes and settings `MingaClaudeBridge.Route` uses.
- [MingaClaudeBridge.Route.Mapping](MingaClaudeBridge.Route.Mapping.md): Pure conversions between Minga's route values (`MingaAgent.InferenceRoute.*`) and the bridge's session values.
- [MingaClaudeBridge.Route.PlanUsage](MingaClaudeBridge.Route.PlanUsage.md): Converts Claude Code's plan-usage data to Minga's `MingaAgent.InferenceRoute.PlanWindow` values.
- [MingaClaudeBridge.Route.Probe](MingaClaudeBridge.Route.Probe.md): Starts Claude Code without a prompt to read its `initialize` answer: the account, the models, and the version. No model request is made.
- [MingaClaudeBridge.Session](MingaClaudeBridge.Session.md): One Claude Code process serving one Minga conversation.
- [MingaClaudeBridge.Session.Event](MingaClaudeBridge.Session.Event.md): The events a `MingaClaudeBridge.Session` sends for one request, as `{ref, event}` messages.
- [MingaClaudeBridge.Session.Request](MingaClaudeBridge.Session.Request.md): One input to a `MingaClaudeBridge.Session`: a new prompt, or the results of the tool calls the previous request ended with.
- [MingaClaudeBridge.Session.State](MingaClaudeBridge.Session.State.md): The pure state machine of one `MingaClaudeBridge.Session`.
- [MingaClaudeBridge.Session.Turn](MingaClaudeBridge.Session.Turn.md): Accumulates the assistant messages Claude Code streams for one request.
- [MingaClaudeBridge.Status](MingaClaudeBridge.Status.md): Holds the route's last known readiness and plan limits, and reports changes to Minga.
- [MingaClaudeBridge.Supervisor](MingaClaudeBridge.Supervisor.md): The bridge's process tree, started as the extension's child.
- [MingaClaudeBridge.ToolCalls](MingaClaudeBridge.ToolCalls.md): Pairs held MCP `tools/call` control requests with the tool results Minga sends later.
- [MingaClaudeBridge.Transport](MingaClaudeBridge.Transport.md): The byte channel between a `MingaClaudeBridge.Session` and one Claude Code process.
- [MingaClaudeBridge.Transport.Port](MingaClaudeBridge.Transport.Port.md): The `MingaClaudeBridge.Transport` that runs the real `claude` executable through an Erlang Port.
- [MingaClaudeBridge.Version](MingaClaudeBridge.Version.md): The bridge's version.
- [MingaClaudeBridge.Wire](MingaClaudeBridge.Wire.md): Codec for Claude Code's stream-json protocol.
- [MingaClaudeBridge.Wire.Assistant](MingaClaudeBridge.Wire.Assistant.md): An `assistant` frame: a complete or partial assistant message.
- [MingaClaudeBridge.Wire.Block](MingaClaudeBridge.Wire.Block.md): Content blocks of Anthropic messages, as a tagged sum type.
- [MingaClaudeBridge.Wire.ControlCancel](MingaClaudeBridge.Wire.ControlCancel.md): A `control_cancel_request` frame: the sender withdraws the `control_request` with the same `request_id`. The receiver should stop work on that request and must not answer it.

- [MingaClaudeBridge.Wire.ControlRequest](MingaClaudeBridge.Wire.ControlRequest.md): A `control_request` frame. Claude Code sends these to the bridge (for example `mcp_message` and `can_use_tool`), and the bridge sends them to Claude Code (`initialize` and `interrupt`). Both directions share this shape, so outbound frames decode back to this struct.
- [MingaClaudeBridge.Wire.ControlResponse](MingaClaudeBridge.Wire.ControlResponse.md): A `control_response` frame: the answer to a `control_request`, in either direction.
- [MingaClaudeBridge.Wire.RateLimit](MingaClaudeBridge.Wire.RateLimit.md): A `rate_limit_event` frame: plan usage for Claude subscription accounts.
- [MingaClaudeBridge.Wire.Result](MingaClaudeBridge.Wire.Result.md): The `result` frame that ends each Claude Code turn.
- [MingaClaudeBridge.Wire.StopReason](MingaClaudeBridge.Wire.StopReason.md): Anthropic `stop_reason` values.
- [MingaClaudeBridge.Wire.StreamEvent](MingaClaudeBridge.Wire.StreamEvent.md): A `stream_event` frame: one Anthropic streaming event, emitted when Claude Code runs with `--include-partial-messages`.
- [MingaClaudeBridge.Wire.SystemInit](MingaClaudeBridge.Wire.SystemInit.md): The `system` frame with subtype `init`, which Claude Code emits when a session starts.
- [MingaClaudeBridge.Wire.Unknown](MingaClaudeBridge.Wire.Unknown.md): Any frame whose `type` the codec does not model, such as `keep_alive`, `system` frames other than `init`, or types added by a newer CLI.
- [MingaClaudeBridge.Wire.Usage](MingaClaudeBridge.Wire.Usage.md): Token counts from an Anthropic `usage` object.
- [MingaClaudeBridge.Wire.User](MingaClaudeBridge.Wire.User.md): A `user` frame: a user message, either one Claude Code echoes or replays, or one the bridge sends.
- [MingaClaudeBridge.Workdir](MingaClaudeBridge.Workdir.md): Private directories the bridge owns: the empty working directory of each `claude` process, and the debug log directory.

