dailybot-cli 3.3.0__tar.gz → 3.5.0__tar.gz

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.3.0
+Version: 3.5.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

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/api_client.py

@@ -809,6 +809,9 @@ class DailyBotClient:
         include_questions: bool = False,
         include_archived: bool = False,
         owner: str | None = None,
+        filter_scope: str | None = None,
+        order: str | None = None,
+        is_ascend: bool = False,
         search: str | None = None,
         start_date: str | None = None,
         end_date: str | None = None,
@@ -821,7 +824,8 @@ class DailyBotClient:
         """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.
+        webapp list view). Pass ``owner="me"`` to narrow to the caller's own forms,
+        or ``filter_scope`` to apply a server-side scope filter.
 
         When ``meta`` is given it is populated with ``count`` / ``next`` for a
         pagination footer.
@@ -833,6 +837,12 @@ class DailyBotClient:
             params["include_archived"] = "true"
         if owner:
             params["owner"] = owner
+        if filter_scope:
+            params["filter"] = filter_scope
+        if order:
+            params["order"] = order
+        if is_ascend:
+            params["is_ascend"] = "true"
         _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/",
@@ -858,11 +868,25 @@ class DailyBotClient:
         self,
         form_uuid: str,
         content: dict[str, Any],
+        *,
+        automation: bool = False,
+        anonymous: bool = False,
+        guest_user: dict[str, str] | None = None,
+        submission_source: str | None = None,
     ) -> dict[str, Any]:
         """POST /v1/forms/<form_uuid>/responses/"""
+        payload: dict[str, Any] = {"content": content}
+        if automation:
+            payload["automation"] = True
+        if anonymous:
+            payload["anonymous"] = True
+        if guest_user:
+            payload["guest_user"] = guest_user
+        if submission_source:
+            payload["submission_source"] = submission_source
         response: httpx.Response = httpx.post(
             f"{self.api_url}/v1/forms/{form_uuid}/responses/",
-            json={"content": content},
+            json=payload,
             headers=self._headers(),
             timeout=self.timeout,
         )
@@ -875,6 +899,11 @@ class DailyBotClient:
         state: str | None = None,
         all_responses: bool = False,
         user: str | None = None,
+        submission_sources: str | None = None,
+        submitter_user_ids: str | None = None,
+        flow_status: str | None = None,
+        order: str | None = None,
+        is_ascend: bool = False,
         date_from: str | None = None,
         date_to: str | None = None,
         search: str | None = None,
@@ -900,6 +929,16 @@ class DailyBotClient:
             params["all"] = "true"
         if user:
             params["user"] = user
+        if submission_sources:
+            params["submission_sources"] = submission_sources
+        if submitter_user_ids:
+            params["submitter_user_ids"] = submitter_user_ids
+        if flow_status:
+            params["flow_status"] = flow_status
+        if order:
+            params["order"] = order
+        if is_ascend:
+            params["is_ascend"] = "true"
         if date_from:
             params["date_from"] = date_from
         if date_to:

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/commands/form.py

@@ -1,5 +1,6 @@
 """Form commands for the user-scoped public API."""
 
+import re
 from collections.abc import Callable
 from typing import Any
 
@@ -59,6 +60,16 @@ from dailybot_cli.display import (
 # The server reuses `invalid_workflow_state` for a malformed `--state
 # "Label:#color"` during authoring. On this listing it means the form has no
 # workflow at all, so the shared message would send the user down the wrong path.
+MAX_SUBMISSION_SOURCE_LENGTH: int = 512
+_EMAIL_RE: re.Pattern[str] = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")
+
+FORM_LIST_FILTERS: tuple[str, ...] = ("all", "me", "public", "approval", "workflow", "archived")
+FORM_LIST_ORDERS: tuple[str, ...] = ("alphabetical", "recent", "total")
+RESPONSE_ORDERS: tuple[str, ...] = ("recent", "oldest")
+RESPONSE_SOURCES: tuple[str, ...] = ("member", "anonymous", "automation", "public")
+RESPONSE_FLOW_STATUSES: tuple[str, ...] = ("pending", "approved", "denied")
+MAX_SUBMITTER_IDS: int = 50
+
 _RESPONSES_ERROR_OVERRIDES: dict[str, str] = {
     "invalid_workflow_state": (
         "This form has no workflow, so --state doesn't apply. Drop the flag, or run "
@@ -193,11 +204,42 @@ def form() -> None:
     is_flag=True,
     help="Only forms you own (default lists every form you can see in the org).",
 )
+@click.option(
+    "--filter",
+    "filter_scope",
+    type=click.Choice(FORM_LIST_FILTERS, case_sensitive=False),
+    default=None,
+    help="Scope filter: all, me, public, approval, workflow, archived.",
+)
+@click.option(
+    "--order",
+    type=click.Choice(FORM_LIST_ORDERS, case_sensitive=False),
+    default=None,
+    help="Sort order: alphabetical, recent, or total responses.",
+)
+@click.option(
+    "--ascending",
+    "--asc",
+    "is_ascend",
+    is_flag=True,
+    default=False,
+    help="Sort ascending (default: descending).",
+)
+@click.option(
+    "--include-questions",
+    is_flag=True,
+    default=False,
+    help="Include question definitions in each form.",
+)
 @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,
+    filter_scope: str | None,
+    order: str | None,
+    is_ascend: bool,
+    include_questions: bool,
     json_mode: bool,
     page: int | None,
     page_size: int | None,
@@ -215,16 +257,19 @@ def form_list(
     \b
     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.
+    Pass --mine to narrow to only the forms you own, or --filter to scope.
+    Archived forms are hidden unless you pass --include-archived or --filter archived.
 
     \b
     Examples:
       dailybot form list
       dailybot form list --mine
+      dailybot form list --filter workflow --order alphabetical --asc
+      dailybot form list --filter approval
+      dailybot form list --filter public --order total
       dailybot form list --search retro --since 2026-07-01
+      dailybot form list --include-questions --json
       dailybot form list --all
-      dailybot form list --json
     """
     enforce_plan_access("form_list", json_mode=json_mode)
     try:
@@ -248,7 +293,11 @@ def form_list(
         client,
         json_mode=json_mode,
         include_archived=include_archived,
+        include_questions=include_questions,
         owner="me" if mine else None,
+        filter_scope=filter_scope,
+        order=order,
+        is_ascend=is_ascend,
         spec=spec,
     )
 
@@ -290,11 +339,50 @@ def form_get(form_uuid: str, json_mode: bool) -> None:
 )
 @click.option("--yes", "-y", "assume_yes", is_flag=True, help="Skip the confirmation prompt.")
 @click.option("--json", "json_mode", is_flag=True, help="Emit machine-readable JSON to stdout.")
+@click.option(
+    "--automation",
+    is_flag=True,
+    default=False,
+    help=(
+        "Submit as an automation. The response will appear in channel "
+        "notifications without any submitter name — useful when "
+        "forwarding third-party form submissions via integrations."
+    ),
+)
+@click.option(
+    "--anonymous",
+    is_flag=True,
+    default=False,
+    help=(
+        "Submit anonymously. The response will appear with a random "
+        "generated name instead of your real name."
+    ),
+)
+@click.option(
+    "--guest-name",
+    default=None,
+    help="Guest submitter name (used with --automation for third-party submissions).",
+)
+@click.option(
+    "--guest-email",
+    default=None,
+    help="Guest submitter email (used with --automation for third-party submissions).",
+)
+@click.option(
+    "--source",
+    default=None,
+    help="Provenance label for this submission (max 512 chars, e.g. 'workflow:release-pipeline').",
+)
 def form_submit(
     form_uuid: str,
     content: str | None,
     assume_yes: bool,
     json_mode: bool,
+    automation: bool,
+    anonymous: bool,
+    guest_name: str | None,
+    guest_email: str | None,
+    source: str | None,
 ) -> None:
     """Submit a form response.
 
@@ -309,7 +397,29 @@ def form_submit(
       dailybot form submit <form_uuid>
       dailybot form submit <form_uuid> --content '{"<question_uuid>":"Yes"}'
       dailybot form submit <form_uuid> --content '{"<uuid>":"Answer"}' --yes
+      dailybot form submit <form_uuid> --content '{"<uuid>":"A"}' --automation
+      dailybot form submit <form_uuid> --content '{"<uuid>":"A"}' --anonymous
+      dailybot form submit <form_uuid> --content '{"<uuid>":"A"}' --automation \\
+        --guest-name "Release Bot" --guest-email "bot@example.com" \\
+        --source "workflow:production-deploy"
     """
+    if guest_email and not _EMAIL_RE.match(guest_email):
+        print_error(f"Invalid email format: {guest_email}")
+        raise SystemExit(1)
+    if source and len(source) > MAX_SUBMISSION_SOURCE_LENGTH:
+        print_error(
+            f"--source is too long ({len(source)} chars, max {MAX_SUBMISSION_SOURCE_LENGTH})."
+        )
+        raise SystemExit(1)
+
+    guest_user: dict[str, str] | None = None
+    if guest_name or guest_email:
+        guest_user = {}
+        if guest_name:
+            guest_user["full_name"] = guest_name
+        if guest_email:
+            guest_user["email"] = guest_email
+
     client = require_auth()
     content_map = resolve_form_content(client, form_uuid, content)
     execute_form_submit(
@@ -318,6 +428,10 @@ def form_submit(
         content_map,
         assume_yes=assume_yes,
         json_mode=json_mode,
+        automation=automation,
+        anonymous=anonymous,
+        guest_user=guest_user,
+        submission_source=source,
     )
 
 
@@ -332,15 +446,48 @@ def form_submit(
     "--all",
     "all_responses",
     is_flag=True,
-    help="List everyone's responses (admin/owner only; a member gets 403).",
+    help="List everyone's responses (requires VIEW_REPORTS permission).",
 )
 @click.option("--user", default=None, help="Filter to one user's responses (admin/owner only).")
+@click.option(
+    "--source",
+    "submission_sources",
+    default=None,
+    help="Filter by origin (CSV: member, anonymous, automation, public).",
+)
+@click.option(
+    "--submitter",
+    "submitter_ids",
+    default=None,
+    help="Filter by submitter UUIDs (CSV, max 50).",
+)
+@click.option(
+    "--flow-status",
+    "flow_status",
+    type=click.Choice(RESPONSE_FLOW_STATUSES, case_sensitive=False),
+    default=None,
+    help="Approval flow status: pending, approved, denied.",
+)
+@click.option(
+    "--order",
+    type=click.Choice(RESPONSE_ORDERS, case_sensitive=False),
+    default=None,
+    help="Sort order: recent or oldest.",
+)
+@click.option(
+    "--ascending",
+    "--asc",
+    "is_ascend",
+    is_flag=True,
+    default=False,
+    help="Sort ascending (alias for --order oldest).",
+)
 @click.option(
     "--from", "date_from", default=None, help="Responses on/after this date (YYYY-MM-DD)."
 )
 @click.option("--to", "date_to", default=None, help="Responses on/before this date (YYYY-MM-DD).")
 @click.option(
-    "--search", "-s", "search", default=None, help="Filter response content (max 256 chars)."
+    "--search", "-s", "search", default=None, help="Search content and submitter (max 256 chars)."
 )
 @click.option(
     "--latest",
@@ -354,6 +501,11 @@ def form_responses(
     state: str | None,
     all_responses: bool,
     user: str | None,
+    submission_sources: str | None,
+    submitter_ids: str | None,
+    flow_status: str | None,
+    order: str | None,
+    is_ascend: bool,
     date_from: str | None,
     date_to: str | None,
     search: str | None,
@@ -367,17 +519,45 @@ def form_responses(
 
     \b
     Acts as you. By default the server returns only responses you authored.
-    --all / --user surface others' responses and are admin/owner-only
-    (server-enforced — a member receives 403). --from / --to narrow the window.
+    --all / --user surface others' responses and require VIEW_REPORTS
+    permission (server-enforced — a member receives 403).
+
+    \b
+    --source filters by origin: member, anonymous, automation, public.
+    Multiple values are comma-separated (OR semantics).
+    --submitter filters by specific user UUIDs (CSV, max 50, OR semantics).
+    --flow-status filters approval status: pending, approved, denied.
 
     \b
     Examples:
       dailybot form responses <form_uuid>
       dailybot form responses <form_uuid> --state qa --json
       dailybot form responses <form_uuid> --all --from 2026-01-01 --to 2026-06-30
+      dailybot form responses <form_uuid> --all --source automation
+      dailybot form responses <form_uuid> --all --source "member,automation"
+      dailybot form responses <form_uuid> --all --flow-status pending
+      dailybot form responses <form_uuid> --all --search "deploy" --order oldest
       dailybot form responses <form_uuid> --user <user_uuid> --json
     """
     validate_user_filter(user)
+    if submission_sources:
+        parts: list[str] = [s.strip() for s in submission_sources.split(",")]
+        invalid: list[str] = [s for s in parts if s not in RESPONSE_SOURCES]
+        if invalid:
+            print_error(
+                f"Invalid source(s): {', '.join(invalid)}. Allowed: {', '.join(RESPONSE_SOURCES)}."
+            )
+            raise SystemExit(1)
+    if submitter_ids:
+        ids: list[str] = [s.strip() for s in submitter_ids.split(",")]
+        if len(ids) > MAX_SUBMITTER_IDS:
+            print_error(f"Too many submitter UUIDs ({len(ids)}, max {MAX_SUBMITTER_IDS}).")
+            raise SystemExit(1)
+
+    effective_order: str | None = order
+    if is_ascend and not order:
+        effective_order = "oldest"
+
     client = require_auth()
     truncated_search: str | None = search[:256] if search is not None else None
     meta: dict[str, Any] = {}
@@ -388,6 +568,11 @@ def form_responses(
                 state=state,
                 all_responses=all_responses,
                 user=user,
+                submission_sources=submission_sources,
+                submitter_user_ids=submitter_ids,
+                flow_status=flow_status,
+                order=effective_order,
+                is_ascend=is_ascend,
                 date_from=date_from,
                 date_to=date_to,
                 search=truncated_search,

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/commands/public_api_helpers.py

@@ -234,6 +234,18 @@ ERROR_CODE_MESSAGES: dict[str, str] = {
     "search_query_too_long": (
         "Search term is too long (maximum 256 characters). Shorten it and try again."
     ),
+    "guest_user_required": (
+        "This form requires guest submitter info. "
+        "Add --guest-name and --guest-email to your command."
+    ),
+    "invalid_filter": "Unknown --filter value. Use: all, me, public, approval, workflow, archived.",
+    "invalid_order": "Unknown --order value. Use: alphabetical, recent, total (forms) or recent, oldest (responses).",
+    "invalid_submission_sources": (
+        "Unknown --source value. Use: member, anonymous, automation, public (comma-separated)."
+    ),
+    "invalid_submitter_user_id": "Invalid --submitter UUID format.",
+    "too_many_submitter_user_ids": "Too many --submitter UUIDs (max 50).",
+    "invalid_flow_status": "Unknown --flow-status value. Use: pending, approved, denied.",
     "invalid_date_range": (
         "Invalid date. Use YYYY-MM-DD, and make sure the start date is on or before the end date."
     ),

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/commands/user_scoped_actions.py

@@ -500,19 +500,27 @@ def execute_form_list(
     *,
     json_mode: bool = False,
     include_archived: bool = False,
+    include_questions: bool = False,
     owner: str | None = None,
+    filter_scope: str | None = None,
+    order: str | None = None,
+    is_ascend: bool = False,
     spec: QuerySpec | None = None,
 ) -> list[dict[str, Any]] | None:
     """Fetch and display forms visible to the user (with question counts)."""
     query: QuerySpec = spec or QuerySpec()
     fetch_all: bool = resolve_fetch_all(query)
     meta: dict[str, Any] = {}
+    always_include_questions: bool = include_questions or not json_mode
     try:
         with console.status("Fetching forms..."):
             forms: list[dict[str, Any]] = client.list_forms(
-                include_questions=True,
+                include_questions=always_include_questions,
                 include_archived=include_archived,
                 owner=owner,
+                filter_scope=filter_scope,
+                order=order,
+                is_ascend=is_ascend,
                 search=query.params.get("search"),
                 start_date=query.params.get("start_date"),
                 end_date=query.params.get("end_date"),
@@ -542,6 +550,10 @@ def execute_form_submit(
     form_name: str | None = None,
     assume_yes: bool = False,
     json_mode: bool = False,
+    automation: bool = False,
+    anonymous: bool = False,
+    guest_user: dict[str, str] | None = None,
+    submission_source: str | None = None,
 ) -> None:
     """Submit a form response."""
     resolved_name: str = form_name or form_uuid
@@ -556,8 +568,19 @@ def execute_form_submit(
     summary_lines: list[str] = [
         f"Form: {resolved_name}",
         f"Form UUID: {form_uuid}",
-        "Answers:",
     ]
+    if automation:
+        summary_lines.append("Mode: automation (no submitter shown in channel)")
+    if anonymous:
+        summary_lines.append("Mode: anonymous (random name shown in channel)")
+    if guest_user:
+        guest_desc: str = guest_user.get("full_name", "")
+        if guest_user.get("email"):
+            guest_desc += f" <{guest_user['email']}>" if guest_desc else guest_user["email"]
+        summary_lines.append(f"Guest: {guest_desc}")
+    if submission_source:
+        summary_lines.append(f"Source: {submission_source}")
+    summary_lines.append("Answers:")
     for question_uuid, answer in content_map.items():
         summary_lines.append(f"  {question_uuid}: {answer}")
 
@@ -568,6 +591,10 @@ def execute_form_submit(
             result: dict[str, Any] = client.submit_form_response(
                 form_uuid=form_uuid,
                 content=content_map,
+                automation=automation,
+                anonymous=anonymous,
+                guest_user=guest_user,
+                submission_source=submission_source,
             )
     except APIError as exc:
         exit_for_api_error(exc, json_mode)

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/config.py

@@ -6,7 +6,9 @@ from pathlib import Path
 from typing import Any
 
 DEFAULT_API_URL: str = "https://api.dailybot.com"
+DEFAULT_APP_URL: str = "https://app.dailybot.com"
 _api_url_override: str | None = None
+_app_url_override: str | None = None
 
 
 def set_api_url_override(url: str) -> None:
@@ -15,6 +17,12 @@ def set_api_url_override(url: str) -> None:
     _api_url_override = url.rstrip("/")
 
 
+def set_app_url_override(url: str) -> None:
+    """Set a CLI-level webapp URL override (from --app-url flag)."""
+    global _app_url_override
+    _app_url_override = url.rstrip("/")
+
+
 CONFIG_DIR: Path = Path.home() / ".config" / "dailybot"
 CREDENTIALS_FILE: Path = CONFIG_DIR / "credentials.json"
 CONFIG_FILE: Path = CONFIG_DIR / "config.json"
@@ -108,6 +116,16 @@ def get_api_url() -> str:
     return DEFAULT_API_URL
 
 
+def get_app_url() -> str:
+    """Return the webapp URL (--app-url flag > env var > default)."""
+    if _app_url_override:
+        return _app_url_override
+    env_url: str | None = os.environ.get("DAILYBOT_APP_URL")
+    if env_url:
+        return env_url.rstrip("/")
+    return DEFAULT_APP_URL
+
+
 def get_token() -> str | None:
     """Return the stored auth token, or the DAILYBOT_CLI_TOKEN env var."""
     env_token: str | None = os.environ.get("DAILYBOT_CLI_TOKEN")

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli/main.py

@@ -27,7 +27,7 @@ from dailybot_cli.commands.upgrade import upgrade
 from dailybot_cli.commands.user import user
 from dailybot_cli.commands.version import version
 from dailybot_cli.commands.workflow import workflow
-from dailybot_cli.config import set_api_url_override
+from dailybot_cli.config import set_api_url_override, set_app_url_override
 
 # Format used by `dailybot --version`. Single line so it's friendly to scripts
 # parsing the output. The richer multi-line panel lives in `dailybot version`.
@@ -42,8 +42,14 @@ _VERSION_MESSAGE: str = f"dailybot {__version__} (Python {platform.python_versio
     envvar="DAILYBOT_API_URL",
     help="Override the API base URL (e.g. staging).",
 )
+@click.option(
+    "--app-url",
+    default=None,
+    envvar="DAILYBOT_APP_URL",
+    help="Override the webapp/dashboard base URL (default: https://app.dailybot.com).",
+)
 @click.pass_context
-def cli(ctx: click.Context, api_url: str | None) -> None:
+def cli(ctx: click.Context, api_url: str | None, app_url: str | None) -> None:
     """Dailybot CLI - The command-line bridge between humans and agents.
 
     \b
@@ -68,6 +74,8 @@ def cli(ctx: click.Context, api_url: str | None) -> None:
     """
     if api_url:
         set_api_url_override(api_url)
+    if app_url:
+        set_app_url_override(app_url)
     if ctx.invoked_subcommand is None:
         run_interactive()
 

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/dailybot_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dailybot-cli
-Version: 3.3.0
+Version: 3.5.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

{dailybot_cli-3.3.0 → dailybot_cli-3.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dailybot-cli"
-version = "3.3.0"
+version = "3.5.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"}