unique-sdk 2026.40.0.dev4__tar.gz → 2026.40.0.dev5__tar.gz

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/PKG-INFO

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

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

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/api_resources/_scheduled_task.py

@@ -32,6 +32,7 @@ class ScheduledTask(APIResource["ScheduledTask"]):
         cronExpression: str
         assistantId: str
         prompt: str
+        name: NotRequired[str]
         chatId: NotRequired[str | None]
         enabled: NotRequired[bool]
 
@@ -39,6 +40,7 @@ class ScheduledTask(APIResource["ScheduledTask"]):
         cronExpression: NotRequired[str]
         assistantId: NotRequired[str]
         prompt: NotRequired[str]
+        name: NotRequired[str | None]
         chatId: NotRequired[str | None]
         enabled: NotRequired[bool]
 
@@ -51,6 +53,7 @@ class ScheduledTask(APIResource["ScheduledTask"]):
 
     id: str
     object: str
+    name: str | None
     cronExpression: str
     assistantId: str
     assistantName: str | None

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/cli/cli.py

@@ -1022,6 +1022,12 @@ def schedule_get(ctx: click.Context, task_id: str) -> None:
     required=True,
     help="Prompt text sent to the assistant on each trigger.",
 )
+@click.option(
+    "--name",
+    "-n",
+    default=None,
+    help="Short label for the task, shown in the UI. Falls back to the prompt if omitted.",
+)
 @click.option(
     "--chat-id",
     default=None,
@@ -1039,6 +1045,7 @@ def schedule_create(
     cron: str,
     assistant_id: str,
     prompt: str,
+    name: str | None,
     chat_id: str | None,
     disabled: bool,
 ) -> None:
@@ -1058,7 +1065,8 @@ def schedule_create(
       unique-cli schedule create \\
         --cron "0 9 * * 1-5" \\
         --assistant clx1abc2d0001abcdef123456 \\
-        --prompt "Generate the daily sales report"
+        --prompt "Generate the daily sales report" \\
+        --name "Daily sales report"
 
       unique-cli schedule create \\
         -c "*/15 * * * *" -a clx1abc -p "Check inbox" --disabled
@@ -1068,6 +1076,7 @@ def schedule_create(
         cron=cron,
         assistant_id=assistant_id,
         prompt=prompt,
+        name=name,
         chat_id=chat_id,
         enabled=not disabled,
     )
@@ -1083,6 +1092,7 @@ def schedule_create(
     "--assistant", "-a", "assistant_id", default=None, help="Updated assistant ID."
 )
 @click.option("--prompt", "-p", default=None, help="Updated prompt text.")
+@click.option("--name", "-n", default=None, help="Updated label (use 'none' to clear).")
 @click.option("--chat-id", default=None, help="Updated chat ID (use 'none' to clear).")
 @click.option("--enable", is_flag=True, default=False, help="Enable the task.")
 @click.option("--disable", is_flag=True, default=False, help="Disable the task.")
@@ -1093,6 +1103,7 @@ def schedule_update(
     cron: str | None,
     assistant_id: str | None,
     prompt: str | None,
+    name: str | None,
     chat_id: str | None,
     enable: bool,
     disable: bool,
@@ -1109,6 +1120,7 @@ def schedule_update(
       unique-cli schedule update clx3ghi4f --disable
       unique-cli schedule update clx3ghi4f --enable --prompt "New prompt"
       unique-cli schedule update clx3ghi4f --chat-id none
+      unique-cli schedule update clx3ghi4f --name "Monthly summary"
     """
     if enable and disable:
         click.echo(
@@ -1126,12 +1138,17 @@ def schedule_update(
     if chat_id and chat_id.lower() == "none":
         resolved_chat_id = ""
 
+    resolved_name = name
+    if name and name.lower() == "none":
+        resolved_name = ""
+
     output = cmd_schedule_update(
         LazyState.get(ctx),
         task_id,
         cron=cron,
         assistant_id=assistant_id,
         prompt=prompt,
+        name=resolved_name,
         chat_id=resolved_chat_id,
         enabled=enabled,
     )

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/cli/commands/scheduled_tasks.py

@@ -47,6 +47,7 @@ def cmd_schedule_create(
     assistant_id: str,
     prompt: str,
     *,
+    name: str | None = None,
     chat_id: str | None = None,
     enabled: bool = True,
 ) -> str:
@@ -58,6 +59,8 @@ def cmd_schedule_create(
             "prompt": prompt,
             "enabled": enabled,
         }
+        if name is not None:
+            params["name"] = name
         if chat_id is not None:
             params["chatId"] = chat_id
 
@@ -79,6 +82,7 @@ def cmd_schedule_update(
     cron: str | None = None,
     assistant_id: str | None = None,
     prompt: str | None = None,
+    name: str | None = None,
     chat_id: str | None = None,
     enabled: bool | None = None,
 ) -> str:
@@ -91,6 +95,9 @@ def cmd_schedule_update(
             params["assistantId"] = assistant_id
         if prompt is not None:
             params["prompt"] = prompt
+        # Empty string is the caller's "clear it" sentinel, sent to the API as null.
+        if name is not None:
+            params["name"] = name if name != "" else None
         if chat_id is not None:
             params["chatId"] = chat_id if chat_id != "" else None
         if enabled is not None:

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/cli/formatting.py

@@ -160,6 +160,7 @@ def format_scheduled_task(task: ScheduledTask) -> str:
     enabled_str = "yes" if getattr(task, "enabled", False) else "no"
     rows = [
         ["ID:", getattr(task, "id", "?")],
+        ["Name:", getattr(task, "name", None) or "(falls back to prompt)"],
         ["Cron:", getattr(task, "cronExpression", "?")],
         [
             "Assistant:",
@@ -191,10 +192,12 @@ def format_scheduled_tasks(tasks: list[ScheduledTask]) -> str:
         snippet = prompt[:60].replace("\n", " ").strip()
         if len(prompt) > 60:
             snippet += "..."
+        # Mirrors the web UI: an unnamed task is identified by its prompt snippet.
+        label = getattr(t, "name", None) or snippet
         last_run = _format_date(getattr(t, "lastRunAt", None))
-        rows.append([enabled, cron, assistant, snippet, task_id, last_run])
+        rows.append([enabled, label, cron, assistant, snippet, task_id, last_run])
 
-    header = ["STATUS", "CRON", "ASSISTANT", "PROMPT", "ID", "LAST RUN"]
+    header = ["STATUS", "NAME", "CRON", "ASSISTANT", "PROMPT", "ID", "LAST RUN"]
     lines = [f"{len(tasks)} scheduled task(s):\n"]
     all_rows = [header] + rows
     lines.extend(_pad_columns(all_rows))

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/cli/shell.py

@@ -1109,6 +1109,7 @@ class UniqueShell(cmd.Cmd):
           --cron / -c <expr>      Cron expression (required)
           --assistant / -a <id>   Assistant ID (required)
           --prompt / -p <text>    Prompt text (required)
+          --name / -n <text>      Short label shown in the UI (optional)
           --chat-id <id>          Chat to continue (optional)
           --disabled              Create in disabled state
 
@@ -1116,6 +1117,7 @@ class UniqueShell(cmd.Cmd):
           --cron / -c <expr>      Updated cron expression
           --assistant / -a <id>   Updated assistant ID
           --prompt / -p <text>    Updated prompt
+          --name / -n <text>      Updated label ('none' to clear)
           --chat-id <id>          Updated chat ID ('none' to clear)
           --enable                Enable the task
           --disable               Disable the task
@@ -1123,7 +1125,7 @@ class UniqueShell(cmd.Cmd):
         Examples:
           /> schedule list
           /> schedule get clx3ghi4f0003mnopqr345678
-          /> schedule create -c "0 9 * * 1-5" -a clx1abc -p "Daily report"
+          /> schedule create -c "0 9 * * 1-5" -a clx1abc -p "Daily report" -n "Daily report"
           /> schedule update clx3ghi4f --disable
           /> schedule delete clx3ghi4f0003mnopqr345678
         """
@@ -1173,6 +1175,7 @@ class UniqueShell(cmd.Cmd):
         cron: str | None = None
         assistant_id: str | None = None
         prompt: str | None = None
+        name: str | None = None
         chat_id: str | None = None
         disabled = False
 
@@ -1187,6 +1190,9 @@ class UniqueShell(cmd.Cmd):
             elif parts[i] in ("--prompt", "-p") and i + 1 < len(parts):
                 prompt = parts[i + 1]
                 i += 2
+            elif parts[i] in ("--name", "-n") and i + 1 < len(parts):
+                name = parts[i + 1]
+                i += 2
             elif parts[i] == "--chat-id" and i + 1 < len(parts):
                 chat_id = parts[i + 1]
                 i += 2
@@ -1200,7 +1206,7 @@ class UniqueShell(cmd.Cmd):
         if not cron or not assistant_id or not prompt:
             self._print(
                 "Usage: schedule create --cron <expr> --assistant <id> --prompt <text> "
-                "[--chat-id <id>] [--disabled]"
+                "[--name <text>] [--chat-id <id>] [--disabled]"
             )
             return
 
@@ -1210,6 +1216,7 @@ class UniqueShell(cmd.Cmd):
                 cron=cron,
                 assistant_id=assistant_id,
                 prompt=prompt,
+                name=name,
                 chat_id=chat_id,
                 enabled=not disabled,
             )
@@ -1220,6 +1227,7 @@ class UniqueShell(cmd.Cmd):
         cron: str | None = None
         assistant_id: str | None = None
         prompt: str | None = None
+        name: str | None = None
         chat_id: str | None = None
         enable = False
         disable = False
@@ -1235,6 +1243,9 @@ class UniqueShell(cmd.Cmd):
             elif parts[i] in ("--prompt", "-p") and i + 1 < len(parts):
                 prompt = parts[i + 1]
                 i += 2
+            elif parts[i] in ("--name", "-n") and i + 1 < len(parts):
+                name = "" if parts[i + 1].lower() == "none" else parts[i + 1]
+                i += 2
             elif parts[i] == "--chat-id" and i + 1 < len(parts):
                 chat_id = "" if parts[i + 1].lower() == "none" else parts[i + 1]
                 i += 2
@@ -1265,6 +1276,7 @@ class UniqueShell(cmd.Cmd):
                 cron=cron,
                 assistant_id=assistant_id,
                 prompt=prompt,
+                name=name,
                 chat_id=chat_id,
                 enabled=enabled,
             )

{unique_sdk-2026.40.0.dev4 → unique_sdk-2026.40.0.dev5}/unique_sdk/cli/skills/unique-cli-scheduled-tasks/SKILL.md

@@ -28,6 +28,8 @@ Manage cron-tab style scheduled tasks that trigger an assistant on a recurring s
 | `0 9 * * 1-5` | "every weekday (Mon-Fri) at 9:00 AM" |
 | `0 0 * * *` | "every day at midnight" |
 | `0 8 1 * *` | "on the 1st of every month at 8:00 AM" |
+| `0 8 L * *` | "on the last day of every month at 8:00 AM" |
+| `0 8 30 * *` | "on the 30th of every month at 8:00 AM — on the last day in February" |
 | `30 17 * * 5` | "every Friday at 5:30 PM" |
 | `0 */2 * * *` | "every 2 hours" |
 | `0 9 * * 1` | "every Monday at 9:00 AM" |
@@ -40,6 +42,34 @@ Manage cron-tab style scheduled tasks that trigger an assistant on a recurring s
 - If the user says "every morning at 9" → use `0 9 * * *` but tell them "Scheduled to run **every day at 9:00 AM**."
 - Include the day-of-week names (Mon, Tue, etc.) rather than numbers.
 - Use 12-hour format with AM/PM for times when talking to the user.
+- Always tell the user the **name** you gave the task when you create or rename it, e.g.
+  "Done — I created **Daily sales report**, running every weekday at 9:00 AM."
+
+## Monthly schedules and the last day of the month (critical)
+
+**Write monthly schedules only as `minute hour day * *`**, where `day` is `1`–`30` or the `L`
+token. In that form — and *only* in that form — a day the month does not have moves to the
+month's last day instead of being skipped. A day list (`0 8 29,30,31 * *`), a range, a step or
+a month restriction (`0 8 31 1,7 *`) falls outside that handling and **will** skip short
+months, after you have told the user it would not.
+
+**Rules:**
+- **Never tell the user a month will be skipped.** In the supported form it is not — the run
+  moves to that month's last day.
+- For **"the last day of every month"**, and for **"the 31st"**, use the `L` token:
+  `0 8 L * *`. `L` means the last day of whichever month it is, so it runs in all 12 months:
+  31 January, 28 (or 29) February, 31 March, 30 April, and so on. Prefer `L` over `31` — it
+  says what it means and is unambiguous in every month.
+- When the user asks for **the 29th or 30th**, keep that day (`0 8 30 * *`) and spell out
+  February: "…on the **30th of every month** — in February it runs on the **last day** of the
+  month."
+- Never put `L` anywhere but the day-of-month field, and never combine it with a list, range
+  or step.
+- The platform supports **daily, weekday, weekly and monthly** schedules. If the user asks for
+  something outside that — a yearly date such as a birthday, "every two weeks", or a one-off
+  reminder — say so plainly and offer the closest supported schedule. Do **not** invent a cron
+  expression that pins the month (`0 7 18 11 *`) to fake it: it will run, but the schedule
+  editor cannot display or edit it afterwards.
 
 ## Timezone handling (critical)
 
@@ -90,6 +120,10 @@ Before running `schedule create`, **resolve / ask the user**:
    - **Continue an existing chat** — the user must provide a chat ID (starts with `chat_`). Pass it via `--chat-id`.
 4. **When should it run?** — Ask in plain language (e.g. "every weekday at 9 AM"). Convert to a UTC cron expression.
 5. **Prompt text** — what the assistant should do on each trigger.
+6. **Name** — **you write it, do not ask for it.** Derive a short, descriptive label from the
+   prompt (a few words, title-style, e.g. "Daily sales report", "Weekly pipeline review").
+   Pass it as `--name`. Keep it **at most 128 characters** — a longer name is rejected and the
+   whole `schedule create` fails. Tell the user what you called it when you confirm.
 
 Only pass `--chat-id` when the user explicitly wants to continue a specific chat. Otherwise leave it out.
 
@@ -111,7 +145,7 @@ Only pass `--chat-id` when the user explicitly wants to continue a specific chat
 unique-cli schedule list
 ```
 
-Output shows a table with status, cron expression, assistant, prompt snippet, task ID, and last run time.
+Output shows a table with status, name, cron expression, assistant, prompt snippet, task ID, and last run time. A task saved without a name shows its prompt snippet in the name column.
 
 ## Get Task Details
 
@@ -133,7 +167,8 @@ ask the user to provide one.
 unique-cli schedule create \
   --cron "0 9 * * 1-5" \
   --assistant "$UNIQUE_ASSISTANT_ID" \
-  --prompt "Generate the daily sales report and email it to the team"
+  --prompt "Generate the daily sales report and email it to the team" \
+  --name "Daily sales report"
 ```
 
 ### Continue an existing chat
@@ -143,7 +178,8 @@ unique-cli schedule create \
   --cron "0 9 * * 1-5" \
   --assistant "$UNIQUE_ASSISTANT_ID" \
   --chat-id chat_b7ze6mpv0edy324yhjj1d92t \
-  --prompt "Append today's numbers to the running report"
+  --prompt "Append today's numbers to the running report" \
+  --name "Running report top-up"
 ```
 
 ### Create options
@@ -153,6 +189,7 @@ unique-cli schedule create \
 | `--cron` | `-c` | Yes | 5-field cron expression |
 | `--assistant` | `-a` | Yes | Assistant ID to execute (starts with `assistant_`). **Always pass `"$UNIQUE_ASSISTANT_ID"`** — never ask the user. |
 | `--prompt` | `-p` | Yes | Prompt text sent each run |
+| `--name` | `-n` | No | Short label shown in the UI (≤128 chars). **Always pass one** — you generate it; without it the UI falls back to the prompt text |
 | `--chat-id` | | No | Continue an existing chat (starts with `chat_`; **omit for new chat each run**) |
 | `--disabled` | | No | Create in disabled state |
 
@@ -166,6 +203,9 @@ The user will describe schedules in plain language. Translate silently:
 | "every weekday at 9 AM" / "every morning Mon–Fri" | `0 9 * * 1-5` |
 | "every day at midnight" | `0 0 * * *` |
 | "first of every month at 8 AM" | `0 8 1 * *` |
+| "the 31st of every month at 8 AM" | `0 8 L * *` (the 31st means the last day) |
+| "the 30th of every month at 8 AM" | `0 8 30 * *` (February runs on its last day) |
+| "last day of every month at 8 AM" | `0 8 L * *` |
 | "every Friday at 5:30 PM" | `30 17 * * 5` |
 | "every 2 hours" | `0 */2 * * *` |
 | "twice a day at 9 AM and 5 PM, weekdays" | `0 9,17 * * 1-5` |
@@ -178,7 +218,7 @@ The user will describe schedules in plain language. Translate silently:
 ```
 ┌───────────── minute (0–59)
 │ ┌───────────── hour (0–23)
-│ │ ┌───────────── day of month (1–31)
+│ │ ┌───────────── day of month (1–31, or L for the last day)
 │ │ │ ┌───────────── month (1–12)
 │ │ │ │ ┌───────────── day of week (0–7, 0 and 7 = Sunday)
 │ │ │ │ │
@@ -212,6 +252,7 @@ unique-cli schedule update <task_id> --chat-id none
 | `--cron` | `-c` | Updated cron expression |
 | `--assistant` | `-a` | Updated assistant ID (starts with `assistant_`) |
 | `--prompt` | `-p` | Updated prompt text |
+| `--name` | `-n` | Updated label (`none` to clear it and fall back to the prompt) |
 | `--chat-id` | | Updated chat ID (starts with `chat_`; `none` to clear) |
 | `--enable` | | Enable the task |
 | `--disable` | | Disable the task |
@@ -241,10 +282,11 @@ Run:
 unique-cli schedule create \
   -c "0 7 * * 1-5" \
   -a "$UNIQUE_ASSISTANT_ID" \
-  -p "Generate the daily sales report and email it to the team"
+  -p "Generate the daily sales report and email it to the team" \
+  -n "Daily sales report"
 ```
 
-Respond: "Done — I scheduled **this assistant** to run your daily sales report **every weekday (Mon–Fri) at 9:00 AM your time (Europe/Zurich)**. That's 7:00 AM UTC. A new chat will be created for each run. Note: when clocks change for daylight saving, the task will shift by one hour in your local time."
+Respond: "Done — I created **Daily sales report**, running **every weekday (Mon–Fri) at 9:00 AM your time (Europe/Zurich)**. That's 7:00 AM UTC. A new chat will be created for each run. Note: when clocks change for daylight saving, the task will shift by one hour in your local time."
 
 ### Set up a recurring task that continues the same chat
 
@@ -258,10 +300,11 @@ unique-cli schedule create \
   -c "0 7 * * 1-5" \
   -a "$UNIQUE_ASSISTANT_ID" \
   --chat-id chat_b7ze6mpv0edy324yhjj1d92t \
-  -p "Append today's numbers to the running report"
+  -p "Append today's numbers to the running report" \
+  -n "Running report top-up"
 ```
 
-Respond: "Done — scheduled **this assistant** to run **every weekday (Mon–Fri) at 9:00 AM your time** (7:00 AM UTC), continuing chat `chat_b7ze6mpv0edy324yhjj1d92t`."
+Respond: "Done — I created **Running report top-up**, running **every weekday (Mon–Fri) at 9:00 AM your time** (7:00 AM UTC), continuing chat `chat_b7ze6mpv0edy324yhjj1d92t`."
 
 ### Pause and resume a task
 
@@ -316,6 +359,7 @@ task = unique_sdk.ScheduledTask.create(
     cronExpression="0 9 * * 1-5",
     assistantId="assistant_cvj3fd7x8hpt1hfp0akqu1rq",
     prompt="Generate daily report",
+    name="Daily report",
 )
 
 # Create (continue existing chat)