2.4.1: monitor billing in the docs (every check is 1 credit)

Since 2026-10-01 every monitor check costs 1 credit whether or not it finds
new videos, and so does the read at creation that records what is already
there; a failed listing stays free. The README and the create/check
docstrings still said the baseline and quiet checks were free.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V2tZj5bJ3BQgp5mK97hq1A

Author: Chandler Casey

CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project are documented here. This project adheres to
 [Semantic Versioning](https://semver.org).
 
+## [2.4.1] - 2026-10-02
+
+### Fixed
+
+- Monitor billing in the README and the `create` / `check` docstrings. Since
+  2026-10-01 every monitor check costs 1 credit whether or not it finds new
+  videos, and so does the read at creation that records what is already there;
+  a check whose listing fails stays free. The docs still described the old
+  rules (free baseline, free quiet checks). No code changes.
+
 ## [2.4.0] - 2026-09-27
 
 ### Added

README.md

@@ -80,10 +80,12 @@ res = tf.transcripts.batch(ids, mode="captions")   # captions only, no audio fal
 ## Monitors (2.4.0+)
 
 Watch a YouTube channel or a TikTok/Instagram profile for new videos. Creation
-records a free baseline and starts scheduled checks; existing videos are skipped.
-Checks with no new videos are free. A check finding videos costs 1 credit, plus
-transcript charges when enabled. See [monitor docs](https://transcriptfetch.com/docs/monitors)
-for plan limits, audio billing, retention and webhook verification.
+reads the target once to record what is already there (existing videos are
+skipped) and starts scheduled checks. Every check costs 1 credit whether or not
+it finds new videos, and so does that first read; caption transcripts cost 1
+credit more each when enabled. A check whose listing fails is free. See
+[monitor docs](https://transcriptfetch.com/docs/monitors) for plan limits, audio
+billing, retention and webhook verification.
 
 ```python
 with TranscriptFetch(timeout=120) as tf:
@@ -101,7 +103,7 @@ with TranscriptFetch(timeout=120) as tf:
     tf.monitors.update(monitor.id, webhook_url=None, name=None, transcripts=False)
     # Omitted settings stay unchanged. None clears webhook_url/name.
     tf.monitors.update(monitor.id, status="active")
-    checked = tf.monitors.check(monitor.id)  # may spend credits
+    checked = tf.monitors.check(monitor.id)  # 1 credit, found or not
     if checked.error:  # listing failure, even with HTTP 200
         print(checked.error)
     tf.monitors.delete(monitor.id)  # removes events too

src/transcriptfetch/_version.py

@@ -1 +1 @@
-__version__ = "2.4.0"
+__version__ = "2.4.1"

src/transcriptfetch/resources/monitors.py

@@ -71,8 +71,9 @@ def create(
     ) -> Monitor:
         """Create a scheduled monitor. Save webhook_secret: it is only returned here.
 
-        Baseline is free; existing videos are skipped. Checks finding new videos
-        cost credits. tab selects a YouTube uploads/Shorts/live feed only.
+        Creation reads the target once (1 credit) and skips the videos already
+        there. Every later check costs 1 credit whether or not it finds new
+        videos. tab selects a YouTube uploads/Shorts/live feed only.
         """
         body = {
             key: value
@@ -131,7 +132,7 @@ def delete(self, monitor_id: str) -> MonitorDeleted:
         return MonitorDeleted.model_validate(env["data"])
 
     def check(self, monitor_id: str, *, idempotency_key: Optional[str] = None) -> MonitorCheck:
-        """Check now, even when paused. New videos cost credits. Inspect result.error."""
+        """Check now, even when paused: 1 credit, found or not. Inspect result.error."""
         env = self._c._request(
             "POST", _path(monitor_id) + "/check", idempotent=True, idempotency_key=idempotency_key
         )
@@ -187,8 +188,9 @@ async def create(
     ) -> Monitor:
         """Create a scheduled monitor. Save webhook_secret: it is only returned here.
 
-        Baseline is free; existing videos are skipped. Checks finding new videos
-        cost credits. tab selects a YouTube uploads/Shorts/live feed only.
+        Creation reads the target once (1 credit) and skips the videos already
+        there. Every later check costs 1 credit whether or not it finds new
+        videos. tab selects a YouTube uploads/Shorts/live feed only.
         """
         body = {
             key: value
@@ -249,7 +251,7 @@ async def delete(self, monitor_id: str) -> MonitorDeleted:
     async def check(
         self, monitor_id: str, *, idempotency_key: Optional[str] = None
     ) -> MonitorCheck:
-        """Check now, even when paused. New videos cost credits. Inspect result.error."""
+        """Check now, even when paused: 1 credit, found or not. Inspect result.error."""
         env = await self._c._request(
             "POST", _path(monitor_id) + "/check", idempotent=True, idempotency_key=idempotency_key
         )