Log notifications (notifications/message) from inside a running tool.

On the modern (2026-07-28) era a client opts into log messages per request, with _meta["io.modelcontextprotocol/logLevel"]. Such a tools/call is answered over Streamable HTTP as a Server-Sent Events stream, and log/4 sends a notifications/message ahead of the response when level is at least as severe as the requested level:

handle fn conn, %{"query" => query} ->
  ConduitMcp.Log.log(conn, :info, %{"query" => "planning"}, logger: "sql")
  text(run(query))
end

The specification forbids log notifications for a request that did not ask for them, so log/4 sends nothing — and returns :ok — when the request carried no logLevel, when level is below it (ConduitMcp.Ctx.log?/2), and whenever there is no stream to send on: a legacy-era request (answered with a single JSON body), a client that did not accept text/event-stream, or a call running through ConduitMcp.Handler.handle_request/3. Tools can therefore call it unconditionally.

Never log credentials or other secrets: the client receives data as is.