openrag-sdk 0.3.1__tar.gz → 0.4.0.dev0__tar.gz

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrag-sdk
-Version: 0.3.1
+Version: 0.4.0.dev0
 Summary: Official Python SDK for OpenRAG API
 Author: OpenRAG Team
 License-Expression: MIT

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/openrag_sdk/__init__.py

@@ -68,7 +68,7 @@ from .models import (
     UpdateKnowledgeFilterOptions,
 )
 
-__version__ = "0.2.2"
+__version__ = "0.4.0"
 
 __all__ = [
     # Main client

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/openrag_sdk/documents.py

@@ -125,27 +125,46 @@ class DocumentsClient:
             await asyncio.sleep(poll_interval)
             elapsed += poll_interval
 
-        raise TimeoutError(f"Ingestion task {task_id} did not complete within {timeout}s")
+        raise TimeoutError(
+            f"Ingestion task {task_id} did not complete within {timeout}s"
+        )
 
-    async def delete(self, filename: str) -> DeleteDocumentResponse:
+    async def delete(
+        self,
+        filename: str | None = None,
+        *,
+        filter_id: str | None = None,
+    ) -> DeleteDocumentResponse:
         """
-        Delete a document from the knowledge base.
+        Delete document(s) from the knowledge base.
 
-        Args:
-            filename: Name of the file to delete.
+        Provide exactly one of:
+            filename: delete all chunks for that filename.
+            filter_id: delete chunks for each filename in the filter's data_sources.
 
         Returns:
             DeleteDocumentResponse with deleted chunk count.
         """
+        if bool(filename) == bool(filter_id):
+            raise ValueError("Provide exactly one of `filename` or `filter_id`")
+
+        body: dict[str, str] = {}
+        if filename is not None:
+            body["filename"] = filename
+        if filter_id is not None:
+            body["filter_id"] = filter_id
+
         try:
             response = await self._client._request(
                 "DELETE",
                 "/api/v1/documents",
-                json={"filename": filename},
+                json=body,
             )
         except NotFoundError as e:
-            # Keep delete idempotent for SDK callers: a missing document is not an exception.
-            if getattr(e, "status_code", None) == 404:
+            # Keep delete idempotent for SDK callers: a missing document is not
+            # an exception.
+            # Filter-not-found 404s still raise because the filter_id is caller input.
+            if filename is not None and getattr(e, "status_code", None) == 404:
                 return DeleteDocumentResponse(
                     success=False,
                     deleted_chunks=0,

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/openrag_sdk/models.py

@@ -1,7 +1,6 @@
 """OpenRAG SDK data models."""
 
-from datetime import datetime
-from typing import Any, Literal
+from typing import Literal
 
 from pydantic import BaseModel, Field
 
@@ -98,6 +97,10 @@ class DeleteDocumentResponse(BaseModel):
     filename: str | None = None
     message: str | None = None
     error: str | None = None
+    # Populated when deleting by filter_id — one entry per resolved data_source.
+    filenames: list[str] | None = None
+    filter_id: str | None = None
+    per_file: list[dict] | None = None
 
 
 # Chat history models

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/openrag_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openrag-sdk
-Version: 0.3.1
+Version: 0.4.0.dev0
 Summary: Official Python SDK for OpenRAG API
 Author: OpenRAG Team
 License-Expression: MIT

{openrag_sdk-0.3.1 → openrag_sdk-0.4.0.dev0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "openrag-sdk"
-version = "0.3.1"
+version = "0.4.0.dev0"
 description = "Official Python SDK for OpenRAG API"
 readme = "README.md"
 license = "MIT"