dailybot-cli 3.7.4__tar.gz → 3.9.0__tar.gz

{dailybot_cli-3.7.4 → dailybot_cli-3.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.7.4
+Version: 3.9.0
 Summary: Dailybot CLI - The command-line bridge between humans and agents. Progress reports, observability, and workflow automation for modern teams across Slack, Google Chat, Discord, MS Teams, and more.
 Author-email: Dailybot <support@dailybot.com>
 License: MIT
@@ -534,21 +534,33 @@ The `user list` table shows **Name** and **User UUID**. You can copy a UUID dire
 
 ## Workflows
 
-Browse the workflows configured in your organization. This surface is
-**read-only** — workflows are created and edited in the Dailybot web app. The
-feature is plan-gated; an org on a plan without workflows gets a clear upgrade
-message.
+Browse the workflows configured in your organization, and **trigger** ones whose
+trigger type is `api_trigger` ("When triggered via API or button" in the
+automations builder). Creating and editing workflow definitions remains in the
+Dailybot web app. The feature is plan-gated; an org on a plan without workflows
+gets a clear upgrade message.
 
 ```bash
 # List workflows visible to you (paginated + searchable)
 dailybot workflow list
 dailybot workflow list --search "release" --all --json
+# Find triggerable workflows
+dailybot workflow list --filter api_trigger --all
 
 # Get a single workflow by UUID
 dailybot workflow get <workflow_uuid>
 dailybot workflow get <workflow_uuid> --json
+
+# Queue an api_trigger run (async — returns 202; no run output)
+dailybot workflow trigger <workflow-uuid>
+dailybot workflow trigger <workflow-uuid> \
+  --payload '{"env":"production","requested_by":"release-bot"}'
 ```
 
+The optional `--payload` must be a JSON object ≤ 8 KiB; workflow steps read it
+as `{{trigger.body.*}}`. The same `api_trigger` workflows can also be fired from
+a chat button via `callback_workflow` (see Chat below).
+
 `dailybot workflow list` accepts the shared list flags — see
 [Listing, search, and pagination](#listing-search-and-pagination).
 
@@ -908,8 +920,9 @@ Replies to agent emails land as messages retrievable via `dailybot agent message
 
 | Command | Description |
 |---------|-------------|
-| `dailybot workflow list` | List workflows visible to you (read-only; search + pagination) |
+| `dailybot workflow list` | List workflows visible to you (search + pagination; `--filter api_trigger`) |
 | `dailybot workflow get <uuid>` | Show a single workflow by UUID |
+| `dailybot workflow trigger <uuid>` | Queue an `api_trigger` workflow run (async 202; optional `--payload`) |
 
 ### Chat (send bot messages to Slack/Teams/Discord/Google Chat)
 
@@ -946,6 +959,22 @@ dailybot chat send -c C0123 -m "Build #421 ✅" \
   --bot-name "Release Bot" --bot-icon-emoji ":rocket:" \
   --link-button "Open report::https://app.company.com/report"
 
+# Approval flow — callback_url buttons (+ optional bearer auth on the POST)
+dailybot chat send -u <user-uuid> -m "Deploy to prod?" \
+  --approve-button "Yes=approve" --reject-button "No=deny" \
+  --callback-url https://hooks.example.com/req42 --callback-bearer "$TOKEN"
+
+# Fire an api_trigger workflow from a button click
+dailybot chat send -c C0123 -m "Ready to release?" \
+  --workflow-button "Run release=<workflow-uuid>"
+
+# Full button contract (modals, response trees, callback_prompt, …) via JSON
+dailybot chat send -u <user-uuid> -m "Need details" --buttons '[
+  {"label":"Open","button_type":"interactive","value":"open",
+   "callback_url":"https://hooks.example.com/x",
+   "modal_body":{"title":"Notes","blocks":[
+     {"type":"input","name":"notes","label":"Notes","multiline":true}]}}]'
+
 # Send with another user's identity, or as yourself (Slack only, admin-only)
 dailybot chat send -c C0123 -m "Posting for the team" --send-as-user <user-uuid>
 dailybot chat send -c C0123 -m "This one is from me" --send-as-me

{dailybot_cli-3.7.4 → dailybot_cli-3.9.0}/README.md

@@ -495,21 +495,33 @@ The `user list` table shows **Name** and **User UUID**. You can copy a UUID dire
 
 ## Workflows
 
-Browse the workflows configured in your organization. This surface is
-**read-only** — workflows are created and edited in the Dailybot web app. The
-feature is plan-gated; an org on a plan without workflows gets a clear upgrade
-message.
+Browse the workflows configured in your organization, and **trigger** ones whose
+trigger type is `api_trigger` ("When triggered via API or button" in the
+automations builder). Creating and editing workflow definitions remains in the
+Dailybot web app. The feature is plan-gated; an org on a plan without workflows
+gets a clear upgrade message.
 
 ```bash
 # List workflows visible to you (paginated + searchable)
 dailybot workflow list
 dailybot workflow list --search "release" --all --json
+# Find triggerable workflows
+dailybot workflow list --filter api_trigger --all
 
 # Get a single workflow by UUID
 dailybot workflow get <workflow_uuid>
 dailybot workflow get <workflow_uuid> --json
+
+# Queue an api_trigger run (async — returns 202; no run output)
+dailybot workflow trigger <workflow-uuid>
+dailybot workflow trigger <workflow-uuid> \
+  --payload '{"env":"production","requested_by":"release-bot"}'
 ```
 
+The optional `--payload` must be a JSON object ≤ 8 KiB; workflow steps read it
+as `{{trigger.body.*}}`. The same `api_trigger` workflows can also be fired from
+a chat button via `callback_workflow` (see Chat below).
+
 `dailybot workflow list` accepts the shared list flags — see
 [Listing, search, and pagination](#listing-search-and-pagination).
 
@@ -869,8 +881,9 @@ Replies to agent emails land as messages retrievable via `dailybot agent message
 
 | Command | Description |
 |---------|-------------|
-| `dailybot workflow list` | List workflows visible to you (read-only; search + pagination) |
+| `dailybot workflow list` | List workflows visible to you (search + pagination; `--filter api_trigger`) |
 | `dailybot workflow get <uuid>` | Show a single workflow by UUID |
+| `dailybot workflow trigger <uuid>` | Queue an `api_trigger` workflow run (async 202; optional `--payload`) |
 
 ### Chat (send bot messages to Slack/Teams/Discord/Google Chat)
 
@@ -907,6 +920,22 @@ dailybot chat send -c C0123 -m "Build #421 ✅" \
   --bot-name "Release Bot" --bot-icon-emoji ":rocket:" \
   --link-button "Open report::https://app.company.com/report"
 
+# Approval flow — callback_url buttons (+ optional bearer auth on the POST)
+dailybot chat send -u <user-uuid> -m "Deploy to prod?" \
+  --approve-button "Yes=approve" --reject-button "No=deny" \
+  --callback-url https://hooks.example.com/req42 --callback-bearer "$TOKEN"
+
+# Fire an api_trigger workflow from a button click
+dailybot chat send -c C0123 -m "Ready to release?" \
+  --workflow-button "Run release=<workflow-uuid>"
+
+# Full button contract (modals, response trees, callback_prompt, …) via JSON
+dailybot chat send -u <user-uuid> -m "Need details" --buttons '[
+  {"label":"Open","button_type":"interactive","value":"open",
+   "callback_url":"https://hooks.example.com/x",
+   "modal_body":{"title":"Notes","blocks":[
+     {"type":"input","name":"notes","label":"Notes","multiline":true}]}}]'
+
 # Send with another user's identity, or as yourself (Slack only, admin-only)
 dailybot chat send -c C0123 -m "Posting for the team" --send-as-user <user-uuid>
 dailybot chat send -c C0123 -m "This one is from me" --send-as-me

{dailybot_cli-3.7.4 → dailybot_cli-3.9.0}/dailybot_cli/api_client.py

@@ -106,6 +106,37 @@ def _merge_list_query(
     return params
 
 
+def _merge_dashboard_enrichment_query(
+    params: dict[str, Any],
+    *,
+    labels: list[str] | None = None,
+    featured: bool | None = None,
+    prioritize_featured: bool | None = None,
+) -> dict[str, Any]:
+    """Merge Labels / Featured dashboard enrichment query params."""
+    if labels:
+        params["labels"] = ",".join(labels)
+    if featured is not None:
+        params["featured"] = "true" if featured else "false"
+    if prioritize_featured is not None:
+        params["prioritize_featured"] = "true" if prioritize_featured else "false"
+    return params
+
+
+def _label_entity_collection(entity_type: str) -> str:
+    """Map CLI entity type (including web 'automations') to the public API path."""
+    normalized: str = entity_type.strip().lower()
+    if normalized in {"automations", "workflows", "workflow"}:
+        return "workflows"
+    if normalized in {"forms", "form"}:
+        return "forms"
+    if normalized in {"checkins", "checkin", "check-ins"}:
+        return "checkins"
+    raise ValueError(
+        f"entity type must be one of: forms, checkins, workflows (got {entity_type!r})"
+    )
+
+
 def _fill_meta(meta: dict[str, Any] | None, result: "PaginatedResult") -> None:
     """Populate a caller-provided meta dict with pagination totals, if given."""
     if meta is not None:
@@ -640,6 +671,9 @@ class DailyBotClient:
         fetch_all: bool = True,
         limit: int | None = None,
         meta: dict[str, Any] | None = None,
+        labels: list[str] | None = None,
+        featured: bool | None = None,
+        prioritize_featured: bool | None = None,
     ) -> list[dict[str, Any]]:
         """GET /v1/checkins/ — fetch visible check-ins with optional search/paging."""
         params: dict[str, Any] = {}
@@ -652,6 +686,12 @@ class DailyBotClient:
         if include_archived:
             params["include_archived"] = "true"
         _merge_list_query(params, search=search, start_date=start_date, end_date=end_date)
+        _merge_dashboard_enrichment_query(
+            params,
+            labels=labels,
+            featured=featured,
+            prioritize_featured=prioritize_featured,
+        )
         result: PaginatedResult = self._paginated_get(
             f"{self.api_url}/v1/checkins/",
             params=params,
@@ -963,6 +1003,9 @@ class DailyBotClient:
         fetch_all: bool = True,
         limit: int | None = None,
         meta: dict[str, Any] | None = None,
+        labels: list[str] | None = None,
+        featured: bool | None = None,
+        prioritize_featured: bool | None = None,
     ) -> list[dict[str, Any]]:
         """GET /v1/forms/ — optionally expand questions, search, and page.
 
@@ -990,6 +1033,12 @@ class DailyBotClient:
         if is_ascend:
             params["is_ascend"] = "true"
         _merge_list_query(params, search=search, start_date=start_date, end_date=end_date)
+        _merge_dashboard_enrichment_query(
+            params,
+            labels=labels,
+            featured=featured,
+            prioritize_featured=prioritize_featured,
+        )
         result: PaginatedResult = self._paginated_get(
             f"{self.api_url}/v1/forms/",
             params=params,
@@ -1442,10 +1491,19 @@ class DailyBotClient:
         fetch_all: bool = True,
         limit: int | None = None,
         meta: dict[str, Any] | None = None,
+        labels: list[str] | None = None,
+        featured: bool | None = None,
+        prioritize_featured: bool | None = None,
     ) -> list[dict[str, Any]]:
-        """GET /v1/workflows/ — list workflows (read-only; plan-gated feature)."""
+        """GET /v1/workflows/ — list workflows (plan-gated feature)."""
         params: dict[str, Any] = {}
         _merge_list_query(params, search=search, start_date=start_date, end_date=end_date)
+        _merge_dashboard_enrichment_query(
+            params,
+            labels=labels,
+            featured=featured,
+            prioritize_featured=prioritize_featured,
+        )
         result: PaginatedResult = self._paginated_get(
             f"{self.api_url}/v1/workflows/",
             params=params,
@@ -1464,6 +1522,30 @@ class DailyBotClient:
         )
         return self._handle_response(response)
 
+    def trigger_workflow(
+        self,
+        workflow_uuid: str,
+        *,
+        payload: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """POST /v1/workflows/<uuid>/trigger/ — queue an ``api_trigger`` workflow.
+
+        Only workflows whose trigger type is ``api_trigger`` ("When triggered via
+        API or button") can be fired this way. The run is asynchronous — success
+        is ``202 {queued: true, workflow_uuid, detail}`` with no run output.
+        Optional *payload* (a JSON object ≤ 8 KiB) is exposed to workflow steps
+        as ``{{trigger.body.*}}`` variables.
+        """
+        body: dict[str, Any] = {}
+        if payload is not None:
+            body["payload"] = payload
+        response: httpx.Response = self._request(
+            "POST",
+            f"{self.api_url}/v1/workflows/{workflow_uuid}/trigger/",
+            json=body,
+        )
+        return self._handle_response(response)
+
     def list_kudos_organization(
         self,
         *,
@@ -1765,6 +1847,157 @@ class DailyBotClient:
         )
         return self._handle_response(response)
 
+    # --- Organization Labels (/v1/labels/) ---
+
+    def get_labels_entitlement(self) -> dict[str, Any]:
+        """GET /v1/labels/entitlement/ — org Labels feature flags for the caller."""
+        response: httpx.Response = self._request("GET", f"{self.api_url}/v1/labels/entitlement/")
+        return self._handle_response(response)
+
+    def list_labels(
+        self,
+        *,
+        search: str | None = None,
+        is_archived: bool = False,
+        limit: int = 20,
+        offset: int = 0,
+    ) -> dict[str, Any]:
+        """GET /v1/labels/ — paginated org Labels (limit/offset)."""
+        params: dict[str, Any] = {
+            "limit": max(1, min(limit, 100)),
+            "offset": max(0, offset),
+            "is_archived": is_archived,
+        }
+        if search:
+            params["search"] = search
+        response: httpx.Response = self._request("GET", f"{self.api_url}/v1/labels/", params=params)
+        return self._handle_response(response)
+
+    def get_label(self, label_uuid: str) -> dict[str, Any]:
+        """GET /v1/labels/<uuid>/ — one organization Label."""
+        response: httpx.Response = self._request("GET", f"{self.api_url}/v1/labels/{label_uuid}/")
+        return self._handle_response(response)
+
+    def create_label(
+        self,
+        *,
+        name: str,
+        color: str | None = None,
+        description: str | None = None,
+    ) -> dict[str, Any]:
+        """POST /v1/labels/ — create an organization Label."""
+        body: dict[str, Any] = {"name": name}
+        if color is not None:
+            body["color"] = color
+        if description is not None:
+            body["description"] = description
+        response: httpx.Response = self._request("POST", f"{self.api_url}/v1/labels/", json=body)
+        return self._handle_response(response)
+
+    def update_label(self, label_uuid: str, body: dict[str, Any]) -> dict[str, Any]:
+        """PATCH /v1/labels/<uuid>/ — update an organization Label."""
+        response: httpx.Response = self._request(
+            "PATCH", f"{self.api_url}/v1/labels/{label_uuid}/", json=body
+        )
+        return self._handle_response(response)
+
+    def delete_label(self, label_uuid: str) -> None:
+        """DELETE /v1/labels/<uuid>/ — hard-delete (elevated only)."""
+        response: httpx.Response = self._request(
+            "DELETE", f"{self.api_url}/v1/labels/{label_uuid}/"
+        )
+        if response.status_code == 204:
+            return
+        self._handle_response(response)
+
+    def archive_label(self, label_uuid: str) -> dict[str, Any]:
+        """POST /v1/labels/<uuid>/archive/ — archive a Label."""
+        response: httpx.Response = self._request(
+            "POST", f"{self.api_url}/v1/labels/{label_uuid}/archive/"
+        )
+        return self._handle_response(response)
+
+    def assign_entity_labels(
+        self,
+        entity_type: str,
+        entity_uuid: str,
+        label_uuids: list[str],
+    ) -> dict[str, Any]:
+        """POST /v1/{forms|checkins|workflows}/{uuid}/labels/ — replace-set Labels."""
+        collection: str = _label_entity_collection(entity_type)
+        response: httpx.Response = self._request(
+            "POST",
+            f"{self.api_url}/v1/{collection}/{entity_uuid}/labels/",
+            json={"label_uuids": label_uuids},
+        )
+        return self._handle_response(response)
+
+    def batch_entity_labels(
+        self,
+        *,
+        entity_type: str,
+        entity_uuids: list[str],
+        label_uuids: list[str],
+        mode: str,
+    ) -> dict[str, Any]:
+        """POST /v1/{forms|checkins|workflows}/labels/batch/ — add/remove/replace."""
+        collection: str = _label_entity_collection(entity_type)
+        response: httpx.Response = self._request(
+            "POST",
+            f"{self.api_url}/v1/{collection}/labels/batch/",
+            json={
+                "entity_uuids": entity_uuids,
+                "label_uuids": label_uuids,
+                "mode": mode,
+            },
+        )
+        return self._handle_response(response)
+
+    # --- Private Featured stars (/v1/me/featured/) ---
+
+    def list_featured(self, *, entity_type: str) -> dict[str, Any]:
+        """GET /v1/me/featured/?entity_type= — list Featured entity UUIDs for the caller."""
+        response: httpx.Response = self._request(
+            "GET",
+            f"{self.api_url}/v1/me/featured/",
+            params={"entity_type": entity_type},
+        )
+        return self._handle_response(response)
+
+    def set_featured(
+        self,
+        entity_type: str,
+        entity_uuid: str,
+        *,
+        featured: bool,
+    ) -> dict[str, Any]:
+        """PUT /v1/me/featured/{entity_type}/{uuid}/ — toggle Featured for one entity."""
+        response: httpx.Response = self._request(
+            "PUT",
+            f"{self.api_url}/v1/me/featured/{entity_type}/{entity_uuid}/",
+            json={"featured": featured},
+        )
+        return self._handle_response(response)
+
+    def batch_featured(
+        self,
+        *,
+        entity_type: str,
+        entity_uuids: list[str],
+        featured: bool,
+    ) -> dict[str, Any]:
+        """POST /v1/me/featured/batch/ — batch feature/unfeature entities."""
+        response: httpx.Response = self._request(
+            "POST",
+            f"{self.api_url}/v1/me/featured/batch/",
+            json={
+                "entity_type": entity_type,
+                "entity_uuids": entity_uuids,
+                "featured": featured,
+            },
+        )
+        return self._handle_response(response)
+
     # --- Agent registration endpoints ---
 
     def get_registration_challenge(self) -> dict[str, Any]: