rdt-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdt-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: A CLI for Reddit — browse feeds, read posts, search, and interact via terminal 📖
 Project-URL: Homepage, https://github.com/jackwener/rdt-cli
 Project-URL: Repository, https://github.com/jackwener/rdt-cli
@@ -45,10 +45,11 @@ A CLI for Reddit — browse feeds, read posts, search, and interact via reverse-
 - 🏠 **Feed** — browse home feed, popular, and /r/all
 - 📋 **Subreddits** — browse any subreddit with sort/time filters, view subreddit info
 - 📰 **Posts** — read posts and comment trees with syntax highlighting
+- 💬 **Expanded comments** — `--expand-more` loads additional `more comments` entries
 - 🔢 **Short-index navigation** — `rdt show 3` to read, `rdt open 3` to browser
 - 🔍 **Search** — full-text search with subreddit, sort, and time filters
 - 📤 **Export** — export search results to CSV or JSON; `-o file.json` on any listing
-- 👤 **Users** — view user profiles and post history
+- 👤 **Users** — view user profiles, post history, comment history, saved and upvoted items
 - ⬆️ **Interactions** — upvote/downvote, save/unsave, subscribe/unsubscribe, comment (with 1.5-4s rate-limit delay)
 - 🛡️ **Anti-detection** — consistent Chrome 133 fingerprint, `sec-ch-ua` alignment, Gaussian jitter, exponential backoff
 - 📊 **Structured output** — `--yaml`, `--json`, `--output FILE`, `--compact`, `--full-text`
@@ -102,6 +103,9 @@ rdt sub programming -s top -t week    # Sort + time filter
 rdt sub-info python                   # Subreddit info (subscribers, etc.)
 rdt user spez                         # User profile
 rdt user-posts spez                   # User's submitted posts
+rdt user-comments spez                # User's comments
+rdt saved                             # Your saved posts/items
+rdt upvoted                           # Your upvoted posts
 
 # Short index works after list commands (feed/popular/sub/search)
 rdt sub python
@@ -111,7 +115,9 @@ rdt upvote 1                          # Upvote post #1
 
 # ─── Reading ──────────────────────────────────────
 rdt read 1abc123                      # Read post by ID
+rdt read 1abc123 --expand-more        # Expand top-level "more comments"
 rdt show 3                            # Read result #3 from last listing
+rdt show 3 --expand-more              # Expand additional comments from cache-backed post
 rdt show 1 -s top                     # Sort comments by top
 rdt open 3                            # Open in browser
 
@@ -226,7 +232,7 @@ rdt_cli/
 └── commands/
     ├── _common.py        # Shared helpers (envelope, output routing, formatters)
     ├── auth.py           # login, logout, status, whoami
-    ├── browse.py         # feed, popular, all, sub, sub-info, user, user-posts, open
+    ├── browse.py         # feed, popular, all, sub, sub-info, user, user-posts, user-comments, saved, upvoted, open
     ├── post.py           # read, show
     ├── search.py         # search, export
     └── social.py         # upvote, save, subscribe, comment
@@ -291,10 +297,11 @@ The built-in Gaussian jitter delay (~1s between requests) is intentional to mimi
 - 🏠 **浏览** — 首页 Feed、Popular、/r/all
 - 📋 **子版块** — 浏览任意 subreddit（排序/时间过滤），查看子版块信息
 - 📰 **帖子** — 阅读帖子和评论树
+- 💬 **评论展开** — `--expand-more` 可展开额外评论
 - 🔢 **短索引导航** — `rdt show 3` 阅读、`rdt open 3` 浏览器打开
 - 🔍 **搜索** — 全文搜索，支持子版块、排序、时间过滤
 - 📤 **导出** — 搜索结果导出为 CSV 或 JSON
-- 👤 **用户** — 查看用户资料和发帖历史
+- 👤 **用户** — 查看用户资料、发帖历史、评论历史、收藏和点赞记录
 - ⬆️ **互动** — 点赞/踩、收藏、订阅、评论
 - 🛡️ **反风控** — Chrome 133 指纹一致性、高斯抖动延迟、指数退避重试
 - 📊 **结构化输出** — `--yaml` / `--json`，非 TTY 默认输出 YAML
@@ -341,10 +348,17 @@ rdt all                               # /r/all
 rdt sub python                        # 浏览子版块
 rdt sub programming -s top -t week    # 排序 + 时间过滤
 rdt sub-info python                   # 子版块信息
+rdt user spez                         # 用户资料
+rdt user-posts spez                   # 用户发帖
+rdt user-comments spez                # 用户评论
+rdt saved                             # 你的收藏
+rdt upvoted                           # 你的点赞
 
 # 阅读
 rdt read 1abc123                      # 按 ID 阅读帖子
+rdt read 1abc123 --expand-more        # 展开更多评论
 rdt show 3                            # 阅读最近一次列表里的第 3 条
+rdt show 3 --expand-more              # 展开缓存帖子里的更多评论
 rdt open 3                            # 在浏览器打开
 
 # 搜索

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/README.md

@@ -22,10 +22,11 @@ A CLI for Reddit — browse feeds, read posts, search, and interact via reverse-
 - 🏠 **Feed** — browse home feed, popular, and /r/all
 - 📋 **Subreddits** — browse any subreddit with sort/time filters, view subreddit info
 - 📰 **Posts** — read posts and comment trees with syntax highlighting
+- 💬 **Expanded comments** — `--expand-more` loads additional `more comments` entries
 - 🔢 **Short-index navigation** — `rdt show 3` to read, `rdt open 3` to browser
 - 🔍 **Search** — full-text search with subreddit, sort, and time filters
 - 📤 **Export** — export search results to CSV or JSON; `-o file.json` on any listing
-- 👤 **Users** — view user profiles and post history
+- 👤 **Users** — view user profiles, post history, comment history, saved and upvoted items
 - ⬆️ **Interactions** — upvote/downvote, save/unsave, subscribe/unsubscribe, comment (with 1.5-4s rate-limit delay)
 - 🛡️ **Anti-detection** — consistent Chrome 133 fingerprint, `sec-ch-ua` alignment, Gaussian jitter, exponential backoff
 - 📊 **Structured output** — `--yaml`, `--json`, `--output FILE`, `--compact`, `--full-text`
@@ -79,6 +80,9 @@ rdt sub programming -s top -t week    # Sort + time filter
 rdt sub-info python                   # Subreddit info (subscribers, etc.)
 rdt user spez                         # User profile
 rdt user-posts spez                   # User's submitted posts
+rdt user-comments spez                # User's comments
+rdt saved                             # Your saved posts/items
+rdt upvoted                           # Your upvoted posts
 
 # Short index works after list commands (feed/popular/sub/search)
 rdt sub python
@@ -88,7 +92,9 @@ rdt upvote 1                          # Upvote post #1
 
 # ─── Reading ──────────────────────────────────────
 rdt read 1abc123                      # Read post by ID
+rdt read 1abc123 --expand-more        # Expand top-level "more comments"
 rdt show 3                            # Read result #3 from last listing
+rdt show 3 --expand-more              # Expand additional comments from cache-backed post
 rdt show 1 -s top                     # Sort comments by top
 rdt open 3                            # Open in browser
 
@@ -203,7 +209,7 @@ rdt_cli/
 └── commands/
     ├── _common.py        # Shared helpers (envelope, output routing, formatters)
     ├── auth.py           # login, logout, status, whoami
-    ├── browse.py         # feed, popular, all, sub, sub-info, user, user-posts, open
+    ├── browse.py         # feed, popular, all, sub, sub-info, user, user-posts, user-comments, saved, upvoted, open
     ├── post.py           # read, show
     ├── search.py         # search, export
     └── social.py         # upvote, save, subscribe, comment
@@ -268,10 +274,11 @@ The built-in Gaussian jitter delay (~1s between requests) is intentional to mimi
 - 🏠 **浏览** — 首页 Feed、Popular、/r/all
 - 📋 **子版块** — 浏览任意 subreddit（排序/时间过滤），查看子版块信息
 - 📰 **帖子** — 阅读帖子和评论树
+- 💬 **评论展开** — `--expand-more` 可展开额外评论
 - 🔢 **短索引导航** — `rdt show 3` 阅读、`rdt open 3` 浏览器打开
 - 🔍 **搜索** — 全文搜索，支持子版块、排序、时间过滤
 - 📤 **导出** — 搜索结果导出为 CSV 或 JSON
-- 👤 **用户** — 查看用户资料和发帖历史
+- 👤 **用户** — 查看用户资料、发帖历史、评论历史、收藏和点赞记录
 - ⬆️ **互动** — 点赞/踩、收藏、订阅、评论
 - 🛡️ **反风控** — Chrome 133 指纹一致性、高斯抖动延迟、指数退避重试
 - 📊 **结构化输出** — `--yaml` / `--json`，非 TTY 默认输出 YAML
@@ -318,10 +325,17 @@ rdt all                               # /r/all
 rdt sub python                        # 浏览子版块
 rdt sub programming -s top -t week    # 排序 + 时间过滤
 rdt sub-info python                   # 子版块信息
+rdt user spez                         # 用户资料
+rdt user-posts spez                   # 用户发帖
+rdt user-comments spez                # 用户评论
+rdt saved                             # 你的收藏
+rdt upvoted                           # 你的点赞
 
 # 阅读
 rdt read 1abc123                      # 按 ID 阅读帖子
+rdt read 1abc123 --expand-more        # 展开更多评论
 rdt show 3                            # 阅读最近一次列表里的第 3 条
+rdt show 3 --expand-more              # 展开缓存帖子里的更多评论
 rdt open 3                            # 在浏览器打开
 
 # 搜索

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/SKILL.md

@@ -51,7 +51,7 @@ Verify with:
 
 ```bash
 rdt status
-rdt whoami --json | jq '.data.name'
+rdt whoami --json | jq '.data.name // .data._session.username'
 ```
 
 ### Step 2: Handle common auth issues
@@ -88,6 +88,9 @@ Payloads live under `.data`.
 | `rdt sub-info <name>` | View subreddit info | `rdt sub-info rust --json` |
 | `rdt user <name>` | View user profile | `rdt user spez --json` |
 | `rdt user-posts <name>` | View user's posts | `rdt user-posts spez -n 5 --json` |
+| `rdt user-comments <name>` | View user's comments | `rdt user-comments spez -n 5 --json` |
+| `rdt saved` | View your saved items | `rdt saved -n 10 --json` |
+| `rdt upvoted` | View your upvoted posts | `rdt upvoted -n 10 --json` |
 | `rdt open <id_or_index>` | Open post in browser | `rdt open 3` |
 
 ### Reading
@@ -95,7 +98,9 @@ Payloads live under `.data`.
 | Command | Description | Example |
 |---------|-------------|---------|
 | `rdt read <post_id>` | Read a post + comments | `rdt read 1abc123 --json` |
-| `rdt show <index>` | Read by short-index | `rdt show 3 --full-text` |
+| `rdt read <post_id> --expand-more` | Expand top-level `more comments` | `rdt read 1abc123 --expand-more --json` |
+| `rdt show <index>` | Read by short-index | `rdt show 3` |
+| `rdt show <index> --expand-more` | Expand `more comments` from cached result | `rdt show 3 --expand-more --json` |
 | `rdt whoami` | View your profile (karma, age) | `rdt whoami --json` |
 
 ### Search & Export
@@ -131,7 +136,7 @@ Payloads live under `.data`.
 
 ## Listing Options
 
-All listing commands (feed, popular, all, sub, user-posts, search) support:
+All listing commands (feed, popular, all, sub, user-posts, user-comments, saved, upvoted, search) support:
 
 | Flag | Description |
 |------|-------------|
@@ -147,7 +152,7 @@ All listing commands (feed, popular, all, sub, user-posts, search) support:
 
 ```bash
 rdt sub python -s top -t week -n 5
-rdt show 1
+rdt show 1 --expand-more
 rdt upvote 1
 ```
 
@@ -170,6 +175,14 @@ rdt search "python tips" -n 20 --compact -o tips.json
 ```bash
 rdt user spez --json | jq '.data | {name, link_karma, comment_karma}'
 rdt user-posts spez -n 10 --compact --json
+rdt user-comments spez -n 10 --compact --json
+```
+
+### Saved / Upvoted review
+
+```bash
+rdt saved -n 20 --compact --json
+rdt upvoted -n 20 --compact --json
 ```
 
 ### Subreddit discovery

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rdt-cli"
-version = "0.2.0"
+version = "0.3.0"
 description = "A CLI for Reddit — browse feeds, read posts, search, and interact via terminal 📖"
 readme = "README.md"
 requires-python = ">=3.10"

rdt_cli-0.3.0/rdt_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Reddit CLI."""
+
+__version__ = "0.3.0"

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/rdt_cli/auth.py

@@ -30,19 +30,48 @@ _CREDENTIAL_TTL_SECONDS = CREDENTIAL_TTL_DAYS * 86400
 class Credential:
     """Holds Reddit session cookies."""
 
-    def __init__(self, cookies: dict[str, str]):
+    def __init__(
+        self,
+        cookies: dict[str, str],
+        *,
+        source: str = "unknown",
+        username: str | None = None,
+        modhash: str | None = None,
+        saved_at: float | None = None,
+        last_verified_at: float | None = None,
+    ):
         self.cookies = cookies
+        self.source = source
+        self.username = username
+        self.modhash = modhash
+        self.saved_at = saved_at
+        self.last_verified_at = last_verified_at
 
     @property
     def is_valid(self) -> bool:
         return bool(self.cookies)
 
     def to_dict(self) -> dict[str, Any]:
-        return {"cookies": self.cookies, "saved_at": time.time()}
+        saved_at = self.saved_at or time.time()
+        return {
+            "cookies": self.cookies,
+            "source": self.source,
+            "username": self.username,
+            "modhash": self.modhash,
+            "saved_at": saved_at,
+            "last_verified_at": self.last_verified_at,
+        }
 
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> Credential:
-        return cls(cookies=data.get("cookies", {}))
+        return cls(
+            cookies=data.get("cookies", {}),
+            source=data.get("source", "saved"),
+            username=data.get("username"),
+            modhash=data.get("modhash"),
+            saved_at=data.get("saved_at"),
+            last_verified_at=data.get("last_verified_at"),
+        )
 
     def as_cookie_header(self) -> str:
         return "; ".join(f"{k}={v}" for k, v in self.cookies.items())
@@ -54,6 +83,8 @@ class Credential:
 def save_credential(credential: Credential) -> None:
     """Save credential to disk with restricted permissions."""
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    if credential.saved_at is None:
+        credential.saved_at = time.time()
     CREDENTIAL_FILE.write_text(json.dumps(credential.to_dict(), indent=2, ensure_ascii=False))
     CREDENTIAL_FILE.chmod(0o600)
 
@@ -131,7 +162,7 @@ if cookies:
         if result.returncode == 0 and result.stdout.strip():
             cookies = json.loads(result.stdout.strip())
             if any(k in cookies for k in REQUIRED_COOKIES):
-                cred = Credential(cookies=cookies)
+                cred = Credential(cookies=cookies, source="browser:subprocess")
                 save_credential(cred)
                 return cred
     except Exception as e:
@@ -152,7 +183,7 @@ def _extract_direct() -> Credential | None:
             jar = fn(domain_name=".reddit.com")
             cookies = {c.name: c.value for c in jar}
             if any(k in cookies for k in REQUIRED_COOKIES):
-                cred = Credential(cookies=cookies)
+                cred = Credential(cookies=cookies, source=f"browser:{fn.__name__}")
                 save_credential(cred)
                 return cred
         except Exception:

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/rdt_cli/cli.py

@@ -5,7 +5,8 @@ Usage:
     rdt feed / popular / all / sub <subreddit>
     rdt read <post_id> / show <index> / open <id_or_index>
     rdt search <query> / export <query>
-    rdt user <username> / user-posts <username>
+    rdt user <username> / user-posts <username> / user-comments <username>
+    rdt saved / upvoted
     rdt upvote / save / subscribe / comment
 """
 
@@ -48,6 +49,9 @@ cli.add_command(browse.sub)
 cli.add_command(browse.sub_info)
 cli.add_command(browse.user)
 cli.add_command(browse.user_posts)
+cli.add_command(browse.user_comments)
+cli.add_command(browse.saved)
+cli.add_command(browse.upvoted)
 cli.add_command(browse.open_post)
 
 # ─── Post commands ───────────────────────────────────────────────────

{rdt_cli-0.2.0 → rdt_cli-0.3.0}/rdt_cli/client.py

@@ -3,19 +3,15 @@
 from __future__ import annotations
 
 import logging
-import random
-import time
 from typing import Any
 
-import httpx
-
+from .config import DEFAULT_CONFIG, RuntimeConfig
 from .constants import (
     ALL_URL,
-    BASE_URL,
     COMMENT_URL,
     DEFAULT_LIMIT,
-    HEADERS,
     HOME_URL,
+    MORECHILDREN_URL,
     POPULAR_URL,
     POST_COMMENTS_SHORT_URL,
     POST_COMMENTS_URL,
@@ -28,14 +24,16 @@ from .constants import (
     USER_ABOUT_URL,
     USER_COMMENTS_URL,
     USER_POSTS_URL,
+    USER_SAVED_URL,
+    USER_UPVOTED_URL,
     VOTE_URL,
 )
 from .exceptions import (
-    ForbiddenError,
-    NotFoundError,
     RedditApiError,
-    SessionExpiredError,
 )
+from .fingerprint import BrowserFingerprint
+from .session import SessionState
+from .transports import ReadTransport, WriteTransport
 
 logger = logging.getLogger(__name__)
 
@@ -62,125 +60,69 @@ class RedditClient:
         self._timeout = timeout
         self._request_delay = request_delay
         self._max_retries = max_retries
-        self._last_request_time = 0.0
-        self._request_count = 0
-        self._http: httpx.Client | None = None
-
-    def _build_client(self) -> httpx.Client:
-        cookies = {}
-        if self.credential:
-            cookies = self.credential.cookies
-        return httpx.Client(
-            base_url=BASE_URL,
-            headers=dict(HEADERS),
-            cookies=cookies,
-            follow_redirects=True,
-            timeout=httpx.Timeout(self._timeout),
+        self._config = RuntimeConfig(
+            timeout=timeout,
+            read_request_delay=request_delay,
+            write_request_delay=max(request_delay, DEFAULT_CONFIG.write_request_delay),
+            max_retries=max_retries,
+            status_check_timeout=min(timeout, DEFAULT_CONFIG.status_check_timeout),
         )
+        self._fingerprint = BrowserFingerprint.chrome133_mac()
+        self.session = SessionState.from_credential(credential)
+        self._read_transport: ReadTransport | None = None
+        self._write_transport: WriteTransport | None = None
+        self._http = None
 
     @property
-    def client(self) -> httpx.Client:
-        if not self._http:
+    def client(self):
+        if not self._read_transport:
             raise RuntimeError("Client not initialized. Use 'with RedditClient() as client:'")
-        return self._http
+        return self._read_transport.client
 
     def __enter__(self) -> RedditClient:
-        self._http = self._build_client()
+        self._read_transport = ReadTransport(
+            self.session,
+            config=self._config,
+            fingerprint=self._fingerprint,
+            request_delay=self._config.read_request_delay,
+        )
+        self._write_transport = WriteTransport(
+            self.session,
+            config=self._config,
+            fingerprint=self._fingerprint,
+            request_delay=self._config.write_request_delay,
+        )
+        self._http = self._read_transport.client
         return self
 
     def __exit__(self, *args: Any) -> None:
-        if self._http:
-            self._http.close()
-            self._http = None
+        if self._read_transport:
+            self._read_transport.close()
+            self._read_transport = None
+        if self._write_transport:
+            self._write_transport.close()
+            self._write_transport = None
+        self._http = None
 
     @property
     def request_stats(self) -> dict[str, int]:
-        return {"request_count": self._request_count}
-
-    # ── Rate limiting ───────────────────────────────────────────────
-
-    def _rate_limit_delay(self) -> None:
-        """Enforce minimum delay with Gaussian jitter to mimic human browsing."""
-        if self._request_delay <= 0:
-            return
-        elapsed = time.time() - self._last_request_time
-        if elapsed < self._request_delay:
-            jitter = max(0, random.gauss(0.3, 0.15))
-            if random.random() < 0.05:
-                jitter += random.uniform(2.0, 5.0)
-            time.sleep(self._request_delay - elapsed + jitter)
-
-    # ── Response cookies ────────────────────────────────────────────
-
-    def _merge_response_cookies(self, resp: httpx.Response) -> None:
-        """Merge Set-Cookie headers back into session jar."""
-        for name, value in resp.cookies.items():
-            if value:
-                self.client.cookies.set(name, value)
+        read_count = self._read_transport.request_count if self._read_transport else 0
+        write_count = self._write_transport.request_count if self._write_transport else 0
+        return {"request_count": read_count + write_count}
 
     # ── Core request ────────────────────────────────────────────────
 
     def _request(self, method: str, url: str, **kwargs: Any) -> Any:
-        """Rate-limited request with retry and cookie merge."""
-        self._rate_limit_delay()
-
-        last_exc: Exception | None = None
-        for attempt in range(self._max_retries):
-            t0 = time.time()
-            try:
-                resp = self.client.request(method, url, **kwargs)
-                elapsed = time.time() - t0
-                self._merge_response_cookies(resp)
-                self._request_count += 1
-                self._last_request_time = time.time()
-                logger.info(
-                    "[#%d] %s %s → %d (%.2fs)",
-                    self._request_count,
-                    method,
-                    url[:80],
-                    resp.status_code,
-                    elapsed,
-                )
-
-                # Retry on server errors
-                if resp.status_code == 429:
-                    retry_after = float(resp.headers.get("Retry-After", 5))
-                    logger.warning("Rate limited, waiting %.1fs", retry_after)
-                    time.sleep(retry_after)
-                    continue
-
-                if resp.status_code in (500, 502, 503, 504):
-                    wait = (2**attempt) + random.uniform(0, 1)
-                    logger.warning("HTTP %d, retrying in %.1fs", resp.status_code, wait)
-                    time.sleep(wait)
-                    continue
-
-                # Client errors
-                if resp.status_code == 401:
-                    raise SessionExpiredError()
-                if resp.status_code == 403:
-                    raise ForbiddenError()
-                if resp.status_code == 404:
-                    raise NotFoundError()
-
-                resp.raise_for_status()
-
-                # Reddit returns HTML on some error pages
-                text = resp.text
-                if text.strip().startswith("<"):
-                    raise RedditApiError("Received HTML instead of JSON (possible auth redirect)")
-
-                return resp.json()
-
-            except (httpx.TimeoutException, httpx.NetworkError) as exc:
-                last_exc = exc
-                wait = (2**attempt) + random.uniform(0, 1)
-                logger.warning("Network error: %s, retrying in %.1fs", exc, wait)
-                time.sleep(wait)
-
-        if last_exc:
-            raise RedditApiError(f"Request failed after {self._max_retries} retries: {last_exc}") from last_exc
-        raise RedditApiError(f"Request failed after {self._max_retries} retries")
+        """Read request through the low-risk transport."""
+        if not self._read_transport:
+            raise RuntimeError("Client not initialized. Use 'with RedditClient() as client:'")
+        return self._read_transport.request(method, url, **kwargs)
+
+    def _write_request(self, method: str, url: str, **kwargs: Any) -> Any:
+        """Write request through the authenticated transport."""
+        if not self._write_transport:
+            raise RuntimeError("Client not initialized. Use 'with RedditClient() as client:'")
+        return self._write_transport.request(method, url, **kwargs)
 
     def _get(self, url: str, params: dict[str, Any] | None = None) -> Any:
         """GET request."""
@@ -188,7 +130,7 @@ class RedditClient:
 
     def _post(self, url: str, data: dict[str, Any] | None = None) -> Any:
         """POST request."""
-        return self._request("POST", url, data=data)
+        return self._write_request("POST", url, data=data)
 
     # ── Listing helpers ─────────────────────────────────────────────
 
@@ -273,6 +215,26 @@ class RedditClient:
         params: dict[str, Any] = {"sort": sort, "limit": limit, "raw_json": 1}
         return self._get(url, params=params)
 
+    def get_more_comments(
+        self,
+        post_id: str,
+        children: list[str],
+        *,
+        sort: str = "best",
+    ) -> dict:
+        """Expand additional comments for a post."""
+        if not children:
+            return {"json": {"data": {"things": []}}}
+        params: dict[str, Any] = {
+            "api_type": "json",
+            "link_id": f"t3_{post_id}",
+            "children": ",".join(children),
+            "sort": sort,
+            "limit_children": False,
+            "raw_json": 1,
+        }
+        return self._get(MORECHILDREN_URL, params=params)
+
     # ── Search ──────────────────────────────────────────────────────
 
     def search(
@@ -322,16 +284,49 @@ class RedditClient:
             params["after"] = after
         return self._get(USER_COMMENTS_URL.format(username=username), params=params)
 
+    def get_user_saved(self, username: str, limit: int = DEFAULT_LIMIT, after: str | None = None) -> dict:
+        """Get user's saved items."""
+        params: dict[str, Any] = {"limit": limit, "raw_json": 1}
+        if after:
+            params["after"] = after
+        return self._get(USER_SAVED_URL.format(username=username), params=params)
+
+    def get_user_upvoted(self, username: str, limit: int = DEFAULT_LIMIT, after: str | None = None) -> dict:
+        """Get user's upvoted items."""
+        params: dict[str, Any] = {"limit": limit, "raw_json": 1}
+        if after:
+            params["after"] = after
+        return self._get(USER_UPVOTED_URL.format(username=username), params=params)
+
     # ── Identity (requires auth) ────────────────────────────────────
 
     def get_me(self) -> dict:
-        """Get current user info. Uses oauth.reddit.com."""
-        # For the .json API, we try /api/v1/me or fallback to username based
+        """Get current user info and enrich session capabilities."""
+        data = self._get("/api/me.json", params={"raw_json": 1})
+        if isinstance(data, dict):
+            self.session.apply_identity(data)
+        return data
+
+    def validate_session(self) -> dict[str, Any]:
+        """Probe a lightweight auth endpoint to classify current credential."""
         try:
-            return self._get("/api/me.json", params={"raw_json": 1})
-        except RedditApiError:
-            # Fallback: try to get identity from cookie-based session
-            return {"error": "Identity endpoint requires OAuth token"}
+            identity = self.get_me()
+            return {
+                "authenticated": True,
+                "username": self.session.username,
+                "capabilities": sorted(self.session.capabilities),
+                "modhash_present": bool(self.session.modhash),
+                "identity": identity,
+            }
+        except RedditApiError as exc:
+            self.session.apply_validation_error(str(exc))
+            return {
+                "authenticated": False,
+                "username": self.session.username,
+                "capabilities": sorted(self.session.capabilities),
+                "modhash_present": bool(self.session.modhash),
+                "error": str(exc),
+            }
 
     # ── Write actions (require authentication) ──────────────────────