The byte channel between a MingaClaudeBridge.Session and one Claude Code process.
A transport starts the process, writes stdin lines, and reports stdout lines and exit to its owner. It knows nothing about the stream-json protocol beyond line framing. The session owns all protocol decisions.
Starting
start/1 receives a keyword list. The session always passes:
:owner- the pid that receives transport messages.:ref- a reference the transport puts in every message, so the owner can ignore messages from a transport it already replaced.:launch- a keyword list with the session's launch settings (:model,:effort,:resume). The transport turns them into CLI arguments.
The session also passes the transport options it was started with, unchanged.
Messages to the owner
The transport sends {:transport, ref, event} where event is one of:
{:line, binary}- one complete stdout line without its newline. Framing (joining{:noeol, _}fragments, the line size cap) happens inside the transport, for example withMingaClaudeBridge.LineBuffer.{:exit, status}- the process exited.statusis the exit status, or another term when the status is not known. No message follows it.{:error, reason}- the transport failed and the process cannot be used anymore, for example:line_too_long. The transport stops the process itself. No message follows it.
Lines carry conversation content. A transport must not log them.
Stopping
stop/2 stops the process and releases its resources. It must be safe to call after the process exited, and it must return within a bounded time. After stop/2 returns, the transport sends no more messages.
Linked processes
A transport may link a helper process to the owner. The session traps exits, and it treats an :EXIT with a reason other than :normal from any linked process as a transport failure.
Summary
Types
An opaque value the transport returns from start/1 and receives back in its other callbacks.
The message the owner receives.
Callbacks
Writes one line to stdin. line must end with a newline.
Starts the Claude Code process. See the module documentation for the options.
Stops the process. Safe to call more than once and after the process exited.
Types
Callbacks
Writes one line to stdin. line must end with a newline.
Starts the Claude Code process. See the module documentation for the options.
Stops the process. Safe to call more than once and after the process exited.