scholarinboxcli 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

scholarinboxcli/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.1"
+__version__ = "0.1.2"

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/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/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/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/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/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/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/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/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)

scholarinboxcli/formatters/table.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 from typing import Any
+import json
+from datetime import datetime, timezone
 
 from rich.console import Console
 from rich.table import Table
@@ -17,9 +19,41 @@ def _get_authors(paper: dict[str, Any]) -> str:
                 names.append(a)
             elif isinstance(a, dict):
                 names.append(a.get("name") or a.get("author") or "")
-        return ", ".join([n for n in names if n])
+        return _truncate_text(", ".join([n for n in names if n]), 72)
     if isinstance(authors, str):
-        return authors
+        result = authors
+    else:
+        result = ""
+    return _truncate_text(result, 72)
+
+
+def _truncate_text(text: str, max_len: int) -> str:
+    if len(text) <= max_len:
+        return text
+    if max_len <= 3:
+        return text[:max_len]
+    return text[: max_len - 3] + "..."
+
+
+def _get_year(paper: dict[str, Any]) -> str:
+    year = paper.get("year") or paper.get("publication_year") or paper.get("conference_year")
+    if year is not None:
+        if isinstance(year, float) and year.is_integer():
+            return str(int(year))
+        return str(year)
+
+    publication_date = paper.get("publication_date")
+    if isinstance(publication_date, str) and len(publication_date) >= 4 and publication_date[:4].isdigit():
+        return publication_date[:4]
+    if isinstance(publication_date, (int, float)):
+        try:
+            # Handle epoch milliseconds seen in some API payloads.
+            ts = float(publication_date)
+            if ts > 10_000_000_000:
+                ts /= 1000.0
+            return str(datetime.fromtimestamp(ts, tz=timezone.utc).year)
+        except Exception:
+            return ""
     return ""
 
 
@@ -34,33 +68,67 @@ def _extract_papers(data: Any) -> list[dict[str, Any]]:
     return []
 
 
-def format_table(data: Any, title: str | None = None) -> str:
-    papers = _extract_papers(data)
-    if not papers:
-        return "(no results)"
+def _format_scalar(value: Any) -> str:
+    if isinstance(value, (dict, list)):
+        return json.dumps(value, ensure_ascii=True)
+    return str(value)
+
 
+def _format_kv_table(data: dict[str, Any], title: str | None = None) -> str:
     table = Table(title=title)
-    table.add_column("Title", overflow="fold")
-    table.add_column("Authors", overflow="fold")
-    table.add_column("Year", justify="right")
-    table.add_column("Venue", overflow="fold")
-    table.add_column("ID", overflow="fold")
-
-    for p in papers:
-        title_val = str(p.get("title") or p.get("paper_title") or "")
-        authors_val = _get_authors(p)
-        year_val = str(p.get("year") or p.get("publication_year") or "")
-        venue_val = str(p.get("venue") or p.get("conference") or p.get("journal") or "")
-        pid = str(
-            p.get("paper_id")
-            or p.get("paperId")
-            or p.get("id")
-            or p.get("corpusid")
-            or ""
-        )
-        table.add_row(title_val, authors_val, year_val, venue_val, pid)
+    table.add_column("Field", overflow="fold")
+    table.add_column("Value", overflow="fold")
+    for key, value in data.items():
+        table.add_row(str(key), _format_scalar(value))
+    console = Console()
+    with console.capture() as capture:
+        console.print(table)
+    return capture.get()
+
 
+def _format_list_table(data: list[Any], title: str | None = None) -> str:
+    table = Table(title=title)
+    table.add_column("#", justify="right")
+    table.add_column("Value", overflow="fold")
+    for idx, value in enumerate(data, start=1):
+        table.add_row(str(idx), _format_scalar(value))
     console = Console()
     with console.capture() as capture:
         console.print(table)
     return capture.get()
+
+
+def format_table(data: Any, title: str | None = None) -> str:
+    papers = _extract_papers(data)
+    if papers:
+        table = Table(title=title, show_lines=True, row_styles=["", "dim"])
+        table.add_column("Title", overflow="fold", max_width=68)
+        table.add_column("Authors", overflow="fold", max_width=56)
+        table.add_column("Year", justify="right")
+        table.add_column("Venue", overflow="fold")
+        table.add_column("ID", overflow="fold")
+
+        for p in papers:
+            title_val = str(p.get("title") or p.get("paper_title") or "")
+            authors_val = _get_authors(p)
+            year_val = _get_year(p)
+            venue_val = str(p.get("venue") or p.get("conference") or p.get("journal") or "")
+            pid = str(
+                p.get("paper_id")
+                or p.get("paperId")
+                or p.get("id")
+                or p.get("corpusid")
+                or ""
+            )
+            table.add_row(title_val, authors_val, year_val, venue_val, pid)
+
+        console = Console()
+        with console.capture() as capture:
+            console.print(table)
+        return capture.get()
+
+    if isinstance(data, dict) and data:
+        return _format_kv_table(data, title=title)
+    if isinstance(data, list) and data:
+        return _format_list_table(data, title=title)
+    return "(no results)"

scholarinboxcli/services/collections.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from typing import Any
-
 from scholarinboxcli.api.client import ApiError, ScholarInboxClient
 
 

scholarinboxcli/services/paper_sort.py

@@ -0,0 +1,54 @@
+"""Helpers for sorting paper-like API responses."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Any
+
+
+def _year_from_paper(paper: dict[str, Any]) -> int:
+    year = paper.get("year") or paper.get("publication_year") or paper.get("conference_year")
+    if isinstance(year, int):
+        return year
+    if isinstance(year, float):
+        return int(year)
+    if isinstance(year, str) and year.isdigit():
+        return int(year)
+
+    publication_date = paper.get("publication_date")
+    if isinstance(publication_date, str) and len(publication_date) >= 4 and publication_date[:4].isdigit():
+        return int(publication_date[:4])
+    if isinstance(publication_date, (int, float)):
+        ts = float(publication_date)
+        if ts > 10_000_000_000:
+            ts /= 1000.0
+        try:
+            return datetime.fromtimestamp(ts, tz=timezone.utc).year
+        except Exception:
+            return 0
+    return 0
+
+
+def sort_paper_response(data: Any, sort_by: str | None, asc: bool) -> Any:
+    """Return a sorted copy of known paper-list structures."""
+    if not sort_by:
+        return data
+    if not isinstance(data, dict):
+        return data
+
+    for key in ("digest_df", "papers", "results", "items", "data"):
+        rows = data.get(key)
+        if not isinstance(rows, list) or not rows or not isinstance(rows[0], dict):
+            continue
+
+        if sort_by == "year":
+            sorted_rows = sorted(rows, key=_year_from_paper, reverse=not asc)
+        elif sort_by == "title":
+            sorted_rows = sorted(rows, key=lambda p: str(p.get("title") or p.get("paper_title") or "").lower(), reverse=not asc)
+        else:
+            return data
+
+        out = dict(data)
+        out[key] = sorted_rows
+        return out
+    return data

{scholarinboxcli-0.1.1.dist-info → scholarinboxcli-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scholarinboxcli
-Version: 0.1.1
+Version: 0.1.2
 Summary: CLI for Scholar Inbox (authenticated web API)
 License-Expression: MIT
 License-File: LICENSE
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # scholarinboxcli
 
-CLI for Scholar Inbox, for humans and agents alike.
+CLI for [Scholar Inbox](https://scholar-inbox.com), 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.2.dist-info/RECORD

@@ -0,0 +1,23 @@
+scholarinboxcli/__init__.py,sha256=YvuYzWnKtqBb-IqG8HAu-nhIYAsgj9Vmc_b9o7vO-js,22
+scholarinboxcli/cli.py,sha256=BPXTPhBVO6mDoihXfDIp6zmbTqIcMJ8-VqKiF616DrI,1015
+scholarinboxcli/config.py,sha256=cxp1RzNwzT6Iu225EPvs8NhH2YTTMg9fQBjaYIRVDoc,1545
+scholarinboxcli/api/client.py,sha256=pEUMcoTauEmDdB7weV5m82-yyjUpdcvbRe8oY9Rj8Qo,15142
+scholarinboxcli/api/endpoints.py,sha256=lwSk3PAOITGurTliP9Ko8KSP-DFR8WqKrRxC760rpPc,1515
+scholarinboxcli/commands/__init__.py,sha256=aOPGu7M21finmICNxDSxNBpe1C3Vw2Iimh1UBESfekU,42
+scholarinboxcli/commands/auth.py,sha256=6iwFsuAqiwiRTJbaJFgEt4JXRo1HVrLEF3WSsMo3GHA,1024
+scholarinboxcli/commands/bookmarks.py,sha256=UbR99VrrCyCdu1EhyHIgwn3sPOYKfRc4jF4gUx1fU6w,1598
+scholarinboxcli/commands/collections.py,sha256=pBZFXi_e3Dto-4E2GS6pgIrcVMzWpWaGLNTLB5My5sQ,5634
+scholarinboxcli/commands/common.py,sha256=5EcH0RDuX8DKzyB6lrPqGEok5TKx8SSV37mXczD9dqI,1654
+scholarinboxcli/commands/conferences.py,sha256=e1QjX9R9WZhkSkPXKgoxuRPbl612qEVbsjX90zEgKSw,1183
+scholarinboxcli/commands/papers.py,sha256=mdb3-_iecy_pjavPL_K0cXfVnDsQMU93SbD8T3hJY10,3968
+scholarinboxcli/formatters/domain_tables.py,sha256=9RZcq-k9YycO64FvQAblE1dzYmytSj7NBasBEZeDW9I,4702
+scholarinboxcli/formatters/json_fmt.py,sha256=Ntcp4EqHugCXg79RIF62c7QHa-lexptLDDTT3IEP65U,197
+scholarinboxcli/formatters/table.py,sha256=G0ehvuGgo77XX5kw_9u5DEf8oUTIR-fOJ5rhYQvMEkc,4587
+scholarinboxcli/services/__init__.py,sha256=i-8EAvmxCDyYEjmfILYRcUHUh7ryY5hFS4PZARScFXo,56
+scholarinboxcli/services/collections.py,sha256=rz9rqgf-nfzBl-scBhweA-22--Z70qKEyBhW84os4bY,4353
+scholarinboxcli/services/paper_sort.py,sha256=HYoIHry14QIUsfd9D9kZvy7phVhvCnwEjKHv6zO-0IU,1809
+scholarinboxcli-0.1.2.dist-info/METADATA,sha256=oqmUh6jnAapWYtUA13efz3k4r1Q4kQutPP_nGEOzS00,5328
+scholarinboxcli-0.1.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+scholarinboxcli-0.1.2.dist-info/entry_points.txt,sha256=iescoEMF_CPwSNSmvlzNDl5pT2VpBL9_1bIq_FFIAKc,60
+scholarinboxcli-0.1.2.dist-info/licenses/LICENSE,sha256=sP1DPhQGvTFx1mH4JhNuczMMbApQgFvhBcVjZKM79gU,1068
+scholarinboxcli-0.1.2.dist-info/RECORD,,

scholarinboxcli-0.1.1.dist-info/RECORD

@@ -1,21 +0,0 @@
-scholarinboxcli/__init__.py,sha256=rnObPjuBcEStqSO0S6gsdS_ot8ITOQjVj_-P1LUUYpg,22
-scholarinboxcli/cli.py,sha256=MEpkfuWXC4U_GjT85ue-LRTE_FejFvYhxwtnYbWr18k,1001
-scholarinboxcli/config.py,sha256=cxp1RzNwzT6Iu225EPvs8NhH2YTTMg9fQBjaYIRVDoc,1545
-scholarinboxcli/api/client.py,sha256=8Wd7CzAuku2gP2lrdvv2s81JV5Gr6pqGSggnKdk-7-8,13033
-scholarinboxcli/api/endpoints.py,sha256=aw686_VtgbJelcGbw__cG8qtHVm_f9pGeNEqeuWeOuo,1503
-scholarinboxcli/commands/__init__.py,sha256=aOPGu7M21finmICNxDSxNBpe1C3Vw2Iimh1UBESfekU,42
-scholarinboxcli/commands/auth.py,sha256=D2CXLVMwJTxU3_OLNDZ9YGG-mYzrZ4agTKRLeIS3wx4,916
-scholarinboxcli/commands/bookmarks.py,sha256=S0ah6woZrS3p_T4r-gAZZrTSr8GL2EQb6cEtaCKXD0o,1478
-scholarinboxcli/commands/collections.py,sha256=rfSh98wT-yrDvYjl_1UcbVvEiw-h5yaHCv9WTkNHMWg,5139
-scholarinboxcli/commands/common.py,sha256=KgudFViqscHOCfLe_KPADGr_E_d1KKBoW1ZGje3gHuU,1531
-scholarinboxcli/commands/conferences.py,sha256=wVs-YpdkLVxlwqu3_rYHrJl4j1tIb8exvsp7t96qHqo,997
-scholarinboxcli/commands/papers.py,sha256=mdb3-_iecy_pjavPL_K0cXfVnDsQMU93SbD8T3hJY10,3968
-scholarinboxcli/formatters/json_fmt.py,sha256=Ntcp4EqHugCXg79RIF62c7QHa-lexptLDDTT3IEP65U,197
-scholarinboxcli/formatters/table.py,sha256=GnzpmSJ7M_yq-R-c8no8SE9vXbycvWWPUu6hV4tcJAA,2133
-scholarinboxcli/services/__init__.py,sha256=i-8EAvmxCDyYEjmfILYRcUHUh7ryY5hFS4PZARScFXo,56
-scholarinboxcli/services/collections.py,sha256=mQ67tEmNwspOeWg9NyIIovpqkLMP2ANi4Jso9SHXi5A,4377
-scholarinboxcli-0.1.1.dist-info/METADATA,sha256=E1IrW2o5X9P_-6AJDzcS8K6YvyrGrADdHBgVmAVlcPU,6285
-scholarinboxcli-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-scholarinboxcli-0.1.1.dist-info/entry_points.txt,sha256=iescoEMF_CPwSNSmvlzNDl5pT2VpBL9_1bIq_FFIAKc,60
-scholarinboxcli-0.1.1.dist-info/licenses/LICENSE,sha256=sP1DPhQGvTFx1mH4JhNuczMMbApQgFvhBcVjZKM79gU,1068
-scholarinboxcli-0.1.1.dist-info/RECORD,,