ic_rooms_read
ActiveTool of Immersive Commons
declared in 1.31.0
Read a room's committed turns from a cursor — the durable catch-up read, so a late joiner (or any poll) gets the full prior history. Args: { room_id: string, since?: number (stream seq to read from, default 0 = all), channel?: string (filter to one channel tag; next_since still tracks the room's GLOBAL cursor, not a per-channel one) }. Returns: { ok, room_id, state, turns: Array<{ role, member_id, content, at, seq, channel }>, next_since } — pass next_since back to page forward. Readable on live AND torn-down rooms (the log outlives the mesh). Required scope: rooms:join (ic-member+).
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"room_id"
],
"properties": {
"since": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Stream seq to read from (default 0 = full history)."
},
"channel": {
"type": "string",
"maxLength": 24,
"minLength": 1,
"description": "Filter to one multi-channel room's channel tag."
},
"room_id": {
"type": "string",
"maxLength": 80,
"minLength": 3
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Immersive Commons
https://github.com/immersive-commons/ic-skills
1/7 registries