unique-sdk 2026.26.0.dev14__tar.gz → 2026.26.0.dev16__tar.gz

{unique_sdk-2026.26.0.dev14 → unique_sdk-2026.26.0.dev16}/PKG-INFO

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

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

{unique_sdk-2026.26.0.dev14 → unique_sdk-2026.26.0.dev16}/unique_sdk/api_resources/_dynamic_frontend.py

@@ -17,6 +17,7 @@ class DynamicFrontend(APIResource["DynamicFrontend"]):
     name: str
     contentId: str
     url: str | None
+    configUrl: str | None
     status: dict[str, object] | None
 
     class CreateParams(RequestOptions):
@@ -64,6 +65,24 @@ class DynamicFrontend(APIResource["DynamicFrontend"]):
             ),
         )
 
+    @classmethod
+    def delete(
+        cls,
+        space_id: str,
+        user_id: str,
+        company_id: str,
+    ) -> "DynamicFrontend":
+        """Delete a deployed Dynamic Frontend space."""
+        return cast(
+            DynamicFrontend,
+            cls._static_request(
+                "delete",
+                f"/dynamic-frontend/{space_id}",
+                user_id,
+                company_id,
+            ),
+        )
+
     @classmethod
     def list(
         cls,

{unique_sdk-2026.26.0.dev14 → unique_sdk-2026.26.0.dev16}/unique_sdk/cli/cli.py

@@ -9,6 +9,7 @@ import click
 from unique_sdk.cli import __version__
 from unique_sdk.cli.commands.cite_file import cmd_cite_file
 from unique_sdk.cli.commands.dynamic_frontend import (
+    cmd_dynamic_frontend_delete,
     cmd_dynamic_frontend_deploy,
     cmd_dynamic_frontend_list,
 )
@@ -480,7 +481,7 @@ def read_cmd(
 
 @main.group(name="dynamic-frontend")
 def dynamic_frontend() -> None:
-    """Deploy and list Dynamic Frontend spaces."""
+    """Deploy, list, and delete Dynamic Frontend spaces."""
 
 
 @dynamic_frontend.command(name="deploy")
@@ -550,6 +551,29 @@ def dynamic_frontend_list(ctx: click.Context, output_json: bool) -> None:
         ctx.exit(1)
 
 
+@dynamic_frontend.command(name="delete")
+@click.argument("space_id")
+@click.option(
+    "--json", "output_json", is_flag=True, default=False, help="Print raw JSON."
+)
+@click.pass_context
+def dynamic_frontend_delete(
+    ctx: click.Context, space_id: str, output_json: bool
+) -> None:
+    """Delete a deployed Dynamic Frontend space by its space id.
+
+    \b
+    Example:
+      unique-cli dynamic-frontend delete assistant_123
+    """
+    output = cmd_dynamic_frontend_delete(
+        LazyState.get(ctx), space_id, output_json=output_json
+    )
+    click.echo(output)
+    if output.startswith(_DYNAMIC_FRONTEND_ERROR_PREFIX):
+        ctx.exit(1)
+
+
 @main.command()
 @click.argument("name_or_id")
 @click.pass_context

{unique_sdk-2026.26.0.dev14 → unique_sdk-2026.26.0.dev16}/unique_sdk/cli/commands/dynamic_frontend.py

@@ -37,11 +37,14 @@ def _format_space(space: object) -> str:
     status = getattr(space, "status", None)
     phase = ""
     url = str(getattr(space, "url", "") or "")
+    config_url = str(getattr(space, "configUrl", "") or "")
     if isinstance(status, dict):
         phase = str(status.get("phase") 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
     )
 
 
@@ -94,18 +97,49 @@ 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}"
 
 
+def cmd_dynamic_frontend_delete(
+    state: ShellState,
+    space_id: str,
+    *,
+    output_json: bool = False,
+) -> str:
+    try:
+        if not space_id:
+            return "dynamic-frontend delete: provide a space id."
+        result = unique_sdk.DynamicFrontend.delete(
+            space_id,
+            user_id=state.config.user_id,
+            company_id=state.config.company_id,
+        )
+        if output_json:
+            return json.dumps(dict(result), indent=2, default=str)
+        deleted_id = (
+            getattr(result, "spaceId", None) or getattr(result, "id", None) or space_id
+        )
+        return f"Deleted Dynamic Frontend space {deleted_id}"
+    except (ValueError, unique_sdk.APIError) as e:
+        return f"dynamic-frontend delete: {e}"
+
+
 def cmd_dynamic_frontend_list(state: ShellState, *, output_json: bool = False) -> str:
     try:
         spaces = unique_sdk.DynamicFrontend.list(

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

@@ -0,0 +1,151 @@
+---
+name: unique-cli-dynamic-frontend
+description: >-
+  Create, update, list, and delete 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, deleting a deployed Dynamic
+  Frontend Space, or when the user mentions Dynamic Frontend Space deployment
+  through the CLI.
+---
+
+# Unique CLI -- Dynamic Frontend Spaces
+
+Use `unique-cli dynamic-frontend` to create, update, list, and delete 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.
+
+## Delete a Space
+
+Remove a deployed Dynamic Frontend Space by its space id. This deletes the
+backing BYOC app and the owning space (and its access grants):
+
+```bash
+unique-cli dynamic-frontend delete space_abc123
+```
+
+The command prints a confirmation:
+
+```text
+Deleted Dynamic Frontend space space_abc123
+```
+
+Deletion is permanent and requires manage access on the space (or a
+company-wide space-admin role). Always confirm the correct `spaceId` with the
+user before deleting — there is no undo.
+
+## 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
+unique-cli dynamic-frontend delete space_abc123 --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.
+- `delete` is permanent and has no undo — confirm the `spaceId` with the user
+  first, and never guess which space to delete.
+- 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.

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

@@ -1,105 +0,0 @@
----
-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 direct `URL` when the
-API returns it:
-
-```text
-Created Dynamic Frontend space "Revenue Dashboard" (space_abc123)
-Content: cont_abc123
-URL: https://chat.example.com/space/space_abc123
-```
-
-## 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`, and direct `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 the
-  direct `URL`.