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

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

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

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

{unique_sdk-2026.46.0.dev4 → unique_sdk-2026.46.0.dev5}/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.dev5}/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.dev5}/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):**