unique-sdk 2026.44.0.dev11__tar.gz → 2026.44.0.dev13__tar.gz

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.44.0.dev11
+Version: 2026.44.0.dev13
 Summary: 
 Author: Martin Fadler, Konstantin Krauss, Andreas Hauri
 Author-email: Martin Fadler <martin.fadler@unique.ch>, Konstantin Krauss <konstantin@unique.ch>, Andreas Hauri <andreas@unique.ch>

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_sdk"
-version = "2026.44.0.dev11"
+version = "2026.44.0.dev13"
 description = ""
 readme = "README.md"
 license = { text = "MIT" }
@@ -43,7 +43,9 @@ module-root = ""
 exclude-newer = "2 weeks"
 
 [dependency-groups]
-dev = []
+dev = [
+    "python-dotenv>=1.2.2",
+]
 
 [tool.deptry]
 known_first_party = ["unique_sdk"]
@@ -60,7 +62,8 @@ extend-select = ["I"]
 
 [tool.basedpyright]
 typeCheckingMode = "recommended"
-include = ["unique_sdk"]
+include = ["unique_sdk", "examples/basics"]
+extraPaths = ["examples/basics"]
 exclude = ["build", "**/__pycache__", "**/tests/**", "**/test_*.py"]
 allowedUntypedLibraries = ["openai.types.responses", "openai.types.shared_params"]
 # Suppress rules that require full annotation coverage of legacy internals —

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/unique_sdk/api_resources/_briefing.py

@@ -1,4 +1,4 @@
-"""Assistant briefing operations (``PUT /briefings/{assistantId}``).
+"""Assistant briefing operations on ``/briefings/{assistantId}``.
 
 Request and response shapes follow OpenAPI ``PublicUpsertBriefingRequestDto`` and
 ``PublicBriefingDto``. See :class:`Briefing.UpsertForAssistantParams`.
@@ -16,6 +16,7 @@ from unique_sdk._request_options import RequestOptions
 from unique_sdk._util import classproperty
 
 _MAX_TEXT_LEN = 4000
+_MAX_TITLE_LEN = 100
 _MAX_PROMPTS = 200
 _MAX_PROMPT_TITLE_LEN = 100
 _MAX_PROMPT_BODY_LEN = 4000
@@ -65,15 +66,16 @@ def _validate_prompts(raw: Any) -> list[dict[str, str]]:
 
 
 class _PublicUpsertBriefingWire(TypedDict):
-    """Exact JSON keys for ``PUT`` body (`PublicUpsertBriefingRequestDto`)."""
+    """Exact JSON keys for ``PUT`` body (``PublicUpsertBriefingRequestDto``)."""
 
     text: str
     generatedAt: str
     prompts: list[dict[str, str]]
+    title: NotRequired[str]
 
 
 class Briefing(APIResource["Briefing"]):
-    """Create or replace the briefing attached to an assistant."""
+    """Read, upsert, or detach the briefing attached to an assistant."""
 
     @classproperty
     def OBJECT_NAME(cls) -> Literal["briefing"]:
@@ -82,7 +84,7 @@ class Briefing(APIResource["Briefing"]):
     RESOURCE_URL = "/briefings"
 
     class BriefingPromptItem(TypedDict):
-        """One entry in ``prompts`` (``PublicPromptItemDto``)."""
+        """One entry in ``prompts`` (``PromptItemDto``)."""
 
         title: str
         body: str
@@ -93,9 +95,21 @@ class Briefing(APIResource["Briefing"]):
         text: NotRequired[str]
         generatedAt: NotRequired[str]
         prompts: list["Briefing.BriefingPromptItem"]
+        title: NotRequired[str]
         markdown: NotRequired[str]
         content: NotRequired[str]
 
+    class DeletedObject(TypedDict):
+        """Response from ``DELETE /briefings/{assistantId}`` (detach; record may remain)."""
+
+        id: str
+        object: str
+        deleted: bool
+
+    @classmethod
+    def _assistant_url(cls, assistant_id: str) -> str:
+        return "%s/%s" % (cls.RESOURCE_URL, quote_plus(assistant_id))
+
     @classmethod
     def _wire_json_from_upsert_params(
         cls, params: Mapping[str, Any]
@@ -149,7 +163,26 @@ class Briefing(APIResource["Briefing"]):
         prompts_raw = kw.pop("prompts", None)
         prompts_list = _validate_prompts(prompts_raw)
 
-        return {"text": text, "generatedAt": ga, "prompts": prompts_list}
+        wire: _PublicUpsertBriefingWire = {
+            "text": text,
+            "generatedAt": ga,
+            "prompts": prompts_list,
+        }
+
+        title_raw = kw.pop("title", None)
+        if title_raw is not None:
+            if not isinstance(title_raw, str):
+                raise TypeError(
+                    f"Briefing title must be a string, got {type(title_raw)!r}"
+                )
+            if len(title_raw) > _MAX_TITLE_LEN:
+                raise ValueError(
+                    f"Briefing title must be at most {_MAX_TITLE_LEN} characters "
+                    f"(got {len(title_raw)})"
+                )
+            wire["title"] = title_raw
+
+        return wire
 
     id: str
     object: str
@@ -163,6 +196,39 @@ class Briefing(APIResource["Briefing"]):
     createdAt: str | None
     updatedAt: str | None
 
+    @classmethod
+    def retrieve_for_assistant(
+        cls,
+        *,
+        user_id: str,
+        company_id: str,
+        assistant_id: str,
+    ) -> "Briefing":
+        """Return the briefing attached to ``assistant_id``.
+
+        Mirrors ``BriefingController_getForAssistant`` (``GET /briefings/{assistantId}``).
+        """
+        url = cls._assistant_url(assistant_id)
+        return cast(
+            "Briefing",
+            cls._static_request("get", url, user_id, company_id),
+        )
+
+    @classmethod
+    async def retrieve_for_assistant_async(
+        cls,
+        *,
+        user_id: str,
+        company_id: str,
+        assistant_id: str,
+    ) -> "Briefing":
+        """Async variant of :meth:`retrieve_for_assistant`."""
+        url = cls._assistant_url(assistant_id)
+        return cast(
+            "Briefing",
+            await cls._static_request_async("get", url, user_id, company_id),
+        )
+
     @classmethod
     def upsert_for_assistant(
         cls,
@@ -174,10 +240,9 @@ class Briefing(APIResource["Briefing"]):
     ) -> "Briefing":
         """Upsert the briefing for ``assistant_id`` (external id = assistant id).
 
-        Mirrors ``PublicBriefingController_upsertForAssistant`` (
-        ``PUT /public/briefings/{assistantId}`` on the upstream OpenAPI surface).
+        Mirrors ``BriefingController_upsertForAssistant`` (``PUT /briefings/{assistantId}``).
         """
-        url = "%s/%s" % (cls.RESOURCE_URL, quote_plus(assistant_id))
+        url = cls._assistant_url(assistant_id)
         payload = cls._wire_json_from_upsert_params(params)
         return cast(
             "Briefing",
@@ -194,9 +259,43 @@ class Briefing(APIResource["Briefing"]):
         **params: Unpack["Briefing.UpsertForAssistantParams"],
     ) -> "Briefing":
         """Async variant of :meth:`upsert_for_assistant`."""
-        url = "%s/%s" % (cls.RESOURCE_URL, quote_plus(assistant_id))
+        url = cls._assistant_url(assistant_id)
         payload = cls._wire_json_from_upsert_params(params)
         return cast(
             "Briefing",
             await cls._static_request_async("put", url, user_id, company_id, payload),
         )
+
+    @classmethod
+    def delete_for_assistant(
+        cls,
+        *,
+        user_id: str,
+        company_id: str,
+        assistant_id: str,
+    ) -> "Briefing.DeletedObject":
+        """Detach the briefing from ``assistant_id`` (underlying record may remain).
+
+        Mirrors ``BriefingController_detachForAssistant`` (
+        ``DELETE /briefings/{assistantId}``).
+        """
+        url = cls._assistant_url(assistant_id)
+        return cast(
+            "Briefing.DeletedObject",
+            cls._static_request("delete", url, user_id, company_id),
+        )
+
+    @classmethod
+    async def delete_for_assistant_async(
+        cls,
+        *,
+        user_id: str,
+        company_id: str,
+        assistant_id: str,
+    ) -> "Briefing.DeletedObject":
+        """Async variant of :meth:`delete_for_assistant`."""
+        url = cls._assistant_url(assistant_id)
+        return cast(
+            "Briefing.DeletedObject",
+            await cls._static_request_async("delete", url, user_id, company_id),
+        )

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/unique_sdk/cli/commands/files.py

@@ -11,6 +11,7 @@ from typing import Any
 
 import unique_sdk
 from unique_sdk.cli.formatting import format_content_info
+from unique_sdk.cli.metadata_filter import direct_children_filter
 from unique_sdk.cli.paths import canonical_folder_path, same_folder_path
 from unique_sdk.cli.state import ShellState
 from unique_sdk.utils.file_io import download_content, upload_file
@@ -40,9 +41,6 @@ _SUPPORTED_UPLOAD_MIME_TYPES = {
 
 # Bounds so one name resolve can never page through the whole knowledge base.
 _MAX_RESOLVE_MATCH_CANDIDATES = 100
-_MAX_RESOLVE_INFOS_PAGES = 10
-_RESOLVE_INFOS_PAGE_SIZE = 100
-_MAX_RESOLVE_INFOS_ENTRIES = _MAX_RESOLVE_INFOS_PAGES * _RESOLVE_INFOS_PAGE_SIZE
 
 
 def _normalize_unique_file_path(cwd: str, path: str) -> str:
@@ -178,19 +176,10 @@ def _resolve_content_id_in_folder(
         ),
         lookup_name=lookup_name,
     )
-    capped = False
     if match is None:
-        hits, capped = _hits_by_search(
-            state=state, lookup_name=lookup_name, scope_id=scope_id
-        )
+        hits = _hits_by_search(state=state, lookup_name=lookup_name, scope_id=scope_id)
         match = _pick_match(hits=hits, lookup_name=lookup_name)
     if match is None:
-        if capped:
-            raise ValueError(
-                f"File not found in the first {_MAX_RESOLVE_INFOS_ENTRIES} "
-                f"entries of this folder: {name_or_id}. Use 'unique-cli "
-                "search' or pass a content id (cont_...)."
-            )
         raise ValueError(f"File not found: {name_or_id}")
 
     resolved_id, display_name = match
@@ -234,8 +223,7 @@ def _hits_by_file_path(
 
 def _hits_by_search(
     *, state: ShellState, lookup_name: str, scope_id: str
-) -> tuple[Sequence[Any], bool]:
-    """Return the hits, and whether the get_infos fallback hit its page cap."""
+) -> Sequence[Any]:
     try:
         hits = unique_sdk.Content.search(
             user_id=state.config.user_id,
@@ -259,7 +247,7 @@ def _hits_by_search(
             lookup_name=lookup_name,
             scope_id=scope_id,
         )
-    return hits, False
+    return hits
 
 
 def _pick_match(*, hits: Sequence[Any], lookup_name: str) -> tuple[str, str] | None:
@@ -290,32 +278,21 @@ def _resolve_content_id_via_infos_fallback(
     state: ShellState,
     lookup_name: str,
     scope_id: str,
-) -> tuple[list[Mapping[str, Any]], bool]:
-    """Folder-scoped get_infos fallback with a hard page cap.
-
-    Returns the match (if any), and whether the cap stopped the scan early.
-    """
-    skip = 0
-    for _ in range(_MAX_RESOLVE_INFOS_PAGES):
-        result = unique_sdk.Content.get_infos(
-            user_id=state.config.user_id,
-            company_id=state.config.company_id,
-            parentId=scope_id,
-            skip=skip,
-            take=_RESOLVE_INFOS_PAGE_SIZE,
-        )
-        content_infos = result.get("contentInfos", [])
-        if not content_infos:
-            return [], False
-        for info in content_infos:
-            title = info.get("title") or ""
-            key = info.get("key") or ""
-            if lookup_name in {title, key}:
-                return [info], False
-        if len(content_infos) < _RESOLVE_INFOS_PAGE_SIZE:
-            return [], False
-        skip += len(content_infos)
-    return [], True
+) -> list[Mapping[str, Any]]:
+    """Folder-scoped get_infos fallback, filtered by name so one page suffices."""
+    name_filter = {
+        "or": [
+            {"path": ["title"], "operator": "equals", "value": lookup_name},
+            {"path": ["key"], "operator": "equals", "value": lookup_name},
+        ]
+    }
+    result = unique_sdk.Content.get_infos(
+        user_id=state.config.user_id,
+        company_id=state.config.company_id,
+        metadataFilter={"and": [direct_children_filter(scope_id), name_filter]},
+        take=_MAX_RESOLVE_MATCH_CANDIDATES,
+    )
+    return list(result.get("contentInfos", []))
 
 
 def _detect_upload_mime_type(path: Path) -> str:

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/unique_sdk/cli/commands/navigation.py

@@ -6,7 +6,10 @@ from typing import Any
 
 import unique_sdk
 from unique_sdk.cli.formatting import format_ls
-from unique_sdk.cli.metadata_filter import _collect_filter_targets
+from unique_sdk.cli.metadata_filter import (
+    _collect_filter_targets,
+    direct_children_filter,
+)
 from unique_sdk.cli.paths import canonical_folder_path, same_folder_path
 from unique_sdk.cli.state import ShellState
 
@@ -188,10 +191,8 @@ def cmd_ls(state: ShellState, target: str | None = None) -> str:
                 return path_error
 
         folder_params: dict[str, Any] = {}
-        content_params: dict[str, Any] = {}
         if scope_id:
             folder_params["parentId"] = scope_id
-            content_params["parentId"] = scope_id
 
         folder_result = unique_sdk.Folder.get_infos(
             user_id=state.config.user_id,
@@ -199,16 +200,19 @@ def cmd_ls(state: ShellState, target: str | None = None) -> str:
             **folder_params,
         )
         folders = folder_result.get("folderInfos", [])
-
-        content_result = unique_sdk.Content.get_infos(
-            user_id=state.config.user_id,
-            company_id=state.config.company_id,
-            **content_params,
-        )
-        files = content_result.get("contentInfos", [])
-
         total_folders = folder_result.get("totalCount", len(folders))
-        total_files = content_result.get("totalCount", len(files))
+
+        # Every file lives in a folder, so the root has no files of its own.
+        files: list[Any] = []
+        total_files = 0
+        if scope_id:
+            content_result = unique_sdk.Content.get_infos(
+                user_id=state.config.user_id,
+                company_id=state.config.company_id,
+                metadataFilter=direct_children_filter(scope_id),
+            )
+            files = content_result.get("contentInfos", [])
+            total_files = content_result.get("totalCount", len(files))
 
         if scope_id and not folders and not files:
             label = target if target is not None else resolved_path

{unique_sdk-2026.44.0.dev11 → unique_sdk-2026.44.0.dev13}/unique_sdk/cli/metadata_filter.py

@@ -38,6 +38,20 @@ ScopePathResolver = Callable[[str], "str | None"]
 ContentOwnerPathResolver = Callable[[str], "str | None"]
 
 
+def direct_children_filter(scope_id: str) -> dict[str, Any]:
+    """UniqueQL for files directly in ``scope_id``, not in its subfolders."""
+    return {
+        "and": [
+            {"path": ["folderIdPath"], "operator": "contains", "value": scope_id},
+            {
+                "path": ["folderIdPath"],
+                "operator": "notContains",
+                "value": f"{scope_id}/",
+            },
+        ]
+    }
+
+
 def _extract_target_scope_id(value: Any) -> str | None:
     """Deepest folder scope id referenced by a ``folderIdPath`` filter value.