sciverse 0.6.2__tar.gz → 0.7.0__tar.gz

{sciverse-0.6.2 → sciverse-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sciverse
-Version: 0.6.2
+Version: 0.7.0
 Summary: Sciverse Agent Tools — OpenAI/Anthropic/LangChain compatible tool schema and async client for Sciverse retrieval APIs
 Project-URL: Homepage, https://github.com/opendatalab/Sciverse-Agent-Tools
 Project-URL: Repository, https://github.com/opendatalab/Sciverse-Agent-Tools.git

{sciverse-0.6.2 → sciverse-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sciverse"
-version = "0.6.2"
+version = "0.7.0"
 description = "Sciverse Agent Tools — OpenAI/Anthropic/LangChain compatible tool schema and async client for Sciverse retrieval APIs"
 readme = "README.md"
 requires-python = ">=3.10"

{sciverse-0.6.2 → sciverse-0.7.0}/src/sciverse/cli.py

@@ -142,6 +142,7 @@ def _cmd_search(args: argparse.Namespace) -> int:
         if args.title_contains: kwargs["title_contains"] = args.title_contains
         if args.abstract_contains: kwargs["abstract_contains"] = args.abstract_contains
         if args.sort_by_year != "none": kwargs["sort_by_year"] = args.sort_by_year
+        if args.freshness_boost != "NONE": kwargs["freshness_boost"] = args.freshness_boost
         kwargs["page"] = args.page
         kwargs["page_size"] = args.page_size
         r = await client.search_papers(**kwargs)
@@ -252,6 +253,9 @@ def _build_parser() -> argparse.ArgumentParser:
     search.add_argument("--abstract-contains", dest="abstract_contains", help="摘要包含关键词")
     search.add_argument("--sort-by-year", choices=["desc", "asc", "none"], default="desc",
                         dest="sort_by_year", help="按年份排序，默认 desc；与 query 同传会冲突")
+    search.add_argument("--freshness-boost", choices=["NONE", "MILD", "STRONG"], default="NONE",
+                        dest="freshness_boost",
+                        help="模糊搜索新鲜度加权：MILD=近10年加权 / STRONG=近3年加权。仅 query 非空时生效；与 sort-by-year 互斥")
     search.add_argument("--page", type=int, default=1, help="页码，从 1 开始")
     search.add_argument("--page-size", type=int, default=10, dest="page_size",
                         help="每页数量，默认 10，上限 50")

{sciverse-0.6.2 → sciverse-0.7.0}/src/sciverse/client.py

@@ -8,12 +8,13 @@ from typing import Any
 
 import httpx
 
-_SKILL_NAME = "sciverse"
 _CHANNEL = "python-sdk"
 _PLATFORM = platform.system().lower()  # "linux" | "darwin" | "windows"
+_SOURCE = f"{_PLATFORM}-{_CHANNEL}"
 
 
-_PASSTHROUGH = ("query", "page", "page_size", "fields")
+_PASSTHROUGH = ("query", "page", "page_size", "fields", "freshness_boost")
+_FRESHNESS_BOOST_VALUES = frozenset({"NONE", "MILD", "STRONG"})
 
 
 def _to_backend_payload(kwargs: dict[str, Any]) -> dict[str, Any]:
@@ -27,6 +28,13 @@ def _to_backend_payload(kwargs: dict[str, Any]) -> dict[str, Any]:
         if k in kwargs and kwargs[k] is not None:
             out[k] = kwargs[k]
 
+    # freshness_boost 校验：枚举值不合法直接报错（在打到后端前）。
+    if (boost := out.get("freshness_boost")) is not None:
+        if not isinstance(boost, str) or boost not in _FRESHNESS_BOOST_VALUES:
+            raise ValueError(
+                f"freshness_boost must be one of {sorted(_FRESHNESS_BOOST_VALUES)}, got {boost!r}"
+            )
+
     def _filter(field: str, op: str, value: Any) -> None:
         filters.append({"field": field, "operator": op, "value": value})
 
@@ -103,7 +111,8 @@ class AgentToolsClient:
 
     @staticmethod
     async def _inject_request_id(request: httpx.Request) -> None:
-        request.headers["X-Request-Id"] = f"{_SKILL_NAME}-{_PLATFORM}-{_CHANNEL}-{uuid.uuid4()}"
+        request.headers["X-Request-Id"] = str(uuid.uuid4())
+        request.headers["X-Sciverse-Source"] = _SOURCE
 
     async def __aenter__(self) -> "AgentToolsClient":
         return self
@@ -126,6 +135,9 @@ class AgentToolsClient:
         - subjects  → filter subjects IN
         - filters_advanced  → 直接拼到 filters 列表
         - sort_by_year  → sort publication_published_year DESC/ASC
+        - freshness_boost  → 模糊搜索新鲜度加权（NONE/MILD/STRONG，默认 NONE）。
+          仅 query 非空时生效；与 sort_by_year 互斥（boost 已在影响排序）。
+          MILD: 近 10 年加权，适合日常查文献；STRONG: 近 3 年，适合跟踪研究方向。
         """
         body = _to_backend_payload(kwargs)
         resp = await self._client.post("/meta-search", json=body)

{sciverse-0.6.2 → sciverse-0.7.0}/src/sciverse/tools.py

@@ -1,7 +1,7 @@
 """Auto-generated. Do not edit. Run scripts/build.sh."""
 import json
 
-TOOLS_VERSION = "0.6.2"
+TOOLS_VERSION = "0.7.0"
 
 OPENAI_TOOLS = json.loads(r"""
 [
@@ -95,6 +95,16 @@ OPENAI_TOOLS = json.loads(r"""
             ],
             "default": "desc"
           },
+          "freshness_boost": {
+            "type": "string",
+            "enum": [
+              "NONE",
+              "MILD",
+              "STRONG"
+            ],
+            "default": "NONE",
+            "description": "模糊搜索新鲜度加权（仅 query 非空时生效；与 sort_by_year 互斥）。\nMILD: 近 10 年加权，适合日常查文献；STRONG: 近 3 年加权，适合跟踪\n研究方向 / 追最新进展。底层为 function_score + gauss decay over\npublication_published_date。\n"
+          },
           "page": {
             "type": "integer",
             "default": 1,
@@ -317,6 +327,16 @@ ANTHROPIC_TOOLS = json.loads(r"""
           ],
           "default": "desc"
         },
+        "freshness_boost": {
+          "type": "string",
+          "enum": [
+            "NONE",
+            "MILD",
+            "STRONG"
+          ],
+          "default": "NONE",
+          "description": "模糊搜索新鲜度加权（仅 query 非空时生效；与 sort_by_year 互斥）。\nMILD: 近 10 年加权，适合日常查文献；STRONG: 近 3 年加权，适合跟踪\n研究方向 / 追最新进展。底层为 function_score + gauss decay over\npublication_published_date。\n"
+        },
         "page": {
           "type": "integer",
           "default": 1,

{sciverse-0.6.2 → sciverse-0.7.0}/src/sciverse/types.py

@@ -33,6 +33,20 @@ class SortByYear(Enum):
     none = "none"
 
 
+class FreshnessBoost(Enum):
+    """
+    模糊搜索新鲜度加权（仅 query 非空时生效；与 sort_by_year 互斥）。
+    MILD: 近 10 年加权，适合日常查文献；STRONG: 近 3 年加权，适合跟踪
+    研究方向 / 追最新进展。底层为 function_score + gauss decay over
+    publication_published_date。
+
+    """
+
+    NONE = "NONE"
+    MILD = "MILD"
+    STRONG = "STRONG"
+
+
 class SearchPapersRequest(BaseModel):
     query: str | None = Field(
         None,
@@ -61,6 +75,10 @@ class SearchPapersRequest(BaseModel):
         None, description="高级过滤逃生舱（仅当上述字段不够用时使用）。"
     )
     sort_by_year: SortByYear | None = "desc"
+    freshness_boost: FreshnessBoost | None = Field(
+        "NONE",
+        description="模糊搜索新鲜度加权（仅 query 非空时生效；与 sort_by_year 互斥）。\nMILD: 近 10 年加权，适合日常查文献；STRONG: 近 3 年加权，适合跟踪\n研究方向 / 追最新进展。底层为 function_score + gauss decay over\npublication_published_date。\n",
+    )
     page: int | None = Field(1, ge=1)
     page_size: int | None = Field(10, ge=1, le=50)
 

{sciverse-0.6.2 → sciverse-0.7.0}/tests/test_client.py

@@ -159,3 +159,25 @@ async def test_search_papers_passthrough_keeps_only_canonical_fields():
     import json as _json
     parsed = _json.loads(route.calls.last.request.read())
     assert set(parsed.keys()) == {"query", "page", "page_size", "fields"}
+
+
+@pytest.mark.asyncio
+@respx.mock
+async def test_search_papers_freshness_boost_passthrough():
+    """freshness_boost 直接透传到 /meta-search payload。"""
+    route = respx.post("https://api.example/meta-search").mock(
+        return_value=Response(200, json={"hits": [], "total": 0, "page": 1, "page_size": 10})
+    )
+    async with AgentToolsClient(base_url="https://api.example", token="t") as c:
+        await c.search_papers(query="transformer", freshness_boost="STRONG")
+    import json as _json
+    parsed = _json.loads(route.calls.last.request.read())
+    assert parsed["freshness_boost"] == "STRONG"
+
+
+@pytest.mark.asyncio
+async def test_search_papers_freshness_boost_invalid_value_rejected():
+    """非法 freshness_boost 值在 SDK 层校验阶段就被拒（不打到后端）。"""
+    async with AgentToolsClient(base_url="https://api.example", token="t") as c:
+        with pytest.raises(ValueError, match="freshness_boost"):
+            await c.search_papers(query="x", freshness_boost="EXTREME")

{sciverse-0.6.2 → sciverse-0.7.0}/uv.lock

@@ -323,7 +323,7 @@ wheels = [
 
 [[package]]
 name = "sciverse"
-version = "0.6.1"
+version = "0.6.3"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },