unique-sdk 2026.32.0.dev4__tar.gz → 2026.32.0.dev6__tar.gz

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-sdk
-Version: 2026.32.0.dev4
+Version: 2026.32.0.dev6
 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.32.0.dev4 → unique_sdk-2026.32.0.dev6}/pyproject.toml

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

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/unique_sdk/api_resources/_space.py

@@ -213,6 +213,7 @@ class Space(APIResource["Space"]):
         stoppedStreamingAt: str | None
         references: list["Space.Reference"] | None
         assessment: list["Space.Assessment"] | None
+        triggeringUserMessageId: NotRequired[str]
 
     class DeleteChatResponse(TypedDict):
         """

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/unique_sdk/cli/cli.py

@@ -1373,7 +1373,8 @@ def elicit_ask(
 @click.option(
     "--mode",
     type=click.Choice(["FORM", "URL"], case_sensitive=False),
-    required=True,
+    default="FORM",
+    show_default=True,
     help="Elicitation display mode.",
 )
 @click.option(

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/unique_sdk/cli/shell.py

@@ -97,7 +97,7 @@ OVERVIEW_HELP = textwrap.dedent("""\
         --placeholder-text <text>      Text on the placeholder thinking step
         --cleanup collapse|delete      How to tear down the placeholder
       elicit create <message> [opts] Fire-and-forget create
-        --mode FORM|URL                Display mode (required)
+        --mode FORM|URL                Display mode (default: FORM)
         --tool-name / -t <name>        Tool label (required)
         --schema <json>                JSON schema (FORM mode)
         --url <url>                    External URL (URL mode)
@@ -811,7 +811,7 @@ class UniqueShell(cmd.Cmd):
           --tool-name / -t <name>      Tool label shown in the UI
           --schema <json>              JSON schema for form fields
           --url <url>                  External URL (create with --mode URL)
-          --mode FORM|URL              Display mode (create only, required)
+          --mode FORM|URL              Display mode (create only, default: FORM)
           --chat-id / -c <id>          Associated chat ID
           --message-id / -m <id>       Associated message ID
           --expires-in <seconds>       Auto-expire the request (create only)
@@ -1033,18 +1033,15 @@ class UniqueShell(cmd.Cmd):
         message = opts["message"]
         if not message:
             self._print(
-                "Usage: elicit create <message> --mode FORM|URL --tool-name <name> [options]"
+                "Usage: elicit create <message> [--mode FORM|URL] --tool-name <name> [options]"
             )
             return
-        if not opts["mode"]:
-            self._print("Error: --mode is required (FORM or URL).")
-            return
         if not opts["tool_name"]:
             self._print("Error: --tool-name / -t is required.")
             return
 
         create_kwargs: dict[str, Any] = {
-            "mode": opts["mode"],
+            "mode": opts["mode"] or "FORM",
             "message": message,
             "tool_name": opts["tool_name"],
             "schema": opts["schema"],

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/unique_sdk/cli/skills/unique-cli-elicitation/SKILL.md

@@ -161,22 +161,19 @@ unique-cli elicit ask "Which report format do you want?" \
 
 Always use this before `rm`, `rmdir -r`, mass uploads, or anything irreversible.
 
+Use an **empty-properties schema** — the UI's Confirm/Cancel buttons ARE the
+consent. Do **not** add a boolean `confirm` field: the button and the checkbox
+are two separate signals, and a user who presses Confirm with the box unchecked
+would show as **Accepted** in the UI while you would read `confirm: false` and
+wrongly treat it as declined.
+
 ```bash
-unique-cli elicit ask "Confirm deleting /Archive/2024 and everything inside it" \
+unique-cli elicit ask "Permanently delete /Archive/2024 and everything inside it? Confirming deletes it immediately — this cannot be undone." \
   --chat-id "$UNIQUE_CHAT_ID" \
-  --schema '{
-    "type": "object",
-    "properties": {
-      "confirm": {
-        "type": "boolean",
-        "description": "Tick to permanently delete"
-      }
-    },
-    "required": ["confirm"]
-  }'
+  --schema '{"type": "object", "properties": {}}'
 ```
 
-Proceed **only** if the response contains `"confirm": true`. Treat `DECLINED`, `CANCELLED`, `EXPIRED`, or `confirm: false` all as "do not proceed" -- tell the user you stopped and return control.
+Proceed **only** if the `Status:` is `ACCEPTED`. Treat `DECLINED`, `CANCELLED`, or `EXPIRED` all as "do not proceed" -- tell the user you stopped and return control. Put everything the user needs to decide into the message text, since the form has no fields.
 
 ### Structured form (multiple fields)
 
@@ -201,7 +198,9 @@ The table below documents `elicit ask`'s flags. `elicit create` takes the
 same `--chat-id`, `--message-id`, `--tool-name`, `--schema`, `--metadata`,
 and `--assistant-id` flags, but uses `--expires-in <seconds>` instead of
 `--timeout`/`--poll-interval` (those two apply only to `elicit wait`, which
-you call separately in the polling pattern).
+you call separately in the polling pattern). `elicit create` also takes
+`--mode FORM|URL` (default: `FORM` — you only need to pass it for URL
+elicitations).
 
 | Option | Short | Default | Description |
 |--------|-------|---------|-------------|
@@ -296,7 +295,7 @@ esac
 
 - Always set `"required"` for fields you actually need -- this guarantees the user cannot submit an empty form.
 - Use `enum` for closed choices so the UI can render a selector.
-- Use `"type": "boolean"` for confirmations; treat `true` as "go ahead", everything else as "stop".
+- For pure yes/no confirmations use an **empty-properties schema** (`{"type": "object", "properties": {}}`) and gate on `Status: ACCEPTED` — never add a boolean `confirm` field (the Confirm button and the checkbox are two separate signals that can disagree). Reserve `"type": "boolean"` for genuine data fields where `false` is a valid answer the user can still submit with Confirm (e.g. `include_appendix`).
 - Add short `description` strings -- they are shown as help text next to each field.
 - Keep schemas small. Ask at most 5 questions in a single elicitation; if you need more, split the flow so the user is not confused by an oversized form.
 

{unique_sdk-2026.32.0.dev4 → unique_sdk-2026.32.0.dev6}/unique_sdk/utils/chat_in_space.py

@@ -39,6 +39,7 @@ async def send_message_and_wait_for_completion(
     correlation: Space.Correlation | None = None,
     auto_approve_elicitation: bool | None = None,
     on_message_update: Callable[[Space.Message], Awaitable[None]] | None = None,
+    wait_for_invocations: bool = False,
 ) -> Space.Message:
     """
     Sends a prompt asynchronously and polls for completion. (until stoppedStreamingAt is not None)
@@ -68,6 +69,8 @@ async def send_message_and_wait_for_completion(
             the assistant run. Use for non-interactive automation where no user is present.
         on_message_update: Optional async callback called whenever the latest assistant
             message changes while waiting for completion.
+        wait_for_invocations: When True, briefly wait for the orchestrator's final
+            ``debugInfo.llm_invocations`` write after the visible response completes.
 
     Returns:
         The completed Space.Message.
@@ -94,7 +97,15 @@ async def send_message_and_wait_for_completion(
     message_id = response.get("id")
 
     max_attempts = int(max_wait // poll_interval)
+    # The final up-to-3 polls spent waiting for `llm_invocations_complete`
+    # happen after the stop condition is already met, so they must not eat
+    # into the same budget as the wait for the stop condition itself --
+    # otherwise a response that completes near the max_wait deadline would
+    # spuriously time out while only debugInfo bookkeeping is still pending.
+    if wait_for_invocations:
+        max_attempts += 3
     last_update_signature: tuple[str | None, str | None] | None = None
+    invocation_wait_attempts = 0
     for _ in range(max_attempts):
         answer = await Space.get_latest_message_async(user_id, company_id, chat_id)
         if (
@@ -121,6 +132,15 @@ async def send_message_and_wait_for_completion(
                 )
                 debug_info = user_message.get("debugInfo")
                 answer["debugInfo"] = debug_info
+                answer["triggeringUserMessageId"] = message_id
+                if (
+                    wait_for_invocations
+                    and not (debug_info or {}).get("llm_invocations_complete", False)
+                    and invocation_wait_attempts < 3
+                ):
+                    invocation_wait_attempts += 1
+                    await asyncio.sleep(poll_interval)
+                    continue
             except Exception as e:
                 print(f"Failed to load debug info from user message: {e}")