unique-sdk 2026.26.0.dev13__tar.gz → 2026.26.0.dev15__tar.gz

{unique_sdk-2026.26.0.dev13 → unique_sdk-2026.26.0.dev15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.26.0.dev13
+Version: 2026.26.0.dev15
 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.26.0.dev13 → unique_sdk-2026.26.0.dev15}/pyproject.toml

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

{unique_sdk-2026.26.0.dev13 → unique_sdk-2026.26.0.dev15}/unique_sdk/api_resources/_dynamic_frontend.py

@@ -16,6 +16,8 @@ class DynamicFrontend(APIResource["DynamicFrontend"]):
     spaceId: str
     name: str
     contentId: str
+    url: str | None
+    configUrl: str | None
     status: dict[str, object] | None
 
     class CreateParams(RequestOptions):

{unique_sdk-2026.26.0.dev13 → unique_sdk-2026.26.0.dev15}/unique_sdk/cli/commands/dynamic_frontend.py

@@ -36,12 +36,15 @@ def _format_space(space: object) -> str:
     content_id = getattr(space, "contentId", "")
     status = getattr(space, "status", None)
     phase = ""
-    url = ""
+    url = str(getattr(space, "url", "") or "")
+    config_url = str(getattr(space, "configUrl", "") or "")
     if isinstance(status, dict):
         phase = str(status.get("phase") or "")
-        url = str(status.get("url") or "")
+        url = url or str(status.get("url") or "")
     return "\t".join(
-        part for part in [str(space_id), str(name), str(content_id), phase, url] if part
+        part
+        for part in [str(space_id), str(name), str(content_id), phase, url, config_url]
+        if part
     )
 
 
@@ -93,9 +96,21 @@ def cmd_dynamic_frontend_deploy(
 
         space_id_value = getattr(space, "spaceId", None) or getattr(space, "id", "")
         name_value = getattr(space, "name", name or "")
+        url_value = getattr(space, "url", None)
+        config_url_value = getattr(space, "configUrl", None)
+        url_line = (
+            f"\nURL: {url_value}" if isinstance(url_value, str) and url_value else ""
+        )
+        config_url_line = (
+            f"\nConfig URL: {config_url_value}"
+            if isinstance(config_url_value, str) and config_url_value
+            else ""
+        )
         return (
             f'{action} Dynamic Frontend space "{name_value}" ({space_id_value})\n'
             f"Content: {resolved_content_id}"
+            f"{url_line}"
+            f"{config_url_line}"
         )
     except (ValueError, unique_sdk.APIError, OSError) as e:
         return f"dynamic-frontend deploy: {e}"

unique_sdk-2026.26.0.dev15/unique_sdk/cli/skills/unique-cli-dynamic-frontend/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: unique-cli-dynamic-frontend
+description: >-
+  Create, update, and list Unique Dynamic Frontend Spaces using the
+  `unique-cli dynamic-frontend` command. Use when deploying a generated
+  Dynamic Frontend ZIP, updating an existing Dynamic Frontend Space bundle,
+  listing manageable Dynamic Frontend Spaces, or when the user mentions
+  Dynamic Frontend Space deployment through the CLI.
+---
+
+# Unique CLI -- Dynamic Frontend Spaces
+
+Use `unique-cli dynamic-frontend` to create or update Dynamic Frontend Spaces
+from upload-ready ZIP bundles or existing Knowledge Base content IDs.
+
+The CLI is installed via `pip install unique-sdk` and uses the same
+`UNIQUE_USER_ID`, `UNIQUE_COMPANY_ID`, `UNIQUE_API_KEY`, `UNIQUE_APP_ID`, and
+`UNIQUE_API_BASE` environment variables as the rest of `unique-cli`.
+
+## Create a New Space
+
+To upload a ZIP and create a new Dynamic Frontend Space:
+
+```bash
+unique-cli cd /Apps
+unique-cli dynamic-frontend deploy \
+  --file ./revenue-dashboard.zip \
+  --name "Revenue Dashboard"
+```
+
+To create from an already uploaded KB content ID:
+
+```bash
+unique-cli dynamic-frontend deploy \
+  --content-id cont_abc123 \
+  --name "Revenue Dashboard"
+```
+
+The command prints the created `spaceId`, `contentId`, and **two** URLs when the
+API returns them — the user-facing view `URL` (jump into the Space in the chat
+app) and the `Config URL` (configure and share the Space in the admin app):
+
+```text
+Created Dynamic Frontend space "Revenue Dashboard" (space_abc123)
+Content: cont_abc123
+URL: https://next.qa.unique.app/chat/space/space_abc123
+Config URL: https://next.qa.unique.app/admin/dynamic-frontend-space/space_abc123
+```
+
+If the installed SDK/CLI version does not print one of these URLs yet, construct
+it from the known frontend base URLs and `spaceId`:
+
+```text
+# View URL (chat app)
+<chat-frontend-url>/space/<spaceId>
+# Config/share URL (admin app)
+<admin-frontend-url>/dynamic-frontend-space/<spaceId>
+```
+
+On QA, those are:
+
+```text
+https://next.qa.unique.app/chat/space/<spaceId>
+https://next.qa.unique.app/admin/dynamic-frontend-space/<spaceId>
+```
+
+## Update an Existing Space
+
+Use `--space-id` to update an existing Dynamic Frontend Space instead of
+creating a new one.
+
+Upload a new ZIP and point the existing Space at it:
+
+```bash
+unique-cli cd /Apps
+unique-cli dynamic-frontend deploy \
+  --space-id space_abc123 \
+  --file ./revenue-dashboard-1.0.1.zip
+```
+
+Update from an already uploaded KB content ID:
+
+```bash
+unique-cli dynamic-frontend deploy \
+  --space-id space_abc123 \
+  --content-id cont_newbundle123
+```
+
+Rename while updating the bundle:
+
+```bash
+unique-cli dynamic-frontend deploy \
+  --space-id space_abc123 \
+  --file ./revenue-dashboard-1.0.1.zip \
+  --name "Revenue Dashboard"
+```
+
+The update command prints the same `spaceId`, `contentId`, view `URL`, and
+`Config URL` fields as create.
+
+## List Spaces
+
+List Dynamic Frontend Spaces the current user can manage:
+
+```bash
+unique-cli dynamic-frontend list
+```
+
+Use JSON output for scripts:
+
+```bash
+unique-cli dynamic-frontend list --json
+unique-cli dynamic-frontend deploy --space-id space_abc123 --file ./app.zip --json
+```
+
+## Rules
+
+- For `--file`, first `unique-cli cd` into the KB folder where the ZIP should be
+  uploaded; uploading to root is rejected.
+- Use `--space-id` for updates. Without `--space-id`, `deploy` creates a new
+  Dynamic Frontend Space and requires `--name`.
+- `--file` and `--content-id` are mutually exclusive.
+- After create or update, return the CLI output to the user, especially both the
+  view `URL` (jump to the Space) and the `Config URL` (configure/share the Space).
+- Never report the BYOC iframe runtime URL
+  (`https://byoc.../serve/df-assistant-...`) as the Space URL; it is an
+  internal iframe launch URL, not the navigation link users need.