unique-sdk 2026.44.0.dev0__tar.gz → 2026.44.0.dev2__tar.gz

{unique_sdk-2026.44.0.dev0 → unique_sdk-2026.44.0.dev2}/PKG-INFO

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

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

{unique_sdk-2026.44.0.dev0 → unique_sdk-2026.44.0.dev2}/unique_sdk/api_resources/_mcp.py

@@ -46,6 +46,29 @@ class CallToolContentDto(TypedDict):
     ]  # For type: "resource"
 
 
+class McpServerToolDto(TypedDict):
+    """A tool of an MCP server that the company has enabled."""
+
+    name: str
+    description: str | None
+
+
+class McpServerDto(TypedDict):
+    """An MCP server (connector) of the company that can be attached to a space."""
+
+    id: str
+    name: str
+    description: str | None
+    requiresOAuth: bool
+    isSpaceRestricted: bool
+    allowedSpaceIds: list[str]
+    tools: list[McpServerToolDto]
+
+
+class McpServersResponse(TypedDict):
+    mcpServers: list[McpServerDto]
+
+
 class MCP(APIResource["MCP"]):
     @classproperty
     def OBJECT_NAME(cls) -> Literal["mcp.call_tool"]:
@@ -128,3 +151,57 @@ class MCP(APIResource["MCP"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def list_servers(
+        cls,
+        user_id: str,
+        company_id: str,
+    ) -> McpServersResponse:
+        """
+        List the company's MCP servers that can be attached to a space, with their
+        tools. Never returns server URLs or credentials.
+
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+
+        Returns:
+            McpServersResponse: The servers, sorted by name
+        """
+        return cast(
+            McpServersResponse,
+            cls._static_request(
+                "get",
+                "/mcp/servers",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def list_servers_async(
+        cls,
+        user_id: str,
+        company_id: str,
+    ) -> McpServersResponse:
+        """
+        Asynchronously list the company's MCP servers that can be attached to a space,
+        with their tools. Never returns server URLs or credentials.
+
+        Args:
+            user_id: The ID of the user making the request
+            company_id: The ID of the company
+
+        Returns:
+            McpServersResponse: The servers, sorted by name
+        """
+        return cast(
+            McpServersResponse,
+            await cls._static_request_async(
+                "get",
+                "/mcp/servers",
+                user_id,
+                company_id,
+            ),
+        )

{unique_sdk-2026.44.0.dev0 → unique_sdk-2026.44.0.dev2}/unique_sdk/api_resources/_space.py

@@ -19,7 +19,11 @@ class Space(APIResource["Space"]):
         return "space"
 
     UiType: TypeAlias = Literal[
-        "MAGIC_TABLE", "UNIQUE_CUSTOM", "TRANSLATION", "UNIQUE_AI"
+        "MAGIC_TABLE",
+        "UNIQUE_CUSTOM",
+        "TRANSLATION",
+        "UNIQUE_AI",
+        "SWAPPABLE_INTELLIGENCE",
     ]
 
     class ModuleParams(TypedDict):
@@ -57,6 +61,24 @@ class Space(APIResource["Space"]):
         isExclusive: bool
         configuration: dict[str, Any]
 
+    class McpServerToolParams(TypedDict):
+        name: str
+        isEnabled: bool
+
+    class McpServerParams(TypedDict):
+        """
+        An MCP server (connector) to attach to a space.
+
+        Only listed servers change. ``tools`` is the complete selection for the server:
+        listed tools take ``isEnabled``, unlisted tools are disabled, and an empty list
+        disables the server for the space. Omit ``tools`` to enable every callable tool.
+        Applied after MCP tool entries in module configurations, so it wins for a server
+        that appears in both. Use ``MCP.list_servers`` for the ids and tool names.
+        """
+
+        mcpServerId: str
+        tools: NotRequired[list["Space.McpServerToolParams"] | None]
+
     class CreateSpaceParams(RequestOptions):
         name: str
         fallbackModule: str
@@ -77,6 +99,7 @@ class Space(APIResource["Space"]):
         isSubAgent: NotRequired[bool | None]
         subAgentSettings: NotRequired["Space.SubAgentSettings | None"]
         subAgentIds: NotRequired[list[str] | None]
+        mcpServers: NotRequired[list["Space.McpServerParams"] | None]
 
     class UpdateParams(RequestOptions):
         name: NotRequired[str | None]
@@ -98,6 +121,7 @@ class Space(APIResource["Space"]):
         isSubAgent: NotRequired[bool | None]
         subAgentSettings: NotRequired["Space.SubAgentSettings | None"]
         subAgentIds: NotRequired[list[str] | None]
+        mcpServers: NotRequired[list["Space.McpServerParams"] | None]
 
     class AccessEntry(TypedDict):
         entityId: str
@@ -261,6 +285,10 @@ class Space(APIResource["Space"]):
         messages: list["Space.Message"]
         totalCount: int
 
+    class McpServerTool(TypedDict):
+        name: str
+        isEnabled: bool
+
     class McpServer(TypedDict):
         """
         Represents an MCP server associated with a space.
@@ -271,9 +299,27 @@ class Space(APIResource["Space"]):
         assistantId: str
         mcpServerId: str
         isEnabled: bool
+        tools: NotRequired[list["Space.McpServerTool"]]
         createdAt: str
         updatedAt: str
 
+    class McpServerStatus(TypedDict):
+        """
+        The calling user's own state for an MCP server enabled on a space.
+        """
+
+        mcpServerId: str
+        name: str
+        isEnabled: bool
+        requiresOAuth: bool
+        isOAuth2Connected: bool
+        oauth2Url: str | None
+        enabledToolNames: list[str]
+
+    class McpServerStatusResponse(TypedDict):
+        spaceId: str
+        mcpServers: list["Space.McpServerStatus"]
+
     class Module(TypedDict):
         """
         Represents a module configured for a space.
@@ -911,3 +957,45 @@ class Space(APIResource["Space"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def get_mcp_server_status(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.McpServerStatusResponse":
+        """
+        Get the MCP servers enabled on a space with the calling user's own OAuth
+        connection state (``isOAuth2Connected``, ``oauth2Url``).
+        """
+        return cast(
+            "Space.McpServerStatusResponse",
+            cls._static_request(
+                "get",
+                f"/space/{space_id}/mcp-servers/status",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_mcp_server_status_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.McpServerStatusResponse":
+        """
+        Async get the MCP servers enabled on a space with the calling user's own OAuth
+        connection state (``isOAuth2Connected``, ``oauth2Url``).
+        """
+        return cast(
+            "Space.McpServerStatusResponse",
+            await cls._static_request_async(
+                "get",
+                f"/space/{space_id}/mcp-servers/status",
+                user_id,
+                company_id,
+            ),
+        )

{unique_sdk-2026.44.0.dev0 → unique_sdk-2026.44.0.dev2}/unique_sdk/cli/cli.py

@@ -59,6 +59,9 @@ from unique_sdk.cli.commands.files import (
     is_permission_denied_output as _is_permission_denied_output,
 )
 from unique_sdk.cli.commands.folders import cmd_mkdir, cmd_mvdir, cmd_rmdir
+from unique_sdk.cli.commands.folders import (
+    is_mkdir_error_output as _is_mkdir_error_output,
+)
 from unique_sdk.cli.commands.mcp import cmd_mcp
 from unique_sdk.cli.commands.navigation import cmd_cd, cmd_ls, cmd_pwd
 from unique_sdk.cli.commands.read import cmd_read
@@ -335,7 +338,7 @@ def mkdir(ctx: click.Context, name: str) -> None:
       unique-cli mkdir "2025/Q1"
     """
     output = cmd_mkdir(LazyState.get(ctx), name)
-    emit(output)
+    emit(output, is_error=_is_mkdir_error_output)
 
 
 @main.command()

{unique_sdk-2026.44.0.dev0 → unique_sdk-2026.44.0.dev2}/unique_sdk/cli/commands/folders.py

@@ -53,7 +53,8 @@ def cmd_mkdir(state: ShellState, name: str) -> str:
     # Resolve the destination (collapsing any `..`) and gate the *path*, not
     # just the current scope id: `mkdir ../../Other/X` would otherwise pass a
     # cwd-only check and create structure outside the per-message task scope.
-    full_path = os.path.normpath(f"{state.cwd.rstrip('/')}/{name}")
+    path = name if name.startswith("/") else f"{state.cwd.rstrip('/')}/{name}"
+    full_path = os.path.normpath(path)
     if not state.folder_path_allowed_by_metadata_filter(full_path):
         return (
             "mkdir: permission denied: destination is outside your task scope "
@@ -74,6 +75,15 @@ def cmd_mkdir(state: ShellState, name: str) -> str:
         return f"mkdir: {e}"
 
 
+def is_mkdir_error_output(output: str) -> bool:
+    """Return True when *output* is a ``cmd_mkdir`` error.
+
+    Success text is ``Created: ...``. Scope denials and API failures both
+    start with ``mkdir:`` and must exit non-zero from the one-shot CLI.
+    """
+    return output.startswith("mkdir:")
+
+
 def cmd_rmdir(state: ShellState, target: str, recursive: bool = False) -> str:
     """Delete a folder by path or scope ID."""
     # An active per-message filter replaces the static scopeIds, so skip the