unique-sdk 2026.40.0.dev1__tar.gz → 2026.40.0.dev2__tar.gz

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.40.0.dev1
+Version: 2026.40.0.dev2
 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.40.0.dev1 → unique_sdk-2026.40.0.dev2}/pyproject.toml

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

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/unique_sdk/cli/commands/cite_file.py

@@ -13,6 +13,7 @@ from unique_sdk.cli.commands._citation_manifest import (
 )
 from unique_sdk.cli.commands.files import _resolve_content_id
 from unique_sdk.cli.state import ShellState
+from unique_sdk.cli.workspace import manifest_path as workspace_manifest_path
 
 CITE_ERROR_PREFIX = "cite:"
 
@@ -153,7 +154,7 @@ def _resolve_content_id_with_manifest(
             )
         return name_or_id, state.resolve_content_title(name_or_id)
 
-    manifest_path = Path.cwd() / _CHAT_FILES_MANIFEST
+    manifest_path = workspace_manifest_path(_CHAT_FILES_MANIFEST)
     if manifest_path.is_file():
         try:
             manifest: dict[str, str] = json.loads(
@@ -221,7 +222,7 @@ def cmd_cite_file(
     if not page_list:
         return f"{CITE_ERROR_PREFIX} invalid --pages value"
 
-    refs_log_path = Path.cwd() / _FILE_REFS_LOG_RELATIVE_PATH
+    refs_log_path = workspace_manifest_path(_FILE_REFS_LOG_RELATIVE_PATH)
 
     try:
         with _locked_turn_refs_manifest(

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/unique_sdk/cli/commands/mcp.py

@@ -21,6 +21,8 @@ from unique_sdk.cli.commands._citation_manifest import (
 )
 from unique_sdk.cli.formatting import format_mcp_response
 from unique_sdk.cli.state import ShellState
+from unique_sdk.cli.workspace import manifest_path as workspace_manifest_path
+from unique_sdk.cli.workspace import unique_dir as workspace_unique_dir
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -643,7 +645,9 @@ def _annotate_mcp_results_for_citations(
     merge for title-less items only). Best-effort — returns ``[]`` on any failure
     (the tool result is unaffected; only the citation Sources block is skipped).
     """
-    refs_log_path = refs_log_path or (Path.cwd() / _MCP_REFS_LOG_RELATIVE_PATH)
+    refs_log_path = refs_log_path or workspace_manifest_path(
+        _MCP_REFS_LOG_RELATIVE_PATH
+    )
     annotated: list[tuple[int, dict[str, Any]]] = []
     try:
         items = _extract_mcp_citation_items(
@@ -792,12 +796,13 @@ def _append_mcp_output_manifest(
     call when the write fails.
 
     ``output_path`` is the full path of the ``mcp-output.jsonl`` manifest. It
-    defaults to ``Path.cwd() / .unique / mcp-output.jsonl`` so the CLI flow
-    (where cwd is the agent workspace) is unchanged; callers that run outside
-    the workspace cwd (e.g. the in-process tools-mode proxy) pass it explicitly.
+    defaults to ``<workspace root>/.unique/mcp-output.jsonl``; callers outside
+    the workspace (e.g. the in-process tools-mode proxy) pass it explicitly.
     """
     try:
-        refs_log_path = output_path or (Path.cwd() / _MCP_OUTPUT_LOG_RELATIVE_PATH)
+        refs_log_path = output_path or workspace_manifest_path(
+            _MCP_OUTPUT_LOG_RELATIVE_PATH
+        )
         _append_turn_refs_manifest_entry(
             refs_log_path,
             {
@@ -945,7 +950,7 @@ def cmd_mcp(
         response,
         tool_name=name,
         server_name=server_name,
-        unique_dir=Path.cwd() / ".unique",
+        unique_dir=workspace_unique_dir(),
         formatted_text=formatted,
         reference_mapping=state.mcp_tool_reference_mappings.get(name),
     )

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/unique_sdk/cli/commands/search.py

@@ -26,6 +26,7 @@ from unique_sdk.cli.commands._citation_manifest import (
     _read_turn_refs_manifest,
 )
 from unique_sdk.cli.state import ShellState
+from unique_sdk.cli.workspace import manifest_path as workspace_manifest_path
 
 DEFAULT_LIMIT = 200
 
@@ -283,7 +284,7 @@ def cmd_search(
     except (ValueError, unique_sdk.UniqueError) as e:
         return f"{SEARCH_ERROR_PREFIX} {e}"
 
-    log_path = refs_log_path or (Path.cwd() / _REFS_LOG_RELATIVE_PATH)
+    log_path = refs_log_path or workspace_manifest_path(_REFS_LOG_RELATIVE_PATH)
     try:
         return _format_results_with_citations(results, refs_log_path=log_path)
     except UnsafeRefsLogPathError as exc:
@@ -346,7 +347,7 @@ def cmd_uploaded_search(
     except (ValueError, unique_sdk.UniqueError) as e:
         return f"{UPLOADED_SEARCH_ERROR_PREFIX} {e}"
 
-    log_path = refs_log_path or (Path.cwd() / _REFS_LOG_RELATIVE_PATH)
+    log_path = refs_log_path or workspace_manifest_path(_REFS_LOG_RELATIVE_PATH)
     try:
         return _format_results_with_citations(results, refs_log_path=log_path)
     except UnsafeRefsLogPathError as exc:

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/unique_sdk/cli/commands/web_search.py

@@ -35,6 +35,7 @@ from unique_sdk.cli.commands.web_search_config import (
     load_overrides,
 )
 from unique_sdk.cli.state import ShellState
+from unique_sdk.cli.workspace import manifest_path as workspace_manifest_path
 
 _LOGGER = logging.getLogger(__name__)
 
@@ -110,7 +111,9 @@ def _annotate_web_results_for_citations(
     (UN-23356). The on-screen result still shows the error text so the
     agent can react to the failed fetch.
     """
-    refs_log_path = refs_log_path or (Path.cwd() / _WEB_REFS_LOG_RELATIVE_PATH)
+    refs_log_path = refs_log_path or workspace_manifest_path(
+        _WEB_REFS_LOG_RELATIVE_PATH
+    )
     with _locked_turn_refs_manifest(
         refs_log_path, lock_filename=_WEB_REFS_LOCK_FILENAME
     ):

{unique_sdk-2026.40.0.dev1 → unique_sdk-2026.40.0.dev2}/unique_sdk/cli/state.py

@@ -10,6 +10,7 @@ from typing import Any
 import unique_sdk
 from unique_sdk.cli.config import Config
 from unique_sdk.cli.metadata_filter import MetadataFilter
+from unique_sdk.cli.workspace import manifest_path as workspace_manifest_path
 
 _SEARCH_CONFIG_FILENAME = ".unique-search.json"
 _UPLOADED_CONFIG_FILENAME = ".unique-uploaded.json"
@@ -120,7 +121,7 @@ def _load_chat_file_content_ids() -> set[str]:
     documents, so they must stay readable regardless of the per-message KB
     scope filter. Returns an empty set when the manifest is absent or invalid.
     """
-    path = Path.cwd() / _CHAT_FILES_MANIFEST_PATH
+    path = workspace_manifest_path(_CHAT_FILES_MANIFEST_PATH)
     if not path.is_file():
         return set()
     try:

unique_sdk-2026.40.0.dev2/unique_sdk/cli/workspace.py

@@ -0,0 +1,79 @@
+"""Resolve the workspace root that per-turn ``.unique/`` manifests belong to.
+
+The platform reads manifests back against a fixed root, and the agent moves
+the shell's directory with ``cd``. Manifest paths anchor here; user-facing
+output paths MUST NEVER, so ``cd out && unique-cli download X`` still lands
+in ``out``.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+from unique_sdk.cli.identity import TURN_IDENTITY_ENV_VAR
+
+WORKSPACE_ENV_VAR = "UNIQUE_WORKSPACE_DIR"
+UNIQUE_DIR_NAME = ".unique"
+
+
+def workspace_root() -> Path:
+    """Directory the ``.unique`` manifest tree hangs off. Never raises.
+
+    ``$UNIQUE_WORKSPACE_DIR``, then the workspace holding
+    ``$UNIQUE_TURN_IDENTITY_FILE``, then ``$HOME``, then the cwd. NEVER add an
+    ancestor walk: a directory that once ran a turn keeps a stray
+    ``sub/.unique`` that would capture every later call made from inside it.
+    """
+    for candidate in (
+        _from_env(),
+        _from_turn_identity(),
+        _from_home(),
+    ):
+        if candidate is not None:
+            return candidate
+    return Path.cwd()
+
+
+def unique_dir() -> Path:
+    """``<workspace root>/.unique``, not created here."""
+    return workspace_root() / UNIQUE_DIR_NAME
+
+
+def manifest_path(relative: Path | str) -> Path:
+    """Anchor a manifest path such as ``.unique/web-refs.jsonl``."""
+    return workspace_root() / relative
+
+
+def _is_dir(path: Path) -> bool:
+    try:
+        return path.is_dir()
+    except OSError:
+        return False
+
+
+def _from_env() -> Path | None:
+    raw = os.environ.get(WORKSPACE_ENV_VAR, "").strip()
+    if not raw:
+        return None
+    candidate = Path(raw)
+    return candidate if _is_dir(candidate) else None
+
+
+def _from_turn_identity() -> Path | None:
+    raw = os.environ.get(TURN_IDENTITY_ENV_VAR, "").strip()
+    if not raw:
+        return None
+    identity = Path(raw)
+    if identity.parent.name != UNIQUE_DIR_NAME:
+        return None
+    root = identity.parent.parent
+    return root if _is_dir(root) else None
+
+
+def _from_home() -> Path | None:
+    raw = os.environ.get("HOME", "").strip()
+    if not raw:
+        return None
+    home = Path(raw)
+    return home if _is_dir(home / UNIQUE_DIR_NAME) else None