scholarinboxcli 0.1.1__tar.gz → 0.1.3__tar.gz

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-02-04
+
+### Changed
+
+- Updated project tagline to emphasize humans + agents use case.
+
+## [0.1.2] - 2026-02-04
+
+### Added
+
+- Added collection-aware paper formatting for bookmark and collection views.
+- Added tests for bookmark collection lookup and collection paper formatting.
+- Added dev tooling dependencies for pytest and ruff.
+
+### Changed
+
+- Bookmarks now resolve the "Bookmarks" collection and load papers via `/api/get_collections`.
+- Collection paper retrieval prefers `/api/get_collections` with fallback to legacy endpoints.
+- Cleaned up minor lint issues and restored `_resolve_collection_id` export for tests.
+
 ## [0.1.1] - 2026-02-01
 
 ### Added
@@ -54,6 +74,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Tracked Python bytecode artifacts (`.pyc`) removed from repository history and ignored via `.gitignore`.
 
-[Unreleased]: https://github.com/mrshu/scholarinboxcli/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/mrshu/scholarinboxcli/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/mrshu/scholarinboxcli/releases/tag/v0.1.3
+[0.1.2]: https://github.com/mrshu/scholarinboxcli/releases/tag/v0.1.2
 [0.1.1]: https://github.com/mrshu/scholarinboxcli/releases/tag/v0.1.1
 [0.1.0]: https://github.com/mrshu/scholarinboxcli/releases/tag/v0.1.0

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: scholarinboxcli
-Version: 0.1.1
-Summary: CLI for Scholar Inbox (authenticated web API)
+Version: 0.1.3
+Summary: Scholar Inbox CLI for digests, search, collections, and bookmarks, for humans and agents alike
 License-Expression: MIT
 License-File: LICENSE
 Keywords: bibliography,cli,research,scholar
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # scholarinboxcli
 
-CLI for Scholar Inbox, for humans and agents alike.
+Scholar Inbox CLI: digests, search, collections, and bookmarks for humans and agents alike.
 
 ## Installation
 
@@ -122,6 +122,12 @@ scholarinboxcli collection papers 10759
 # Similar papers for one or more collections
 scholarinboxcli collection similar 10759 12345
 
+# Optional local sorting for display (e.g., newest first)
+scholarinboxcli collection similar "AIAgents" --sort year
+
+# Sort ascending instead
+scholarinboxcli collection similar "AIAgents" --sort year --asc
+
 # You can also use collection names (case-insensitive). The CLI will
 # automatically fetch collection ID mappings from the API when needed.
 scholarinboxcli collection papers "AIAgents"
@@ -129,6 +135,7 @@ scholarinboxcli collection similar "AIAgents" "Benchmark"
 ```
 
 Collection name matching is exact → prefix → contains. If multiple matches exist, the CLI reports ambiguity and shows candidate IDs.
+`collection similar` supports client-side sorting with `--sort year|title` and optional `--asc`.
 
 ## Search
 
@@ -185,59 +192,12 @@ scholarinboxcli collection papers "AIAgents" --json
 scholarinboxcli search "diffusion" --json
 ```
 
-## Tested (2026-02-01)
-
-The following commands were exercised against the live API (with a valid magic-link login) to confirm behavior:
-
-```bash
-scholarinboxcli --help
-scholarinboxcli auth status --json
-scholarinboxcli digest --date 01-30-2026 --json
-scholarinboxcli trending --category ALL --days 7 --json
-scholarinboxcli search "transformers" --limit 5 --json
-scholarinboxcli semantic "graph neural networks" --limit 5 --json
-scholarinboxcli interactions --type all --json
-scholarinboxcli bookmark list --json
-scholarinboxcli bookmark add 3302478 --json
-scholarinboxcli bookmark remove 3302478 --json
-scholarinboxcli collection list --json
-scholarinboxcli collection list --expanded --json
-scholarinboxcli collection papers "AIAgents" --json
-scholarinboxcli collection similar "AIAgents" --json
-scholarinboxcli conference list --json
-scholarinboxcli conference explore --json
-```
-
 ## Notes
 
 - Some collection mutations (create/rename/delete/add/remove) rely on best-effort endpoints that may change on the service side. If a mutation fails, try again or use the web UI to validate the current behavior.
+- Bookmarks are stored as a dedicated collection named "Bookmarks" in the web app; `bookmark list` pulls that collection via `/api/get_collections`.
 - Similar papers for collections uses the server endpoint used by the web UI. Results typically appear under `digest_df` in JSON responses.
 
-## Publish to PyPI
-
-```bash
-# 1) Build sdist + wheel
-uv run --with build python -m build
-
-# 2) Validate metadata/rendering
-uvx twine check dist/*
-
-# 3) (Optional) test publish first
-uvx twine upload --repository testpypi dist/*
-
-# 4) Publish to PyPI
-uvx twine upload dist/*
-```
-
-If using an API token:
-
-```bash
-export TWINE_USERNAME=__token__
-export TWINE_PASSWORD=<your-pypi-token>
-```
-
-Automated publish is also configured via GitHub Actions:
+## License
 
-- Workflow: `.github/workflows/publish.yml`
-- Trigger: push a tag matching `v*` (for example `v0.1.1`)
-- Auth: PyPI Trusted Publishing (OIDC)
+MIT. See `LICENSE`.

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/README.md

@@ -1,6 +1,6 @@
 # scholarinboxcli
 
-CLI for Scholar Inbox, for humans and agents alike.
+Scholar Inbox CLI: digests, search, collections, and bookmarks for humans and agents alike.
 
 ## Installation
 
@@ -100,6 +100,12 @@ scholarinboxcli collection papers 10759
 # Similar papers for one or more collections
 scholarinboxcli collection similar 10759 12345
 
+# Optional local sorting for display (e.g., newest first)
+scholarinboxcli collection similar "AIAgents" --sort year
+
+# Sort ascending instead
+scholarinboxcli collection similar "AIAgents" --sort year --asc
+
 # You can also use collection names (case-insensitive). The CLI will
 # automatically fetch collection ID mappings from the API when needed.
 scholarinboxcli collection papers "AIAgents"
@@ -107,6 +113,7 @@ scholarinboxcli collection similar "AIAgents" "Benchmark"
 ```
 
 Collection name matching is exact → prefix → contains. If multiple matches exist, the CLI reports ambiguity and shows candidate IDs.
+`collection similar` supports client-side sorting with `--sort year|title` and optional `--asc`.
 
 ## Search
 
@@ -163,59 +170,12 @@ scholarinboxcli collection papers "AIAgents" --json
 scholarinboxcli search "diffusion" --json
 ```
 
-## Tested (2026-02-01)
-
-The following commands were exercised against the live API (with a valid magic-link login) to confirm behavior:
-
-```bash
-scholarinboxcli --help
-scholarinboxcli auth status --json
-scholarinboxcli digest --date 01-30-2026 --json
-scholarinboxcli trending --category ALL --days 7 --json
-scholarinboxcli search "transformers" --limit 5 --json
-scholarinboxcli semantic "graph neural networks" --limit 5 --json
-scholarinboxcli interactions --type all --json
-scholarinboxcli bookmark list --json
-scholarinboxcli bookmark add 3302478 --json
-scholarinboxcli bookmark remove 3302478 --json
-scholarinboxcli collection list --json
-scholarinboxcli collection list --expanded --json
-scholarinboxcli collection papers "AIAgents" --json
-scholarinboxcli collection similar "AIAgents" --json
-scholarinboxcli conference list --json
-scholarinboxcli conference explore --json
-```
-
 ## Notes
 
 - Some collection mutations (create/rename/delete/add/remove) rely on best-effort endpoints that may change on the service side. If a mutation fails, try again or use the web UI to validate the current behavior.
+- Bookmarks are stored as a dedicated collection named "Bookmarks" in the web app; `bookmark list` pulls that collection via `/api/get_collections`.
 - Similar papers for collections uses the server endpoint used by the web UI. Results typically appear under `digest_df` in JSON responses.
 
-## Publish to PyPI
-
-```bash
-# 1) Build sdist + wheel
-uv run --with build python -m build
-
-# 2) Validate metadata/rendering
-uvx twine check dist/*
-
-# 3) (Optional) test publish first
-uvx twine upload --repository testpypi dist/*
-
-# 4) Publish to PyPI
-uvx twine upload dist/*
-```
-
-If using an API token:
-
-```bash
-export TWINE_USERNAME=__token__
-export TWINE_PASSWORD=<your-pypi-token>
-```
-
-Automated publish is also configured via GitHub Actions:
+## License
 
-- Workflow: `.github/workflows/publish.yml`
-- Trigger: push a tag matching `v*` (for example `v0.1.1`)
-- Auth: PyPI Trusted Publishing (OIDC)
+MIT. See `LICENSE`.

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "scholarinboxcli"
-version = "0.1.1"
-description = "CLI for Scholar Inbox (authenticated web API)"
+version = "0.1.3"
+description = "Scholar Inbox CLI for digests, search, collections, and bookmarks, for humans and agents alike"
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -36,3 +36,9 @@ packages = ["src/scholarinboxcli"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 pythonpath = ["src"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+    "ruff>=0.15.0",
+]

scholarinboxcli-0.1.3/src/scholarinboxcli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.3"

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/api/client.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import json
 import os
 import time
 from urllib.parse import urlparse, parse_qs
@@ -12,7 +11,7 @@ from typing import Any
 
 import httpx
 
-from scholarinboxcli.config import Config, load_config, save_config
+from scholarinboxcli.config import load_config, save_config
 from scholarinboxcli.api import endpoints as ep
 
 
@@ -82,6 +81,34 @@ def _is_paper_list(data: Any) -> bool:
     return False
 
 
+def _extract_collections(data: Any) -> list[dict[str, Any]]:
+    if isinstance(data, dict):
+        for key in ("collections", "expanded_collections"):
+            val = data.get(key)
+            if isinstance(val, list):
+                return [item for item in val if isinstance(item, dict)]
+    if isinstance(data, list):
+        return [item for item in data if isinstance(item, dict)]
+    return []
+
+
+def _find_collection_id(data: Any, name: str) -> str | None:
+    target = name.strip().lower()
+    for item in _extract_collections(data):
+        cname = str(item.get("name") or item.get("collection_name") or "").strip().lower()
+        if cname == target:
+            cid = item.get("id") or item.get("collection_id")
+            if cid is not None:
+                return str(cid)
+    if isinstance(data, dict):
+        mapping = data.get("collection_names_to_ids_dict")
+        if isinstance(mapping, dict):
+            for key, value in mapping.items():
+                if str(key).strip().lower() == target and value is not None:
+                    return str(value)
+    return None
+
+
 class ScholarInboxClient:
     def __init__(self, api_base: str | None = None, no_retry: bool = False):
         self.no_retry = no_retry
@@ -142,13 +169,13 @@ class ScholarInboxClient:
 
     def _post_first(self, endpoints: list[str], payload: dict[str, Any]) -> Any:
         last_error: ApiError | None = None
-        for ep in endpoints:
+        for endpoint in endpoints:
             try:
-                return self._request("POST", ep, json=payload)
+                return self._request("POST", endpoint, json=payload)
             except ApiError as e:
                 last_error = e
             try:
-                return self._request("POST", ep, data=payload)
+                return self._request("POST", endpoint, data=payload)
             except ApiError as e:
                 last_error = e
         if last_error:
@@ -199,7 +226,23 @@ class ScholarInboxClient:
         )
 
     def bookmarks(self) -> Any:
-        return self._request("GET", ep.BOOKMARKS)
+        data = self.collections_list()
+        cid = _find_collection_id(data, "Bookmarks")
+        if not cid:
+            try:
+                data = self.collections_expanded()
+                cid = _find_collection_id(data, "Bookmarks")
+            except ApiError:
+                cid = None
+        if not cid:
+            try:
+                data = self.collections_map()
+                cid = _find_collection_id(data, "Bookmarks")
+            except ApiError:
+                cid = None
+        if not cid:
+            raise ApiError("Bookmarks collection not found")
+        return self.collections_get([cid])
 
     def bookmark_add(self, paper_id: str) -> Any:
         payload = {"bookmarked": True, "id": paper_id}
@@ -227,6 +270,13 @@ class ScholarInboxClient:
     def collections_map(self) -> Any:
         return self._request("GET", ep.COLLECTIONS_FALLBACK)
 
+    def collections_get(self, collection_ids: list[str]) -> Any:
+        payload = {"collection_ids": collection_ids}
+        try:
+            return self._request("POST", ep.COLLECTIONS_GET, json=payload)
+        except ApiError:
+            return self._request("POST", ep.COLLECTIONS_GET, data=payload)
+
     def collection_create(self, name: str) -> Any:
         payload = {"name": name, "collection_name": name}
         return self._post_first(list(ep.COLLECTION_CREATE_CANDIDATES), payload)
@@ -253,16 +303,19 @@ class ScholarInboxClient:
         return self._post_first(list(ep.COLLECTION_REMOVE_PAPER_CANDIDATES), payload)
 
     def collection_papers(self, collection_id: str, limit: int | None = None, offset: int | None = None) -> Any:
-        params: dict[str, Any] = {"collection_id": collection_id}
-        if limit is not None:
-            params["limit"] = limit
-        if offset is not None:
-            params["offset"] = offset
         try:
-            return self._request("GET", ep.COLLECTION_PAPERS, params=params)
+            return self.collections_get([collection_id])
         except ApiError:
-            # fallback without paging
-            return self._request("GET", ep.COLLECTION_PAPERS, params={"collection_id": collection_id})
+            params: dict[str, Any] = {"collection_id": collection_id}
+            if limit is not None:
+                params["limit"] = limit
+            if offset is not None:
+                params["offset"] = offset
+            try:
+                return self._request("GET", ep.COLLECTION_PAPERS, params=params)
+            except ApiError:
+                # fallback without paging
+                return self._request("GET", ep.COLLECTION_PAPERS, params={"collection_id": collection_id})
 
     def collections_similar(self, collection_ids: list[str], limit: int | None = None, offset: int | None = None) -> Any:
         schemas = [

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/api/endpoints.py

@@ -14,13 +14,13 @@ SEMANTIC_SEARCH = "/api/semantic-search"
 INTERACTIONS = "/api/interactions"
 
 # Bookmarks
-BOOKMARKS = "/api/bookmarks"
 BOOKMARK_PAPER = "/api/bookmark_paper/"
 
 # Collections
 COLLECTIONS_PRIMARY = "/api/get_all_user_collections"
 COLLECTIONS_FALLBACK = "/api/collections"
 COLLECTIONS_EXPANDED = "/api/get_expanded_collections"
+COLLECTIONS_GET = "/api/get_collections"
 COLLECTION_CREATE_CANDIDATES = (
     "/api/create_collection/",
     "/api/collections",

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/cli.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 import typer
 
 from scholarinboxcli.commands import auth, bookmarks, collections, conferences, papers
-from scholarinboxcli.services.collections import resolve_collection_id as _resolve_collection_id
+from scholarinboxcli.services.collections import resolve_collection_id as _resolve_collection_id  # noqa: F401
 
 
 app = typer.Typer(

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/commands/auth.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import typer
 
 from scholarinboxcli.commands.common import print_output, with_client
+from scholarinboxcli.formatters.domain_tables import format_auth_status
 
 
 app = typer.Typer(help="Authentication commands", no_args_is_help=True)
@@ -25,7 +26,7 @@ def auth_login(
 def auth_status(json_output: bool = typer.Option(False, "--json", help="Output as JSON")):
     def action(client):
         data = client.session_info()
-        print_output(data, json_output, title="Session")
+        print_output(data, json_output, title="Session", table_formatter=format_auth_status)
 
     with_client(False, action)
 

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/commands/bookmarks.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import typer
 
 from scholarinboxcli.commands.common import print_output, with_client
+from scholarinboxcli.formatters.domain_tables import format_collection_papers
 
 
 app = typer.Typer(help="Bookmark commands", no_args_is_help=True)
@@ -17,7 +18,7 @@ def bookmark_list(
 ):
     def action(client):
         data = client.bookmarks()
-        print_output(data, json_output, title="Bookmarks")
+        print_output(data, json_output, title="Bookmarks", table_formatter=format_collection_papers)
 
     with_client(no_retry, action)
 

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/commands/collections.py

@@ -7,7 +7,9 @@ from typing import Optional
 import typer
 
 from scholarinboxcli.commands.common import print_output, with_client
+from scholarinboxcli.formatters.domain_tables import format_collection_list, format_collection_papers
 from scholarinboxcli.services.collections import resolve_collection_id
+from scholarinboxcli.services.paper_sort import sort_paper_response
 
 
 app = typer.Typer(help="Collection commands", no_args_is_help=True)
@@ -21,7 +23,7 @@ def collection_list(
 ):
     def action(client):
         data = client.collections_expanded() if expanded else client.collections_list()
-        print_output(data, json_output, title="Collections")
+        print_output(data, json_output, title="Collections", table_formatter=format_collection_list)
 
     with_client(no_retry, action)
 
@@ -109,7 +111,7 @@ def collection_papers(
     def action(client):
         cid = resolve_collection_id(client, collection_id)
         data = client.collection_papers(cid, limit=limit, offset=offset)
-        print_output(data, json_output, title=f"Collection {cid}")
+        print_output(data, json_output, title=f"Collection {cid}", table_formatter=format_collection_papers)
 
     with_client(no_retry, action)
 
@@ -119,12 +121,15 @@ def collection_similar(
     collection_ids: list[str] = typer.Argument(..., help="Collection ID(s) or names"),
     limit: Optional[int] = typer.Option(None, "--limit", "-n", help="Limit results"),
     offset: Optional[int] = typer.Option(None, "--offset", help="Pagination offset"),
+    sort_by: Optional[str] = typer.Option(None, "--sort", help="Sort papers by: year, title"),
+    asc: bool = typer.Option(False, "--asc", help="Sort ascending (default is descending)"),
     json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
     no_retry: bool = typer.Option(False, "--no-retry", help="Disable retry on rate limits"),
 ):
     def action(client):
         resolved = [resolve_collection_id(client, cid) for cid in collection_ids]
         data = client.collections_similar(resolved, limit=limit, offset=offset)
+        data = sort_paper_response(data, sort_by, asc)
         print_output(data, json_output, title="Similar Papers")
 
     with_client(no_retry, action)

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/commands/common.py

@@ -12,12 +12,18 @@ from scholarinboxcli.formatters.json_fmt import format_json
 from scholarinboxcli.formatters.table import format_table
 
 
-def print_output(data: Any, use_json: bool, title: str | None = None) -> None:
+def print_output(
+    data: Any,
+    use_json: bool,
+    title: str | None = None,
+    table_formatter: Callable[[Any, str | None], str] | None = None,
+) -> None:
     if use_json or not sys.stdout.isatty():
         typer.echo(format_json(data))
         return
 
-    table = format_table(data, title=title)
+    formatter = table_formatter or format_table
+    table = formatter(data, title)
     if table == "(no results)":
         typer.echo(table)
         return

{scholarinboxcli-0.1.1 → scholarinboxcli-0.1.3}/src/scholarinboxcli/commands/conferences.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import typer
 
 from scholarinboxcli.commands.common import print_output, with_client
+from scholarinboxcli.formatters.domain_tables import format_conference_explore, format_conference_list
 
 
 app = typer.Typer(help="Conference commands", no_args_is_help=True)
@@ -17,7 +18,7 @@ def conference_list(
 ):
     def action(client):
         data = client.conference_list()
-        print_output(data, json_output, title="Conferences")
+        print_output(data, json_output, title="Conferences", table_formatter=format_conference_list)
 
     with_client(no_retry, action)
 
@@ -29,6 +30,6 @@ def conference_explore(
 ):
     def action(client):
         data = client.conference_explorer()
-        print_output(data, json_output, title="Conference Explorer")
+        print_output(data, json_output, title="Conference Explorer", table_formatter=format_conference_explore)
 
     with_client(no_retry, action)

scholarinboxcli-0.1.3/src/scholarinboxcli/formatters/domain_tables.py

@@ -0,0 +1,122 @@
+"""Domain-specific table formatters for non-paper responses."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from rich.console import Console
+from rich.table import Table
+
+from scholarinboxcli.formatters.table import format_table
+
+
+def _render(table: Table) -> str:
+    console = Console()
+    with console.capture() as capture:
+        console.print(table)
+    return capture.get()
+
+
+def format_auth_status(data: Any, title: str | None = None) -> str:
+    if not isinstance(data, dict):
+        return format_table(data, title)
+    table = Table(title=title)
+    table.add_column("Field", overflow="fold")
+    table.add_column("Value", overflow="fold")
+    for key, value in data.items():
+        table.add_row(str(key), str(value))
+    return _render(table)
+
+
+def format_collection_list(data: Any, title: str | None = None) -> str:
+    if isinstance(data, list) and data and isinstance(data[0], str):
+        table = Table(title=title)
+        table.add_column("#", justify="right")
+        table.add_column("Name", overflow="fold")
+        for i, name in enumerate(data, start=1):
+            table.add_row(str(i), str(name))
+        return _render(table)
+
+    if isinstance(data, list) and data and isinstance(data[0], dict):
+        table = Table(title=title)
+        table.add_column("ID", overflow="fold")
+        table.add_column("Name", overflow="fold")
+        for item in data:
+            cid = item.get("id") or item.get("collection_id") or ""
+            name = item.get("name") or item.get("collection_name") or ""
+            table.add_row(str(cid), str(name))
+        return _render(table)
+
+    if isinstance(data, dict) and "expanded_collections" in data:
+        return format_collection_list(data.get("expanded_collections"), title)
+
+    return format_table(data, title)
+
+
+def format_conference_list(data: Any, title: str | None = None) -> str:
+    rows = data.get("conferences") if isinstance(data, dict) else None
+    if isinstance(rows, list):
+        table = Table(title=title)
+        table.add_column("ID", justify="right")
+        table.add_column("Short")
+        table.add_column("Dates")
+        table.add_column("URL")
+        for row in rows:
+            cid = row.get("conference_id", "")
+            short = row.get("short_title") or row.get("full_title") or ""
+            start = row.get("start_date") or ""
+            end = row.get("end_date") or ""
+            dates = f"{start} -> {end}" if (start or end) else ""
+            url = row.get("conference_url") or ""
+            table.add_row(str(cid), str(short), str(dates), str(url))
+        return _render(table)
+    return format_table(data, title)
+
+
+def format_conference_explore(data: Any, title: str | None = None) -> str:
+    rows = data.get("conf_data_list") if isinstance(data, dict) else None
+    if isinstance(rows, list):
+        table = Table(title=title)
+        table.add_column("Abbrev")
+        table.add_column("Conference")
+        table.add_column("Relevance", justify="right")
+        table.add_column("Years")
+        for row in rows:
+            abbrev = row.get("abbreviation") or ""
+            name = row.get("conference_name") or ""
+            rel = row.get("conf_relevance")
+            rel_str = f"{rel:.3f}" if isinstance(rel, (float, int)) else ""
+            years = row.get("list_of_years") or []
+            years_str = ", ".join(str(y) for y in years[:5])
+            table.add_row(str(abbrev), str(name), rel_str, years_str)
+        return _render(table)
+    return format_table(data, title)
+
+
+def _extract_collection_papers(data: Any) -> list[dict[str, Any]]:
+    if isinstance(data, list):
+        return [item for item in data if isinstance(item, dict)]
+    if isinstance(data, dict):
+        for key in ("papers", "digest_df", "items", "results", "data"):
+            val = data.get(key)
+            if isinstance(val, list):
+                return [item for item in val if isinstance(item, dict)]
+        collections = data.get("collections")
+        if isinstance(collections, list):
+            papers: list[dict[str, Any]] = []
+            for collection in collections:
+                if isinstance(collection, dict):
+                    for key in ("papers", "digest_df"):
+                        val = collection.get(key)
+                        if isinstance(val, list):
+                            papers.extend([item for item in val if isinstance(item, dict)])
+            if papers:
+                return papers
+    return []
+
+
+def format_collection_papers(data: Any, title: str | None = None) -> str:
+    papers = _extract_collection_papers(data)
+    if papers:
+        return format_table(papers, title)
+    return format_table(data, title)