Files
OneCAD-Draft/src/io/line_read.rs
T
Karim Jerbi be8a7b95c4 fix(io): cap line reads on the serve and MCP transports
Bug:
The --serve automation loop (stdin/socket) and the MCP stdio loop read
input with unbounded read_line/lines. A single line over 64 MiB - a
huge paste or a hostile client - grows the buffer until the allocator
aborts, the same class of failure as the HTTP path, on the non-HTTP
transports.

Reproduce:
1. Start --serve on a socket (or the MCP server on stdio).
2. Send one 65 MiB line with no terminating newline anywhere in it.
3. Before: RSS grows to the full line, then "memory allocation failed"
   (or a multi-second stall while the line is copied).
4. After: the read fails at the cap and the existing EOF arm closes the
   connection/stdio promptly.

Fix:
New shared src/io/line_read.rs module: lines_capped(reader, 64 MiB)
yields Err for an over-cap line, which the serve and MCP loops already
treat as EOF/close. rest.rs was refactored onto the same helpers so the
cap logic lives in one place. A regression test streams a 65 MiB line
at the serve socket and asserts the connection ends without a response.
2026-09-30 19:15:49 +01:00

107 lines
3.4 KiB
Rust

//! Bounded line reads for the JSON-lines wire protocols (`--serve`, `--mcp`).
//!
//! `BufRead::read_line` — and the `.lines()` iterator built on it — grow
//! their `String` by doubling with no ceiling, so a peer streaming one line
//! without a newline pushes the allocation until the process dies: an
//! allocation failure is an *abort*, not a catchable panic. The REST
//! transport learned this the hard way (`src/rest.rs`); this module is the
//! shared ceiling for every other line-oriented channel.
//!
//! The cap matches the plugin IPC frame budget
//! (`MAX_MESSAGE_SIZE = 64 MiB` in `crates/ocs_plugin_api`): generous enough
//! that no legitimate message (base64 images included) is refused, small
//! enough that memory stays bounded.
use std::io::{BufRead, Read};
/// Upper bound for one protocol line, newline included.
pub const MAX_LINE_BYTES: usize = 64 * 1024 * 1024;
/// Marker for a line that exceeded its size cap. Kept as a distinct error
/// payload so callers can tell "peer blew the cap" apart from transport
/// errors (reset, timeout) if they ever need to answer differently.
#[derive(Debug)]
pub struct LineTooLong;
impl std::fmt::Display for LineTooLong {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
f.write_str("line exceeds the size limit")
}
}
impl std::error::Error for LineTooLong {}
/// True for the cap violation [`read_line_capped`] raises.
pub fn is_line_too_long(error: &std::io::Error) -> bool {
error
.get_ref()
.map_or(false, |inner| inner.is::<LineTooLong>())
}
/// `BufRead::read_line` capped at `cap` bytes — the whole line including its
/// newline. The underlying read stops at `cap + 1` bytes, so memory stays
/// bounded no matter how much the peer streams; an over-cap line fails with
/// [`LineTooLong`] instead of growing `buf` forever.
pub fn read_line_capped(
reader: &mut impl BufRead,
buf: &mut String,
cap: usize,
) -> std::io::Result<usize> {
buf.clear();
let read = reader.by_ref().take(cap as u64 + 1).read_line(buf)?;
if read > cap {
return Err(std::io::Error::new(
std::io::ErrorKind::InvalidData,
LineTooLong,
));
}
Ok(read)
}
/// Iterator over [`read_line_capped`] results, trimming line endings exactly
/// like [`BufRead::lines`]. Yields `Err` — and then stops — for the first
/// over-cap line, so callers keep their existing read-error handling.
pub struct CappedLines<R> {
reader: R,
cap: usize,
done: bool,
}
pub fn lines_capped<R: BufRead>(reader: R, cap: usize) -> CappedLines<R> {
CappedLines {
reader,
cap,
done: false,
}
}
impl<R: BufRead> Iterator for CappedLines<R> {
type Item = std::io::Result<String>;
fn next(&mut self) -> Option<Self::Item> {
if self.done {
return None;
}
let mut buf = String::new();
match read_line_capped(&mut self.reader, &mut buf, self.cap) {
Ok(0) => {
self.done = true;
None
}
Ok(_) => {
if buf.ends_with('\n') {
buf.pop();
if buf.ends_with('\r') {
buf.pop();
}
}
Some(Ok(buf))
}
Err(error) => {
self.done = true;
Some(Err(error))
}
}
}
}