dailybot-cli 3.1.2__tar.gz → 3.2.0__tar.gz

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.1.2
+Version: 3.2.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
@@ -877,7 +877,7 @@ Replies to agent emails land as messages retrievable via `dailybot agent message
 
 | Command | Description |
 |---------|-------------|
-| `dailybot form list` | List forms visible to you (includes question count) |
+| `dailybot form list` | List every form in your org you can see (includes question count); `--mine` narrows to forms you own |
 | `dailybot form get <uuid>` | Show the form's full payload (questions + workflow states) |
 | `dailybot form submit <uuid>` | Submit a form (guided prompts or `--content` JSON) |
 | `dailybot form responses <uuid>` | List your own responses on a form (`--state`, `--latest`) |
@@ -923,6 +923,7 @@ Works headless for agents (`--json` prints the `bot_message_id`).
 |---------|-------------|
 | `dailybot chat send` | Send a bot message to users (`-u`), channels (`-c`), and/or teams (`-t`) |
 | `dailybot chat update <bot_message_id>` | Edit a previously sent message (parent **or** a thread reply) |
+| `dailybot conversation open` | Open (or reuse) a Slack group DM with the bot; optionally post a message (`-m`) |
 
 ```bash
 # To a channel
@@ -984,6 +985,35 @@ belong to); an org API key (`dailybot config key=...`) is org-wide. A target
 outside your role's reach returns a clear error, as does the per-token CLI rate
 limit.
 
+### Conversation commands (Slack group DMs)
+
+| Command | Description |
+|---------|-------------|
+| `dailybot conversation open` | Open (or fetch) a Slack group DM that includes the Dailybot bot, and optionally post a message to it |
+
+```bash
+# Open a group DM with two teammates (by UUID) — prints the channel id
+dailybot conversation open -u <uuid1> -u <uuid2>
+
+# Name or email work too (resolved via the org directory)
+dailybot conversation open -u "Mauricio Gomez"
+dailybot conversation open --emails ana@co.com,luis@co.com
+
+# Open the group and immediately post a report in one call
+dailybot conversation open -u "Mauricio Gomez" \
+  -m "Report on the latest analysis — see thread for details."
+
+# Headless: capture the channel id for scripting
+CH=$(dailybot conversation open -u <uuid1> -u <uuid2> --json | jq -r .channel)
+```
+
+**Slack only, org-admin only.** Opening is **idempotent** — the same set of
+participants always returns the same channel, so "open it, or reuse the existing
+one" is a single call. The Dailybot bot is added automatically. Non-Slack orgs
+get a clear "Slack only" message; non-admins get a permissions error. The
+optional `-m/--message` chains a `group_chat` send to the returned channel (the
+same delivery path as `chat send`).
+
 ### Agent commands
 
 | Command | Description |

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/README.md

@@ -838,7 +838,7 @@ Replies to agent emails land as messages retrievable via `dailybot agent message
 
 | Command | Description |
 |---------|-------------|
-| `dailybot form list` | List forms visible to you (includes question count) |
+| `dailybot form list` | List every form in your org you can see (includes question count); `--mine` narrows to forms you own |
 | `dailybot form get <uuid>` | Show the form's full payload (questions + workflow states) |
 | `dailybot form submit <uuid>` | Submit a form (guided prompts or `--content` JSON) |
 | `dailybot form responses <uuid>` | List your own responses on a form (`--state`, `--latest`) |
@@ -884,6 +884,7 @@ Works headless for agents (`--json` prints the `bot_message_id`).
 |---------|-------------|
 | `dailybot chat send` | Send a bot message to users (`-u`), channels (`-c`), and/or teams (`-t`) |
 | `dailybot chat update <bot_message_id>` | Edit a previously sent message (parent **or** a thread reply) |
+| `dailybot conversation open` | Open (or reuse) a Slack group DM with the bot; optionally post a message (`-m`) |
 
 ```bash
 # To a channel
@@ -945,6 +946,35 @@ belong to); an org API key (`dailybot config key=...`) is org-wide. A target
 outside your role's reach returns a clear error, as does the per-token CLI rate
 limit.
 
+### Conversation commands (Slack group DMs)
+
+| Command | Description |
+|---------|-------------|
+| `dailybot conversation open` | Open (or fetch) a Slack group DM that includes the Dailybot bot, and optionally post a message to it |
+
+```bash
+# Open a group DM with two teammates (by UUID) — prints the channel id
+dailybot conversation open -u <uuid1> -u <uuid2>
+
+# Name or email work too (resolved via the org directory)
+dailybot conversation open -u "Mauricio Gomez"
+dailybot conversation open --emails ana@co.com,luis@co.com
+
+# Open the group and immediately post a report in one call
+dailybot conversation open -u "Mauricio Gomez" \
+  -m "Report on the latest analysis — see thread for details."
+
+# Headless: capture the channel id for scripting
+CH=$(dailybot conversation open -u <uuid1> -u <uuid2> --json | jq -r .channel)
+```
+
+**Slack only, org-admin only.** Opening is **idempotent** — the same set of
+participants always returns the same channel, so "open it, or reuse the existing
+one" is a single call. The Dailybot bot is added automatically. Non-Slack orgs
+get a clear "Slack only" message; non-admins get a permissions error. The
+optional `-m/--message` chains a `group_chat` send to the returned channel (the
+same delivery path as `chat send`).
+
 ### Agent commands
 
 | Command | Description |

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli/api_client.py

@@ -795,6 +795,7 @@ class DailyBotClient:
         *,
         include_questions: bool = False,
         include_archived: bool = False,
+        owner: str | None = None,
         search: str | None = None,
         start_date: str | None = None,
         end_date: str | None = None,
@@ -806,6 +807,9 @@ class DailyBotClient:
     ) -> list[dict[str, Any]]:
         """GET /v1/forms/ — optionally expand questions, search, and page.
 
+        The default response is org-scoped (every form the caller can see on the
+        webapp list view). Pass ``owner="me"`` to narrow to the caller's own forms.
+
         When ``meta`` is given it is populated with ``count`` / ``next`` for a
         pagination footer.
         """
@@ -814,6 +818,8 @@ class DailyBotClient:
             params["include"] = "questions"
         if include_archived:
             params["include_archived"] = "true"
+        if owner:
+            params["owner"] = owner
         _merge_list_query(params, search=search, start_date=start_date, end_date=end_date)
         result: PaginatedResult = self._paginated_get(
             f"{self.api_url}/v1/forms/",
@@ -1493,6 +1499,26 @@ class DailyBotClient:
         )
         return self._handle_response(response)
 
+    def open_conversation(self, users_uuids: list[str]) -> dict[str, Any]:
+        """POST /v1/open-conversation/ — open (or fetch) a Slack group DM (MPIM).
+
+        Opens a private Slack group conversation that includes the given org
+        users plus the Dailybot bot (Slack adds the bot because the call uses the
+        org's bot token). The call is idempotent: the same set of users returns
+        the same channel if it already exists.
+
+        Slack-only and org-admin-only, both server-enforced. Authenticated via
+        the shared agent header logic (``X-API-KEY`` preferred, else the login
+        Bearer token). Returns ``{"channel": "<slack-conversation-id>"}``.
+        """
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/open-conversation/",
+            json={"users_uuids": users_uuids},
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
     # --- Agent message endpoints ---
 
     def send_agent_message(

dailybot_cli-3.2.0/dailybot_cli/commands/conversation.py

@@ -0,0 +1,187 @@
+"""``conversation`` command group — open a Slack group DM (MPIM) that includes
+the Dailybot bot, and optionally post a message to it.
+
+Wraps ``POST /v1/open-conversation/`` (Slack-only, org-admin-only, idempotent)
+and chains the existing ``POST /v1/send-message/`` path with
+``channel_type=group_chat`` when ``--message`` is given. Authenticated with a
+login Bearer token or an org API key. Participants can be named by UUID, email,
+or name — non-UUID identifiers are resolved client-side via ``GET /v1/users/``.
+"""
+
+from typing import Any, NoReturn
+
+import click
+
+from dailybot_cli.api_client import APIError, DailyBotClient
+from dailybot_cli.commands.public_api_helpers import (
+    UUID_PATTERN,
+    emit_json,
+    require_auth,
+    resolve_user_by_name_or_uuid,
+)
+from dailybot_cli.display import (
+    console,
+    print_conversation_result,
+    print_error,
+)
+
+GROUP_CHAT_TYPE: str = "group_chat"
+
+
+def _split_identifiers(values: tuple[str, ...]) -> list[str]:
+    """Flatten repeatable and comma-separated option values into a clean list."""
+    out: list[str] = []
+    for value in values:
+        out.extend(part.strip() for part in value.split(",") if part.strip())
+    return out
+
+
+def _resolve_participants(client: DailyBotClient, identifiers: list[str]) -> list[tuple[str, str]]:
+    """Resolve each identifier (UUID, email, or name) to a (uuid, name) pair.
+
+    The user directory is fetched only when at least one identifier is not a bare
+    UUID, so an all-UUID call avoids the extra round-trip. Order is preserved and
+    duplicate UUIDs are dropped (keeping the first occurrence).
+    """
+    needs_directory: bool = any(not UUID_PATTERN.match(ident) for ident in identifiers)
+    directory: list[dict[str, Any]] = (
+        client.list_users(include_email=True) if needs_directory else []
+    )
+    resolved: list[tuple[str, str]] = []
+    seen: set[str] = set()
+    for ident in identifiers:
+        uuid, name = resolve_user_by_name_or_uuid(directory, ident)
+        if uuid in seen:
+            continue
+        seen.add(uuid)
+        resolved.append((uuid, name))
+    return resolved
+
+
+def _exit_for_conversation_error(exc: APIError, json_mode: bool) -> NoReturn:
+    """Translate an open-conversation / send failure to a friendly message + exit."""
+    code: str | None = getattr(exc, "code", None)
+    if code == "open_conversation_not_supported" or exc.status_code == 406:
+        message: str = "Group conversations are only supported for Slack workspaces."
+    elif code == "one_or_more_users_not_found":
+        message = "One or more users were not found or aren't active in your organization."
+    elif code == "no_valid_users":
+        message = "The participant list contains invalid user UUIDs."
+    elif code == "conversation_can_not_be_opened":
+        message = "Slack rejected the request. A participant may be deactivated on the Slack side."
+    elif exc.status_code == 403:
+        message = "This command requires organization admin privileges."
+    elif exc.status_code == 401:
+        message = "Session expired. Run: dailybot login"
+    elif exc.status_code == 429:
+        message = "Rate limit exceeded. Wait a moment and try again."
+    else:
+        message = exc.detail
+    if json_mode:
+        payload: dict[str, Any] = {"error": message, "status": exc.status_code}
+        if code:
+            payload["code"] = code
+        emit_json(payload)
+    else:
+        print_error(message)
+    raise SystemExit(1)
+
+
+@click.group(name="conversation")
+def conversation() -> None:
+    """Open Slack group DMs (with the Dailybot bot) and post to them.
+
+    \b
+    Slack only, organization admin only. Opens a private group DM (MPIM) that
+    includes the Dailybot bot plus the users you name, then optionally posts a
+    message. Opening is idempotent — the same set of users returns the same
+    channel.
+    """
+
+
+@conversation.command("open")
+@click.option(
+    "--user",
+    "--users",
+    "-u",
+    "users_raw",
+    multiple=True,
+    help="Participant by UUID, email, or name (repeatable or comma-separated).",
+)
+@click.option(
+    "--email",
+    "--emails",
+    "-e",
+    "emails_raw",
+    multiple=True,
+    help="Participant by email (repeatable or comma-separated); resolved to a UUID.",
+)
+@click.option(
+    "--message",
+    "-m",
+    default=None,
+    help="Optional message to post to the group right after opening it.",
+)
+@click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+def conversation_open(
+    users_raw: tuple[str, ...],
+    emails_raw: tuple[str, ...],
+    message: str | None,
+    json_mode: bool,
+) -> None:
+    """Open (or fetch) a Slack group DM and optionally post a message.
+
+    \b
+    Slack only, org admin only. Idempotent — the same participants return the
+    same channel. Participants accept UUID, email, or name; --emails is a
+    convenience alias that only takes emails.
+
+    \b
+    Examples:
+      dailybot conversation open -u <uuid1> -u <uuid2>
+      dailybot conversation open -u Mauricio -m "Report on the latest analysis"
+      dailybot conversation open --emails ana@co.com,luis@co.com --json
+    """
+    identifiers: list[str] = _split_identifiers(users_raw) + _split_identifiers(emails_raw)
+    if not identifiers:
+        print_error("Provide at least one participant with --user (UUID, email, or name).")
+        raise SystemExit(1)
+
+    client: DailyBotClient = require_auth()
+    try:
+        participants: list[tuple[str, str]] = _resolve_participants(client, identifiers)
+    except ValueError as exc:
+        print_error(str(exc))
+        raise SystemExit(1)
+
+    uuids: list[str] = [uuid for uuid, _name in participants]
+    try:
+        with console.status("Opening group conversation..."):
+            result: dict[str, Any] = client.open_conversation(uuids)
+    except APIError as exc:
+        _exit_for_conversation_error(exc, json_mode)
+
+    channel: str = str(result.get("channel", ""))
+    message_sent: bool = False
+    if message:
+        payload: dict[str, Any] = {
+            "message": message,
+            "target_channels": [{"id": channel, "channel_type": GROUP_CHAT_TYPE}],
+        }
+        try:
+            with console.status("Sending message..."):
+                client.send_chat_message(payload)
+        except APIError as exc:
+            _exit_for_conversation_error(exc, json_mode)
+        message_sent = True
+
+    if json_mode:
+        emit_json(
+            {
+                "channel": channel,
+                "participants": [{"uuid": uuid, "name": name} for uuid, name in participants],
+                "message_sent": message_sent,
+            }
+        )
+        return
+    print_conversation_result(channel, participants, message_sent=message_sent)

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli/commands/form.py

@@ -188,10 +188,16 @@ def form() -> None:
     is_flag=True,
     help="Include archived forms (hidden by default).",
 )
+@click.option(
+    "--mine",
+    is_flag=True,
+    help="Only forms you own (default lists every form you can see in the org).",
+)
 @query_options
 @click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
 def form_list(
     include_archived: bool,
+    mine: bool,
     json_mode: bool,
     page: int | None,
     page_size: int | None,
@@ -207,12 +213,15 @@ def form_list(
     """List forms visible to you.
 
     \b
-    Acts as you. You can only see and act on what you could in the webapp.
+    Acts as you. You can only see and act on what you could in the webapp:
+    by default this is every form in your org you have list-view access to.
+    Pass --mine to narrow to only the forms you own.
     Archived forms are hidden unless you pass --include-archived.
 
     \b
     Examples:
       dailybot form list
+      dailybot form list --mine
       dailybot form list --search retro --since 2026-07-01
       dailybot form list --all
       dailybot form list --json
@@ -235,7 +244,13 @@ def form_list(
         print_error(str(exc))
         raise SystemExit(1)
     client = require_auth()
-    execute_form_list(client, json_mode=json_mode, include_archived=include_archived, spec=spec)
+    execute_form_list(
+        client,
+        json_mode=json_mode,
+        include_archived=include_archived,
+        owner="me" if mine else None,
+        spec=spec,
+    )
 
 
 @form.command("get")

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli/commands/user_scoped_actions.py

@@ -500,6 +500,7 @@ def execute_form_list(
     *,
     json_mode: bool = False,
     include_archived: bool = False,
+    owner: str | None = None,
     spec: QuerySpec | None = None,
 ) -> list[dict[str, Any]] | None:
     """Fetch and display forms visible to the user (with question counts)."""
@@ -511,6 +512,7 @@ def execute_form_list(
             forms: list[dict[str, Any]] = client.list_forms(
                 include_questions=True,
                 include_archived=include_archived,
+                owner=owner,
                 search=query.params.get("search"),
                 start_date=query.params.get("start_date"),
                 end_date=query.params.get("end_date"),

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli/display.py

@@ -406,6 +406,27 @@ def print_chat_message_result(data: dict[str, Any], *, updated: bool = False) ->
     console.print(Panel(table, title=f"[bold]{title}[/bold]", border_style="green"))
 
 
+def print_conversation_result(
+    channel: str,
+    participants: list[tuple[str, str]],
+    *,
+    message_sent: bool = False,
+) -> None:
+    """Display the opened Slack group conversation and its participants.
+
+    ``participants`` is a list of ``(uuid, display_name)`` pairs. ``message_sent``
+    flags whether a message was posted to the group right after opening it.
+    """
+    table: Table = Table(show_header=False, box=None, padding=(0, 2))
+    table.add_column(style="bold cyan", no_wrap=True)
+    table.add_column()
+    table.add_row("Channel", channel)
+    table.add_row("Participants", ", ".join(name for _uuid, name in participants) or "[dim]—[/dim]")
+    if message_sent:
+        table.add_row("Message", "Sent to the group")
+    console.print(Panel(table, title="[bold]Group Conversation[/bold]", border_style="green"))
+
+
 def print_agent_report_result(result: dict[str, Any]) -> None:
     """Display the result of submitting an agent activity report.
 

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli/main.py

@@ -12,6 +12,7 @@ from dailybot_cli.commands.channels import channels
 from dailybot_cli.commands.chat import chat
 from dailybot_cli.commands.checkin import checkin
 from dailybot_cli.commands.config import config
+from dailybot_cli.commands.conversation import conversation
 from dailybot_cli.commands.form import form
 from dailybot_cli.commands.hook import hook
 from dailybot_cli.commands.identity import me, org
@@ -86,6 +87,7 @@ cli.add_command(org)
 cli.add_command(workflow)
 cli.add_command(agent)
 cli.add_command(chat)
+cli.add_command(conversation)
 cli.add_command(ask)
 cli.add_command(interactive)
 cli.add_command(config)

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.1.2
+Version: 3.2.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
@@ -877,7 +877,7 @@ Replies to agent emails land as messages retrievable via `dailybot agent message
 
 | Command | Description |
 |---------|-------------|
-| `dailybot form list` | List forms visible to you (includes question count) |
+| `dailybot form list` | List every form in your org you can see (includes question count); `--mine` narrows to forms you own |
 | `dailybot form get <uuid>` | Show the form's full payload (questions + workflow states) |
 | `dailybot form submit <uuid>` | Submit a form (guided prompts or `--content` JSON) |
 | `dailybot form responses <uuid>` | List your own responses on a form (`--state`, `--latest`) |
@@ -923,6 +923,7 @@ Works headless for agents (`--json` prints the `bot_message_id`).
 |---------|-------------|
 | `dailybot chat send` | Send a bot message to users (`-u`), channels (`-c`), and/or teams (`-t`) |
 | `dailybot chat update <bot_message_id>` | Edit a previously sent message (parent **or** a thread reply) |
+| `dailybot conversation open` | Open (or reuse) a Slack group DM with the bot; optionally post a message (`-m`) |
 
 ```bash
 # To a channel
@@ -984,6 +985,35 @@ belong to); an org API key (`dailybot config key=...`) is org-wide. A target
 outside your role's reach returns a clear error, as does the per-token CLI rate
 limit.
 
+### Conversation commands (Slack group DMs)
+
+| Command | Description |
+|---------|-------------|
+| `dailybot conversation open` | Open (or fetch) a Slack group DM that includes the Dailybot bot, and optionally post a message to it |
+
+```bash
+# Open a group DM with two teammates (by UUID) — prints the channel id
+dailybot conversation open -u <uuid1> -u <uuid2>
+
+# Name or email work too (resolved via the org directory)
+dailybot conversation open -u "Mauricio Gomez"
+dailybot conversation open --emails ana@co.com,luis@co.com
+
+# Open the group and immediately post a report in one call
+dailybot conversation open -u "Mauricio Gomez" \
+  -m "Report on the latest analysis — see thread for details."
+
+# Headless: capture the channel id for scripting
+CH=$(dailybot conversation open -u <uuid1> -u <uuid2> --json | jq -r .channel)
+```
+
+**Slack only, org-admin only.** Opening is **idempotent** — the same set of
+participants always returns the same channel, so "open it, or reuse the existing
+one" is a single call. The Dailybot bot is added automatically. Non-Slack orgs
+get a clear "Slack only" message; non-admins get a permissions error. The
+optional `-m/--message` chains a `group_chat` send to the returned channel (the
+same delivery path as `chat send`).
+
 ### Agent commands
 
 | Command | Description |

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/dailybot_cli.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ dailybot_cli/commands/channels.py
 dailybot_cli/commands/chat.py
 dailybot_cli/commands/checkin.py
 dailybot_cli/commands/config.py
+dailybot_cli/commands/conversation.py
 dailybot_cli/commands/form.py
 dailybot_cli/commands/hook.py
 dailybot_cli/commands/identity.py

{dailybot_cli-3.1.2 → dailybot_cli-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dailybot-cli"
-version = "3.1.2"
+version = "3.2.0"
 description = "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."
 readme = "README.md"
 license = {text = "MIT"}