unique-sdk 2026.46.0.dev4__tar.gz → 2026.46.0.dev6__tar.gz

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.46.0.dev4
+Version: 2026.46.0.dev6
 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.46.0.dev4 → unique_sdk-2026.46.0.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_sdk"
-version = "2026.46.0.dev4"
+version = "2026.46.0.dev6"
 description = ""
 readme = "README.md"
 license = { text = "MIT" }

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/cli.py

@@ -545,7 +545,7 @@ def download(ctx: click.Context, name_or_id: str, local_dest: str | None) -> Non
 
 
 @main.command(name="cite")
-@click.argument("name_or_id")
+@click.argument("names_or_ids", nargs=-1, required=True)
 @click.option(
     "--pages",
     "-p",
@@ -569,19 +569,22 @@ def download(ctx: click.Context, name_or_id: str, local_dest: str | None) -> Non
 @click.pass_context
 def cite(
     ctx: click.Context,
-    name_or_id: str,
+    names_or_ids: tuple[str, ...],
     pages: str | None,
     read_method: str,
 ) -> None:
-    """Declare page citations for a file.
+    """Declare page citations for one or more files.
 
     \b
     Registers [filesourceN] markers for pages you referenced in your answer.
     Does NOT read or extract the file — use your own tools for that.
-    NAME_OR_ID can be a file path, current-directory file name, or content ID.
+    Each NAME_OR_ID can be a file path, current-directory file name, or
+    content ID. Pass several to cite them in one call.
     --read-method is mandatory: it records how you read the page(s).
     --pages is optional; omit it to cite the whole file (e.g. non-paginated
-    formats).
+    formats). With several files, --pages and --read-method apply to each.
+    A file that fails does not stop the others; the exit code is non-zero
+    when any file failed.
 
     \b
     Examples:
@@ -589,9 +592,19 @@ def cite(
       unique-cli cite /Reports/Q1/report.pdf --pages 3,5,7 --read-method vision
       unique-cli cite cont_abc123 --pages 1-4 --read-method indexed
       unique-cli cite notes.docx --read-method text
+      unique-cli cite a.xlsx b.xlsx c.csv --read-method text
     """
-    output = cmd_cite_file(LazyState.get(ctx), name_or_id, pages, read_method)
-    emit(output, is_error=_is_cite_error_output)
+    state = LazyState.get(ctx)
+    any_failed = False
+    for name_or_id in names_or_ids:
+        output = cmd_cite_file(state, name_or_id, pages, read_method)
+        if _is_cite_error_output(output):
+            any_failed = True
+            click.echo(output, err=True)
+        else:
+            click.echo(output)
+    if any_failed:
+        raise SystemExit(1)
 
 
 @main.command(name="read")

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/commands/navigation.py

@@ -184,14 +184,10 @@ def cmd_ls(
         else:
             resolved_path, scope_id = state.cwd, state.scope_id
 
-        # A non-root target must lie inside the per-message scope: without
-        # this, `ls <path>` would enumerate out-of-scope folders/files that
-        # read/cite correctly deny. See UN-21780.
-        if (
-            scope_id is not None
-            and state.workspace_metadata_filter is not None
-            and not state.folder_allowed_by_metadata_filter(scope_id)
-        ):
+        # A non-root target must lie inside the task scope: without this,
+        # `ls <path>` would enumerate out-of-scope folders/files that
+        # read/cite correctly deny. See UN-21780 and UN-28458.
+        if scope_id is not None and not state.folder_navigable(scope_id):
             return (
                 f"ls: permission denied: target is outside your task scope "
                 f"({state.scope_denial_hint()})."

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/commands/search.py

@@ -214,6 +214,16 @@ def cmd_search(
         folder_scope_id: str | None = None
         if folder:
             folder_scope_id = _resolve_folder_to_scope_id(state, folder)
+            # Without a per-message filter, --folder replaces the static
+            # scopeIds, so it must lie inside them. See UN-28458.
+            if (
+                not state.workspace_metadata_filter
+                and not state.is_folder_target_within_workspace(folder_scope_id)
+            ):
+                return (
+                    f"{SEARCH_ERROR_PREFIX} permission denied: {folder} is "
+                    f"outside your task scope ({state.scope_denial_hint()})."
+                )
         elif state.scope_id and not state.workspace_metadata_filter:
             # The incidental cwd narrows search only when there is no
             # per-message filter. With a filter active, only an explicit

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/shell.py

@@ -67,7 +67,7 @@ OVERVIEW_HELP = textwrap.dedent("""\
       download <name|path|id> [dest] Download a file to local machine
       rm <name|path|id>         Delete a file
       mv <old|path|id> <new>    Rename a file
-      cite <name|path|id> [--pages] --read-method METHOD  Declare page citations
+      cite <name|path|id> [...] [--pages] --read-method METHOD  Declare page citations (one or more files)
 
     Search:
       search <query> [options]  Combined search (vector + full-text)
@@ -498,27 +498,28 @@ class UniqueShell(cmd.Cmd):
         self._print(cmd_download(self.state, name_or_id, local_dest))
 
     def do_cite(self, arg: str) -> None:
-        """Declare page citations for a file.
+        """Declare page citations for one or more files.
 
-        Usage: cite <name|path|content_id> [--pages RANGE] --read-method METHOD
+        Usage: cite <name|path|content_id> [...] [--pages RANGE] --read-method METHOD
 
         --read-method is mandatory (one of: text, vision, indexed). --pages is
-        optional; omit it to cite the whole file.
+        optional; omit it to cite the whole file. With several files, --pages
+        and --read-method apply to each; a file that fails does not stop the
+        others.
 
         Examples:
           /Reports> cite report.pdf --pages 3,5,7 --read-method text
           /Reports> cite /Reports/Q1/report.pdf --pages 3,5,7 --read-method vision
           /Reports> cite cont_abc123 --pages 1-4 --read-method indexed
           /Reports> cite notes.docx --read-method text
+          /Reports> cite a.xlsx b.xlsx c.csv --read-method text
         """
         from unique_sdk.cli.commands.cite_file import (
             READ_METHODS,
             cmd_cite_file,
         )
 
-        usage = (
-            "Usage: cite <name|path|content_id> [--pages RANGE] --read-method METHOD"
-        )
+        usage = "Usage: cite <name|path|content_id> [...] [--pages RANGE] --read-method METHOD"
         parts = shlex.split(arg)
         if not parts:
             self._print(usage)
@@ -555,7 +556,8 @@ class UniqueShell(cmd.Cmd):
                 f"cite: --read-method is required (one of: {', '.join(READ_METHODS)})"
             )
             return
-        self._print(cmd_cite_file(self.state, positional[0], pages, read_method))
+        for name_or_id in positional:
+            self._print(cmd_cite_file(self.state, name_or_id, pages, read_method))
 
     def _parse_int(self, raw: str, flag: str) -> tuple[int | None, bool]:
         """Parse an int option value, returning (value, ok). Prints on failure."""

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/skills/unique-cli-file-management/SKILL.md

@@ -83,6 +83,8 @@ unique-cli cite report.pdf --pages 3,5,7 --read-method text
 unique-cli cite cont_abc123 --pages 1-4 --read-method vision
 # Non-paginated files (Excel, CSV, txt): omit --pages to cite the whole file
 unique-cli cite data.xlsx --read-method text
+# Several files in one call (--pages and --read-method apply to each)
+unique-cli cite a.xlsx b.xlsx c.csv --read-method text
 
 # Delete a file
 unique-cli rm report.pdf
@@ -222,11 +224,19 @@ answer, declare citations. `cite` works on **any** file type, not just PDFs.
 unique-cli cite report.pdf --pages 3,5 --read-method text
 unique-cli cite cont_abc123 --pages 1-4 --read-method vision
 unique-cli cite data.xlsx --read-method text          # non-paginated: omit --pages
+unique-cli cite a.xlsx b.xlsx c.csv --read-method text # several files, one call
 ```
 
 This registers `[filesourceN]` markers. Use them inline in your answer.
 The platform converts `[filesourceN]` into footnotes and clickable reference chips.
 
+**Cite several files in ONE call.** Each `unique-cli cite` process takes seconds to
+start, so pass every file with the same `--read-method` (and the same `--pages`, if
+any) to a single call. A file that fails does not stop the others, and the command
+exits non-zero when any file failed — read stderr for the failing file. You may chain
+the call at the end of your last file-reading command (`... && unique-cli cite ...`)
+instead of spending a separate tool call on it.
+
 **Which page number to cite.** `cite` expects **physical page positions** (1-based) — the same positions ingestion assigns and that `unique-cli read` prints as `[p.N]` / `[p.N-M]` prefixes. NEVER cite a printed page number from a header/footer; those often differ from the physical position.
 
 **Preferred path — you read the file with `unique-cli read` (no download needed):**

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev6}/unique_sdk/cli/state.py

@@ -468,6 +468,16 @@ class ShellState:
             return True
         return self._metadata_filter.allows_folder_scope(scope_id)
 
+    def folder_navigable(self, scope_id: str) -> bool:
+        """True if ``ls``/``cd`` may open *scope_id* under the active scope.
+
+        The per-message filter decides when present; otherwise a non-empty
+        ``scopeIds`` list admits only those folders and their descendants.
+        """
+        if self._metadata_filter is not None:
+            return self.folder_allowed_by_metadata_filter(scope_id)
+        return self.is_folder_target_within_workspace(scope_id)
+
     def folder_path_allowed_by_metadata_filter(self, folder_path: str) -> bool:
         """True if an absolute folder *path* lies within a navigable scope.
 
@@ -564,10 +574,8 @@ class ShellState:
         return f"{self._path}> "
 
     def _require_navigable_folder(self, scope_id: str) -> None:
-        """Refuse a folder the per-message filter excludes. See UN-28458."""
-        if self._metadata_filter is None:
-            return
-        if self.folder_allowed_by_metadata_filter(scope_id):
+        """Refuse a folder outside the active scope. See UN-28458."""
+        if self.folder_navigable(scope_id):
             return
         raise ValueError(
             "permission denied: target is outside your task scope "