Constant STREAM_READ_HARD_CAP 

pub const STREAM_READ_HARD_CAP: u64 = 10_000; // 10_000u64

Maximum frames per read/tail call. Mirrors ff_core::contracts::STREAM_READ_HARD_CAP — re-exported here so SDK callers don’t need to import ff-core just to read the bound. Hard cap on the number of frames returned by a single read/tail call.

Single source of truth across the Rust layer (ff-script, ff-server, ff-sdk). The Lua side in lua/stream.lua keeps a matching literal with an inline reference back here; bump both together if you ever need to lift the cap.