tv.fangorn.network

await-viewer-signal

Wait until the viewer DOES something, and return what it was. Blocks — this is a subscription, not a poll. Signals: `skip` (left a slot early — the strongest negative this surface produces), `finished` (sat through one), `like`/`dislike` (rated it), `channel`, `tuned`. Returns null if nothing happens before the timeout, which means they are still watching and is not an error. Call it again with `after` set to the last `seq` you saw to avoid missing anything in between.

Input schema

{
  "type": "object",
  "properties": {
    "seconds": {
      "type": "number",
      "description": "How long to wait before giving up (default 45, max 120)"
    },
    "after": {
      "type": "number",
      "description": "Only signals newer than this `seq`"
    }
  }
}