aiagents4pharma 1.43.0__py3-none-any.whl → 1.45.0__py3-none-any.whl

aiagents4pharma/talk2scholars/tools/s2/query_dataframe.py

@@ -26,9 +26,8 @@ Notes
   first identifier is returned; otherwise a list is returned from all rows that have values.
 """
 
-
 import logging
-from typing import Annotated, Optional, Any
+from typing import Annotated, Any
 
 import pandas as pd
 from langchain_core.messages import ToolMessage
@@ -99,7 +98,7 @@ class QueryDataFrameInput(BaseModel):
             "extract when extract_ids=True."
         ),
     )
-    row_number: Optional[int] = Field(
+    row_number: int | None = Field(
         default=None,
         description=(
             "1-based index of the ID to extract from the list; if provided, returns only"
@@ -180,9 +179,7 @@ def query_dataframe(
     context_val = state.get("last_displayed_papers")
     if not context_val:
         logger.info("No papers displayed so far, raising NoPapersFoundError")
-        raise NoPapersFoundError(
-            "No papers found. A search needs to be performed first."
-        )
+        raise NoPapersFoundError("No papers found. A search needs to be performed first.")
 
     # Resolve the paper dictionary
     if isinstance(context_val, dict):
@@ -205,14 +202,10 @@ def query_dataframe(
         if not id_column:
             raise ValueError("Must specify 'id_column' when extract_ids=True.")
         if row_number is not None:
-            question_to_agent = (
-                f"df['{id_column}'].dropna().str[0].tolist()[{row_number-1}]"
-            )
+            question_to_agent = f"df['{id_column}'].dropna().str[0].tolist()[{row_number - 1}]"
         else:
             question_to_agent = f"df['{id_column}'].dropna().str[0].tolist()"
-        logger.info(
-            "extract_ids enabled: asking agent to run expression: %s", question_to_agent
-        )
+        logger.info("extract_ids enabled: asking agent to run expression: %s", question_to_agent)
 
     df_agent = create_pandas_dataframe_agent(
         llm_model,

aiagents4pharma/talk2scholars/tools/s2/retrieve_semantic_scholar_paper_id.py

@@ -10,6 +10,7 @@ Configuration is loaded via Hydra and the top ranked result is returned.
 
 import logging
 from typing import Annotated, Any
+
 import hydra
 import requests
 from langchain_core.messages import ToolMessage
@@ -18,7 +19,6 @@ from langchain_core.tools.base import InjectedToolCallId
 from langgraph.types import Command
 from pydantic import BaseModel, Field
 
-
 # Configure logging
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -36,9 +36,7 @@ class RetrieveSemanticScholarPaperIdInput(BaseModel):
         Runtime-injected identifier for tracing the tool invocation.
     """
 
-    paper_title: str = Field(
-        ..., description="The paper title to search for on Semantic Scholar."
-    )
+    paper_title: str = Field(..., description="The paper title to search for on Semantic Scholar.")
     tool_call_id: Annotated[str, InjectedToolCallId]
 
 

aiagents4pharma/talk2scholars/tools/s2/search.py

@@ -8,12 +8,14 @@ optionally filtered by publication year.
 """
 
 import logging
-from typing import Annotated, Any, Optional
+from typing import Annotated, Any
+
 from langchain_core.messages import ToolMessage
 from langchain_core.tools import tool
 from langchain_core.tools.base import InjectedToolCallId
 from langgraph.types import Command
 from pydantic import BaseModel, Field
+
 from .utils.search_helper import SearchData
 
 # Configure logging
@@ -32,16 +34,14 @@ class SearchInput(BaseModel):
         tool_call_id: Internal tool call identifier injected by the system.
     """
 
-    query: str = Field(
-        description="Full or partial paper title or keywords to search for"
-    )
+    query: str = Field(description="Full or partial paper title or keywords to search for")
     limit: int = Field(
         default=10,
         description="Maximum number of search results to return (1-100)",
         ge=1,
         le=100,
     )
-    year: Optional[str] = Field(
+    year: str | None = Field(
         default=None,
         description="Publication year filter; supports formats:"
         "'YYYY', 'YYYY-', '-YYYY', 'YYYY:YYYY'",
@@ -58,7 +58,7 @@ def search_tool(
     query: str,
     tool_call_id: Annotated[str, InjectedToolCallId],
     limit: int = 10,
-    year: Optional[str] = None,
+    year: str | None = None,
 ) -> Command[Any]:
     """
     Return academic papers from Semantic Scholar matching a title or keyword query.

aiagents4pharma/talk2scholars/tools/s2/single_paper_rec.py

@@ -8,12 +8,14 @@ Given a Semantic Scholar paper ID, this tool retrieves related works
 """
 
 import logging
-from typing import Annotated, Any, Optional
+from typing import Annotated, Any
+
 from langchain_core.messages import ToolMessage
 from langchain_core.tools import tool
 from langchain_core.tools.base import InjectedToolCallId
 from langgraph.types import Command
 from pydantic import BaseModel, Field
+
 from .utils.single_helper import SinglePaperRecData
 
 # Configure logging
@@ -40,7 +42,7 @@ class SinglePaperRecInput(BaseModel):
         ge=1,
         le=500,
     )
-    year: Optional[str] = Field(
+    year: str | None = Field(
         default=None,
         description="Publication year filter; supports formats::"
         "'YYYY', 'YYYY-', '-YYYY', 'YYYY:YYYY'",
@@ -57,7 +59,7 @@ def get_single_paper_recommendations(
     paper_id: str,
     tool_call_id: Annotated[str, InjectedToolCallId],
     limit: int = 10,
-    year: Optional[str] = None,
+    year: str | None = None,
 ) -> Command[Any]:
     """
     Recommend related research papers using the Semantic Scholar API for a single paper ID.

aiagents4pharma/talk2scholars/tools/s2/utils/__init__.py

@@ -1,7 +1,5 @@
 """This module contains utility functions for the Semantic Scholar search tool."""
 
-from . import search_helper
-from . import single_helper
-from . import multi_helper
+from . import multi_helper, search_helper, single_helper
 
 __all__ = ["search_helper", "single_helper", "multi_helper"]

aiagents4pharma/talk2scholars/tools/s2/utils/multi_helper.py

@@ -6,11 +6,11 @@ Utility for fetching recommendations based on multiple papers.
 
 import json
 import logging
-from typing import Any, List, Optional, Dict
+from typing import Any
+
 import hydra
 import requests
 
-
 # Configure logging
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -21,9 +21,9 @@ class MultiPaperRecData:
 
     def __init__(
         self,
-        paper_ids: List[str],
+        paper_ids: list[str],
         limit: int,
-        year: Optional[str],
+        year: str | None,
         tool_call_id: str,
     ):
         self.paper_ids = paper_ids
@@ -51,7 +51,7 @@ class MultiPaperRecData:
             logger.info("Loaded configuration for multi-paper recommendation tool")
             return cfg.tools.multi_paper_recommendation
 
-    def _create_params(self) -> Dict[str, Any]:
+    def _create_params(self) -> dict[str, Any]:
         """Create parameters for the API request."""
         params = {
             "limit": min(self.limit, 500),
@@ -94,9 +94,7 @@ class MultiPaperRecData:
                     ) from e
 
         if self.response is None:
-            raise RuntimeError(
-                "Failed to obtain a response from the Semantic Scholar API."
-            )
+            raise RuntimeError("Failed to obtain a response from the Semantic Scholar API.")
 
         logger.info(
             "API Response Status for multi-paper recommendations: %s",
@@ -117,9 +115,7 @@ class MultiPaperRecData:
 
         self.recommendations = self.data.get("recommendedPapers", [])
         if not self.recommendations:
-            logger.error(
-                "No recommendations returned from API for paper IDs: %s", self.paper_ids
-            )
+            logger.error("No recommendations returned from API for paper IDs: %s", self.paper_ids)
             raise RuntimeError(
                 "No recommendations were found for your query. Consider refining your search "
                 "by using more specific keywords or different terms."
@@ -128,12 +124,12 @@ class MultiPaperRecData:
     def _filter_papers(self) -> None:
         """Filter and format papers."""
         # Build filtered recommendations with unified paper_ids
-        filtered: Dict[str, Any] = {}
+        filtered: dict[str, Any] = {}
         for paper in self.recommendations:
             if not paper.get("title") or not paper.get("authors"):
                 continue
             ext = paper.get("externalIds", {}) or {}
-            ids: List[str] = []
+            ids: list[str] = []
             arxiv = ext.get("ArXiv")
             if arxiv:
                 ids.append(f"arxiv:{arxiv}")
@@ -191,7 +187,7 @@ class MultiPaperRecData:
             title = paper.get("Title", "N/A")
             year = paper.get("Year", "N/A")
             snippet = self._get_snippet(paper.get("Abstract", ""))
-            entry = f"{i+1}. {title} ({year})"
+            entry = f"{i + 1}. {title} ({year})"
             if snippet:
                 entry += f"\n   Abstract snippet: {snippet}"
             entries.append(entry)
@@ -202,14 +198,12 @@ class MultiPaperRecData:
             "Papers are attached as an artifact."
         )
         self.content += " Here is a summary of the recommendations:\n"
-        self.content += (
-            f"Number of recommended papers found: {self.get_paper_count()}\n"
-        )
+        self.content += f"Number of recommended papers found: {self.get_paper_count()}\n"
         self.content += f"Query Paper IDs: {', '.join(self.paper_ids)}\n"
         self.content += f"Year: {self.year}\n" if self.year else ""
         self.content += "Here are a few of these papers:\n" + top_papers_info
 
-    def process_recommendations(self) -> Dict[str, Any]:
+    def process_recommendations(self) -> dict[str, Any]:
         """Process the recommendations request and return results."""
         self._fetch_recommendations()
         self._filter_papers()

aiagents4pharma/talk2scholars/tools/s2/utils/search_helper.py

@@ -5,7 +5,8 @@ Utility for fetching recommendations based on a single paper.
 """
 
 import logging
-from typing import Any, Optional, Dict
+from typing import Any
+
 import hydra
 import requests
 
@@ -21,7 +22,7 @@ class SearchData:
         self,
         query: str,
         limit: int,
-        year: Optional[str],
+        year: str | None,
         tool_call_id: str,
     ):
         self.query = query
@@ -40,13 +41,11 @@ class SearchData:
     def _load_config(self) -> Any:
         """Load hydra configuration."""
         with hydra.initialize(version_base=None, config_path="../../../configs"):
-            cfg = hydra.compose(
-                config_name="config", overrides=["tools/search=default"]
-            )
+            cfg = hydra.compose(config_name="config", overrides=["tools/search=default"])
             logger.info("Loaded configuration for search tool")
             return cfg.tools.search
 
-    def _create_params(self) -> Dict[str, Any]:
+    def _create_params(self) -> dict[str, Any]:
         """Create parameters for the API request."""
         params = {
             "query": self.query,
@@ -64,9 +63,7 @@ class SearchData:
         # Wrap API call in try/except to catch connectivity issues
         for attempt in range(10):
             try:
-                self.response = requests.get(
-                    self.endpoint, params=self.params, timeout=10
-                )
+                self.response = requests.get(self.endpoint, params=self.params, timeout=10)
                 self.response.raise_for_status()  # Raises HTTPError for bad responses
                 break  # Exit loop if request is successful
             except requests.exceptions.RequestException as e:
@@ -82,9 +79,7 @@ class SearchData:
                     ) from e
 
         if self.response is None:
-            raise RuntimeError(
-                "Failed to obtain a response from the Semantic Scholar API."
-            )
+            raise RuntimeError("Failed to obtain a response from the Semantic Scholar API.")
 
         self.data = self.response.json()
 
@@ -99,9 +94,7 @@ class SearchData:
 
         self.papers = self.data.get("data", [])
         if not self.papers:
-            logger.error(
-                "No papers returned from Semantic Scholar API for query: %s", self.query
-            )
+            logger.error("No papers returned from Semantic Scholar API for query: %s", self.query)
             raise RuntimeError(
                 "No papers were found for your query. Consider refining your search "
                 "by using more specific keywords or different terms."
@@ -110,7 +103,7 @@ class SearchData:
     def _filter_papers(self) -> None:
         """Filter and format papers."""
         # Build filtered papers mapping with unified paper_ids list
-        filtered: Dict[str, Any] = {}
+        filtered: dict[str, Any] = {}
         for paper in self.papers:
             if not paper.get("title") or not paper.get("authors"):
                 continue
@@ -175,7 +168,7 @@ class SearchData:
             title = paper.get("Title", "N/A")
             year = paper.get("Year", "N/A")
             snippet = self._get_snippet(paper.get("Abstract", ""))
-            entry = f"{i+1}. {title} ({year})"
+            entry = f"{i + 1}. {title} ({year})"
             if snippet:
                 entry += f"\n   Abstract snippet: {snippet}"
             entries.append(entry)
@@ -192,7 +185,7 @@ class SearchData:
         self.content += f"Year: {self.year}\n" if self.year else ""
         self.content += "Top 3 papers:\n" + top_papers_info
 
-    def process_search(self) -> Dict[str, Any]:
+    def process_search(self) -> dict[str, Any]:
         """Process the search request and return results."""
         self._fetch_papers()
         self._filter_papers()

aiagents4pharma/talk2scholars/tools/s2/utils/single_helper.py

@@ -5,7 +5,8 @@ Utility for fetching recommendations based on a single paper.
 """
 
 import logging
-from typing import Any, Optional, Dict, List
+from typing import Any
+
 import hydra
 import requests
 
@@ -21,7 +22,7 @@ class SinglePaperRecData:
         self,
         paper_id: str,
         limit: int,
-        year: Optional[str],
+        year: str | None,
         tool_call_id: str,
     ):
         self.paper_id = paper_id
@@ -47,7 +48,7 @@ class SinglePaperRecData:
             logger.info("Loaded configuration for single paper recommendation tool")
             return cfg.tools.single_paper_recommendation
 
-    def _create_params(self) -> Dict[str, Any]:
+    def _create_params(self) -> dict[str, Any]:
         """Create parameters for the API request."""
         params = {
             "limit": min(self.limit, 500),  # Max 500 per API docs
@@ -86,9 +87,7 @@ class SinglePaperRecData:
                     ) from e
 
         if self.response is None:
-            raise RuntimeError(
-                "Failed to obtain a response from the Semantic Scholar API."
-            )
+            raise RuntimeError("Failed to obtain a response from the Semantic Scholar API.")
 
         logger.info(
             "API Response Status for recommendations of paper %s: %s",
@@ -110,9 +109,7 @@ class SinglePaperRecData:
 
         self.recommendations = self.data.get("recommendedPapers", [])
         if not self.recommendations:
-            logger.error(
-                "No recommendations returned from API for paper: %s", self.paper_id
-            )
+            logger.error("No recommendations returned from API for paper: %s", self.paper_id)
             raise RuntimeError(
                 "No recommendations were found for your query. Consider refining your search "
                 "by using more specific keywords or different terms."
@@ -121,12 +118,12 @@ class SinglePaperRecData:
     def _filter_papers(self) -> None:
         """Filter and format papers."""
         # Build filtered recommendations with unified paper_ids
-        filtered: Dict[str, Any] = {}
+        filtered: dict[str, Any] = {}
         for paper in self.recommendations:
             if not paper.get("title") or not paper.get("authors"):
                 continue
             ext = paper.get("externalIds", {}) or {}
-            ids: List[str] = []
+            ids: list[str] = []
             arxiv = ext.get("ArXiv")
             if arxiv:
                 ids.append(f"arxiv:{arxiv}")
@@ -184,7 +181,7 @@ class SinglePaperRecData:
             title = paper.get("Title", "N/A")
             year = paper.get("Year", "N/A")
             snippet = self._get_snippet(paper.get("Abstract", ""))
-            entry = f"{i+1}. {title} ({year})"
+            entry = f"{i + 1}. {title} ({year})"
             if snippet:
                 entry += f"\n   Abstract snippet: {snippet}"
             entries.append(entry)
@@ -195,13 +192,11 @@ class SinglePaperRecData:
             "Papers are attached as an artifact. "
             "Here is a summary of the recommendations:\n"
         )
-        self.content += (
-            f"Number of recommended papers found: {self.get_paper_count()}\n"
-        )
+        self.content += f"Number of recommended papers found: {self.get_paper_count()}\n"
         self.content += f"Query Paper ID: {self.paper_id}\n"
         self.content += "Here are a few of these papers:\n" + top_papers_info
 
-    def process_recommendations(self) -> Dict[str, Any]:
+    def process_recommendations(self) -> dict[str, Any]:
         """Process the recommendations request and return results."""
         self._fetch_recommendations()
         self._filter_papers()

aiagents4pharma/talk2scholars/tools/zotero/__init__.py

@@ -2,9 +2,6 @@
 Import statements
 """
 
-from . import zotero_read
-from . import zotero_write
-from . import utils
-from . import zotero_review
+from . import utils, zotero_read, zotero_review, zotero_write
 
 __all__ = ["zotero_read", "zotero_write", "utils", "zotero_review"]

aiagents4pharma/talk2scholars/tools/zotero/utils/__init__.py

@@ -2,9 +2,6 @@
 Import statements
 """
 
-from . import zotero_path
-from . import read_helper
-from . import write_helper
-from . import review_helper
+from . import read_helper, review_helper, write_helper, zotero_path
 
 __all__ = ["zotero_path", "read_helper", "write_helper", "review_helper"]

aiagents4pharma/talk2scholars/tools/zotero/utils/read_helper.py

@@ -5,7 +5,7 @@ Utility for zotero read tool.
 """
 
 import logging
-from typing import Any, Dict, List
+from typing import Any
 
 import hydra
 import requests
@@ -51,7 +51,7 @@ class ZoteroSearchData:
         self._filter_and_format_papers(items)
         self._create_content()
 
-    def get_search_results(self) -> Dict[str, Any]:
+    def get_search_results(self) -> dict[str, Any]:
         """Get the search results and content."""
         return {
             "article_data": self.article_data,
@@ -61,9 +61,7 @@ class ZoteroSearchData:
     def _load_config(self) -> Any:
         """Load hydra configuration."""
         with hydra.initialize(version_base=None, config_path="../../../configs"):
-            cfg = hydra.compose(
-                config_name="config", overrides=["tools/zotero_read=default"]
-            )
+            cfg = hydra.compose(config_name="config", overrides=["tools/zotero_read=default"])
             logger.info("Loaded configuration for Zotero search tool")
             return cfg.tools.zotero_read
 
@@ -77,7 +75,7 @@ class ZoteroSearchData:
         )
         return zotero.Zotero(self.cfg.user_id, self.cfg.library_type, self.cfg.api_key)
 
-    def _fetch_items(self) -> List[Dict[str, Any]]:
+    def _fetch_items(self) -> list[dict[str, Any]]:
         """Fetch items from Zotero."""
         try:
             if self.query.strip() == "":
@@ -100,15 +98,13 @@ class ZoteroSearchData:
 
         if not items:
             logger.error("No items returned from Zotero for query: '%s'", self.query)
-            raise RuntimeError(
-                "No items returned from Zotero. Please retry the same query."
-            )
+            raise RuntimeError("No items returned from Zotero. Please retry the same query.")
 
         return items
 
-    def _collect_item_attachments(self) -> Dict[str, str]:
+    def _collect_item_attachments(self) -> dict[str, str]:
         """Collect PDF attachment keys for non-orphan items."""
-        item_attachments: Dict[str, str] = {}
+        item_attachments: dict[str, str] = {}
         for item_key, item_data in self.article_data.items():
             if item_data.get("Type") == "orphan_attachment":
                 continue
@@ -127,7 +123,7 @@ class ZoteroSearchData:
                 logger.error("Failed to get attachments for item %s: %s", item_key, e)
         return item_attachments
 
-    def _process_orphaned_pdfs(self, orphaned_pdfs: Dict[str, str]) -> None:
+    def _process_orphaned_pdfs(self, orphaned_pdfs: dict[str, str]) -> None:
         """Download or record orphaned PDF attachments."""
         if self.download_pdfs:
             logger.info("Downloading %d orphaned PDFs in parallel", len(orphaned_pdfs))
@@ -147,16 +143,14 @@ class ZoteroSearchData:
             logger.info("Skipping orphaned PDF downloads (download_pdfs=False)")
             for attachment_key in orphaned_pdfs:
                 self.article_data[attachment_key]["attachment_key"] = attachment_key
-                self.article_data[attachment_key]["filename"] = (
-                    self.article_data[attachment_key].get("Title", attachment_key)
-                )
+                self.article_data[attachment_key]["filename"] = self.article_data[
+                    attachment_key
+                ].get("Title", attachment_key)
 
-    def _process_item_pdfs(self, item_attachments: Dict[str, str]) -> None:
+    def _process_item_pdfs(self, item_attachments: dict[str, str]) -> None:
         """Download or record regular item PDF attachments."""
         if self.download_pdfs:
-            logger.info(
-                "Downloading %d regular item PDFs in parallel", len(item_attachments)
-            )
+            logger.info("Downloading %d regular item PDFs in parallel", len(item_attachments))
             results = download_pdfs_in_parallel(
                 self.session,
                 self.cfg.user_id,
@@ -175,15 +169,13 @@ class ZoteroSearchData:
             self.article_data[item_key]["attachment_key"] = attachment_key
             logger.info("Downloaded Zotero PDF to: %s", file_path)
 
-    def _filter_and_format_papers(self, items: List[Dict[str, Any]]) -> None:
+    def _filter_and_format_papers(self, items: list[dict[str, Any]]) -> None:
         """Filter and format papers from Zotero items, including standalone PDFs."""
-        filter_item_types = (
-            self.cfg.zotero.filter_item_types if self.only_articles else []
-        )
+        filter_item_types = self.cfg.zotero.filter_item_types if self.only_articles else []
         logger.debug("Filtering item types: %s", filter_item_types)
 
         # Maps to track attachments for batch processing
-        orphaned_pdfs: Dict[str, str] = {}  # attachment_key -> item key (same for orphans)
+        orphaned_pdfs: dict[str, str] = {}  # attachment_key -> item key (same for orphans)
 
         # First pass: process all items without downloading PDFs
         for item in items:
@@ -214,17 +206,14 @@ class ZoteroSearchData:
                     "Authors": [
                         f"{creator.get('firstName', '')} {creator.get('lastName', '')}".strip()
                         for creator in data.get("creators", [])
-                        if isinstance(creator, dict)
-                        and creator.get("creatorType") == "author"
+                        if isinstance(creator, dict) and creator.get("creatorType") == "author"
                     ],
                     "source": "zotero",
                 }
                 # We'll collect attachment info in second pass
 
             # CASE 2: Standalone orphaned PDF attachment
-            elif data.get("contentType") == "application/pdf" and not data.get(
-                "parentItem"
-            ):
+            elif data.get("contentType") == "application/pdf" and not data.get("parentItem"):
                 attachment_key = key
                 filename = data.get("filename", "unknown.pdf")
 
@@ -260,25 +249,18 @@ class ZoteroSearchData:
 
         # Ensure we have some results
         if not self.article_data:
-            logger.error(
-                "No matching papers returned from Zotero for query: '%s'", self.query
-            )
+            logger.error("No matching papers returned from Zotero for query: '%s'", self.query)
             raise RuntimeError(
                 "No matching papers returned from Zotero. Please retry the same query."
             )
 
-        logger.info(
-            "Filtered %d items (including orphaned attachments)", len(self.article_data)
-        )
+        logger.info("Filtered %d items (including orphaned attachments)", len(self.article_data))
 
     def _create_content(self) -> None:
         """Create the content message for the response."""
         top_papers = list(self.article_data.values())[:2]
         top_papers_info = "\n".join(
-            [
-                f"{i+1}. {paper['Title']} ({paper['Type']})"
-                for i, paper in enumerate(top_papers)
-            ]
+            [f"{i + 1}. {paper['Title']} ({paper['Type']})" for i, paper in enumerate(top_papers)]
         )
 
         self.content = "Retrieval was successful. Papers are attached as an artifact."

aiagents4pharma/talk2scholars/tools/zotero/utils/review_helper.py

@@ -5,7 +5,6 @@ Utility for reviewing papers and saving them to Zotero.
 """
 
 import logging
-from typing import List
 
 # Configure logging
 logging.basicConfig(level=logging.INFO)
@@ -40,12 +39,9 @@ class ReviewData:
 
     def get_custom_path_approval_message(self, custom_path: str) -> str:
         """Get the formatted approval message for a custom collection path."""
-        return (
-            f"Human approved saving papers to custom Zotero "
-            f"collection '{custom_path}'."
-        )
+        return f"Human approved saving papers to custom Zotero collection '{custom_path}'."
 
-    def _create_papers_summary(self) -> List[str]:
+    def _create_papers_summary(self) -> list[str]:
         """Create a summary of papers for review."""
         summary = []
         for paper_id, paper in list(self.fetched_papers.items())[:5]: