dailybot-cli 0.1.0__tar.gz

dailybot_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DailyBot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dailybot_cli-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: dailybot-cli
+Version: 0.1.0
+Summary: DailyBot CLI - Submit check-in updates from your terminal
+Author-email: DailyBot <support@dailybot.com>
+License: MIT
+Project-URL: Homepage, https://www.dailybot.com
+Project-URL: Documentation, https://docs.dailybot.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# DailyBot CLI
+
+A command-line interface for [DailyBot](https://www.dailybot.com) that lets **people** and **software agents** share progress updates, blockers, and feedback — straight from the terminal.
+
+Whether you're a developer who lives in the terminal or an AI agent running in a CI pipeline, the DailyBot CLI gives you a fast way to submit check-ins without leaving your workflow.
+
+## Installation
+
+```bash
+pip install dailybot-cli
+```
+
+Or via the install script:
+
+```bash
+curl -sSL https://cli.dailybot.com/install.sh | bash
+```
+
+Requires Python 3.9+.
+
+## For humans
+
+Authenticate once with your DailyBot email, then submit updates and check pending check-ins right from your terminal.
+
+```bash
+# Log in (one-time setup, email OTP)
+dailybot login
+
+# See what check-ins are waiting for you
+dailybot status
+
+# Submit a free-text update
+dailybot update "Finished the auth module, starting on tests."
+
+# Or use structured fields
+dailybot update --done "Auth module" --doing "Tests" --blocked "None"
+```
+
+Run `dailybot` with no arguments to enter **interactive mode** — if you're not logged in yet, it will walk you through authentication first, then let you submit updates step by step.
+
+## For agents
+
+Any software agent — AI coding assistants, CI jobs, deploy scripts, bots — can report activity through the CLI. This lets teams get visibility into what automated processes are doing, alongside human updates.
+
+Authenticate with any of these methods (checked in this order):
+
+```bash
+# Option 1: Environment variable (CI pipelines, one-off scripts)
+export DAILYBOT_API_KEY=your-key
+
+# Option 2: Store the key on disk (recommended for dev machines)
+dailybot config key=your-key
+
+# Option 3: Use your login session (no API key needed)
+dailybot login
+```
+
+Then run agent commands:
+
+```bash
+# Report a deployment
+dailybot agent update "Deployed v2.1 to staging"
+
+# Name the agent so the team knows who's reporting
+dailybot agent update "Built feature X" --name "Claude Code"
+
+# Include structured data
+dailybot agent update "Tests passed" --name "CI Bot" --json-data '{"suite": "integration", "passed": 42}'
+
+# Report agent health
+dailybot agent health --ok --message "All systems go" --name "Claude Code"
+dailybot agent health --fail --message "DB unreachable" --name "CI Bot"
+
+# Check agent health status
+dailybot agent health --status --name "Claude Code"
+
+# Register a webhook to receive messages
+dailybot agent webhook register --url https://my-server.com/hook --secret my-token --name "Claude Code"
+
+# Unregister a webhook
+dailybot agent webhook unregister --name "Claude Code"
+
+# Send a message to an agent
+dailybot agent message send --to "Claude Code" --content "Review PR #42"
+dailybot agent message send --to "Claude Code" --content "Do X" --type command
+
+# List messages for an agent
+dailybot agent message list --name "Claude Code"
+dailybot agent message list --name "Claude Code" --pending
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `dailybot login` | Authenticate with email OTP |
+| `dailybot logout` | Log out and revoke token |
+| `dailybot status` | Show pending check-ins for today |
+| `dailybot update` | Submit a check-in update (free-text or structured) |
+| `dailybot config` | Get, set, or remove a stored setting (e.g. API key) |
+| `dailybot agent update` | Submit an agent activity report (API key or login) |
+| `dailybot agent health` | Report or query agent health status (API key or login) |
+| `dailybot agent webhook register` | Register a webhook for the agent (API key or login) |
+| `dailybot agent webhook unregister` | Unregister the agent's webhook (API key or login) |
+| `dailybot agent message send` | Send a message to an agent (API key or login) |
+| `dailybot agent message list` | List messages for an agent (API key or login) |
+
+Run `dailybot --help` for full details on any command.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE)

dailybot_cli-0.1.0/README.md

@@ -0,0 +1,119 @@
+# DailyBot CLI
+
+A command-line interface for [DailyBot](https://www.dailybot.com) that lets **people** and **software agents** share progress updates, blockers, and feedback — straight from the terminal.
+
+Whether you're a developer who lives in the terminal or an AI agent running in a CI pipeline, the DailyBot CLI gives you a fast way to submit check-ins without leaving your workflow.
+
+## Installation
+
+```bash
+pip install dailybot-cli
+```
+
+Or via the install script:
+
+```bash
+curl -sSL https://cli.dailybot.com/install.sh | bash
+```
+
+Requires Python 3.9+.
+
+## For humans
+
+Authenticate once with your DailyBot email, then submit updates and check pending check-ins right from your terminal.
+
+```bash
+# Log in (one-time setup, email OTP)
+dailybot login
+
+# See what check-ins are waiting for you
+dailybot status
+
+# Submit a free-text update
+dailybot update "Finished the auth module, starting on tests."
+
+# Or use structured fields
+dailybot update --done "Auth module" --doing "Tests" --blocked "None"
+```
+
+Run `dailybot` with no arguments to enter **interactive mode** — if you're not logged in yet, it will walk you through authentication first, then let you submit updates step by step.
+
+## For agents
+
+Any software agent — AI coding assistants, CI jobs, deploy scripts, bots — can report activity through the CLI. This lets teams get visibility into what automated processes are doing, alongside human updates.
+
+Authenticate with any of these methods (checked in this order):
+
+```bash
+# Option 1: Environment variable (CI pipelines, one-off scripts)
+export DAILYBOT_API_KEY=your-key
+
+# Option 2: Store the key on disk (recommended for dev machines)
+dailybot config key=your-key
+
+# Option 3: Use your login session (no API key needed)
+dailybot login
+```
+
+Then run agent commands:
+
+```bash
+# Report a deployment
+dailybot agent update "Deployed v2.1 to staging"
+
+# Name the agent so the team knows who's reporting
+dailybot agent update "Built feature X" --name "Claude Code"
+
+# Include structured data
+dailybot agent update "Tests passed" --name "CI Bot" --json-data '{"suite": "integration", "passed": 42}'
+
+# Report agent health
+dailybot agent health --ok --message "All systems go" --name "Claude Code"
+dailybot agent health --fail --message "DB unreachable" --name "CI Bot"
+
+# Check agent health status
+dailybot agent health --status --name "Claude Code"
+
+# Register a webhook to receive messages
+dailybot agent webhook register --url https://my-server.com/hook --secret my-token --name "Claude Code"
+
+# Unregister a webhook
+dailybot agent webhook unregister --name "Claude Code"
+
+# Send a message to an agent
+dailybot agent message send --to "Claude Code" --content "Review PR #42"
+dailybot agent message send --to "Claude Code" --content "Do X" --type command
+
+# List messages for an agent
+dailybot agent message list --name "Claude Code"
+dailybot agent message list --name "Claude Code" --pending
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `dailybot login` | Authenticate with email OTP |
+| `dailybot logout` | Log out and revoke token |
+| `dailybot status` | Show pending check-ins for today |
+| `dailybot update` | Submit a check-in update (free-text or structured) |
+| `dailybot config` | Get, set, or remove a stored setting (e.g. API key) |
+| `dailybot agent update` | Submit an agent activity report (API key or login) |
+| `dailybot agent health` | Report or query agent health status (API key or login) |
+| `dailybot agent webhook register` | Register a webhook for the agent (API key or login) |
+| `dailybot agent webhook unregister` | Unregister the agent's webhook (API key or login) |
+| `dailybot agent message send` | Send a message to an agent (API key or login) |
+| `dailybot agent message list` | List messages for an agent (API key or login) |
+
+Run `dailybot --help` for full details on any command.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+[MIT](LICENSE)

dailybot_cli-0.1.0/dailybot_cli/__init__.py

@@ -0,0 +1,3 @@
+"""DailyBot CLI - Submit check-in updates from your terminal."""
+
+__version__: str = "0.1.0"

dailybot_cli-0.1.0/dailybot_cli/api_client.py

@@ -0,0 +1,303 @@
+"""HTTP client for DailyBot CLI API endpoints."""
+
+from typing import Any, Optional
+
+import httpx
+
+from dailybot_cli.config import get_api_key, get_api_url, get_token
+
+
+class APIError(Exception):
+    """Raised when the API returns a non-success response."""
+
+    def __init__(self, status_code: int, detail: str) -> None:
+        self.status_code: int = status_code
+        self.detail: str = detail
+        super().__init__(f"API error {status_code}: {detail}")
+
+
+class DailyBotClient:
+    """HTTP client for the DailyBot /v1/cli/* API endpoints."""
+
+    def __init__(
+        self,
+        api_url: Optional[str] = None,
+        token: Optional[str] = None,
+        api_key: Optional[str] = None,
+        timeout: float = 30.0,
+    ) -> None:
+        self.api_url: str = (api_url or get_api_url()).rstrip("/")
+        self.token: Optional[str] = token or get_token()
+        self.api_key: Optional[str] = api_key or get_api_key()
+        self.timeout: float = timeout
+        self._agent_auth_mode: Optional[str] = None
+
+    def _headers(self, authenticated: bool = True) -> dict[str, str]:
+        """Build request headers."""
+        headers: dict[str, str] = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        }
+        if authenticated and self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+        return headers
+
+    def _agent_headers(self) -> dict[str, str]:
+        """Build headers for agent authentication (API key preferred, then Bearer)."""
+        headers: dict[str, str] = {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        }
+        if self.api_key:
+            headers["X-API-KEY"] = self.api_key
+            self._agent_auth_mode = "api_key"
+        elif self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+            self._agent_auth_mode = "bearer"
+        else:
+            self._agent_auth_mode = None
+        return headers
+
+    def _handle_response(self, response: httpx.Response) -> dict[str, Any]:
+        """Parse API response and raise on errors."""
+        if response.status_code >= 400:
+            try:
+                body: dict[str, Any] = response.json()
+                detail: str = body.get("detail", body.get("error", str(body)))
+            except Exception:
+                detail = response.text or f"HTTP {response.status_code}"
+            if response.status_code in (401, 403) and self._agent_auth_mode == "bearer":
+                detail = "Session expired. Run 'dailybot login' to re-authenticate."
+            raise APIError(status_code=response.status_code, detail=detail)
+        if response.status_code == 204:
+            return {}
+        return response.json()  # type: ignore[no-any-return]
+
+    # --- Auth endpoints ---
+
+    def request_code(self, email: str) -> dict[str, Any]:
+        """POST /v1/cli/auth/request-code/"""
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/cli/auth/request-code/",
+            json={"email": email},
+            headers=self._headers(authenticated=False),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def verify_code(
+        self,
+        email: str,
+        code: str,
+        organization_id: Optional[int] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/cli/auth/verify-code/"""
+        payload: dict[str, Any] = {"email": email, "code": code}
+        if organization_id is not None:
+            payload["organization_id"] = organization_id
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/cli/auth/verify-code/",
+            json=payload,
+            headers=self._headers(authenticated=False),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def auth_status(self) -> dict[str, Any]:
+        """GET /v1/cli/auth/status/"""
+        response: httpx.Response = httpx.get(
+            f"{self.api_url}/v1/cli/auth/status/",
+            headers=self._headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def logout(self) -> dict[str, Any]:
+        """POST /v1/cli/auth/logout/"""
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/cli/auth/logout/",
+            headers=self._headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    # --- Update/Status endpoints ---
+
+    def submit_update(
+        self,
+        message: Optional[str] = None,
+        done: Optional[str] = None,
+        doing: Optional[str] = None,
+        blocked: Optional[str] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/cli/updates/"""
+        payload: dict[str, str] = {}
+        if message:
+            payload["message"] = message
+        if done:
+            payload["done"] = done
+        if doing:
+            payload["doing"] = doing
+        if blocked:
+            payload["blocked"] = blocked
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/cli/updates/",
+            json=payload,
+            headers=self._headers(),
+            timeout=120.0,
+        )
+        return self._handle_response(response)
+
+    def get_status(self) -> dict[str, Any]:
+        """GET /v1/cli/status/"""
+        response: httpx.Response = httpx.get(
+            f"{self.api_url}/v1/cli/status/",
+            headers=self._headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    # --- Agent endpoints ---
+
+    def submit_agent_report(
+        self,
+        agent_name: str,
+        content: str,
+        structured: Optional[dict[str, Any]] = None,
+        metadata: Optional[dict[str, Any]] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/agent-reports/"""
+        payload: dict[str, Any] = {
+            "agent_name": agent_name,
+            "content": content,
+        }
+        if structured:
+            payload["structured"] = structured
+        if metadata:
+            payload["metadata"] = metadata
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/agent-reports/",
+            json=payload,
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def submit_agent_health(
+        self,
+        agent_name: str,
+        ok: bool,
+        message: Optional[str] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/agent-health/"""
+        payload: dict[str, Any] = {
+            "agent_name": agent_name,
+            "ok": ok,
+        }
+        if message:
+            payload["message"] = message
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/agent-health/",
+            json=payload,
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def get_agent_health(self, agent_name: str) -> dict[str, Any]:
+        """GET /v1/agent-health/?agent_name=..."""
+        response: httpx.Response = httpx.get(
+            f"{self.api_url}/v1/agent-health/",
+            params={"agent_name": agent_name},
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    # --- Agent webhook endpoints ---
+
+    def register_agent_webhook(
+        self,
+        agent_name: str,
+        webhook_url: str,
+        webhook_secret: Optional[str] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/agent-webhook/"""
+        payload: dict[str, Any] = {
+            "agent_name": agent_name,
+            "webhook_url": webhook_url,
+        }
+        if webhook_secret:
+            payload["webhook_secret"] = webhook_secret
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/agent-webhook/",
+            json=payload,
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def unregister_agent_webhook(self, agent_name: str) -> dict[str, Any]:
+        """DELETE /v1/agent-webhook/"""
+        response: httpx.Response = httpx.request(
+            "DELETE",
+            f"{self.api_url}/v1/agent-webhook/",
+            json={"agent_name": agent_name},
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    # --- Agent message endpoints ---
+
+    def send_agent_message(
+        self,
+        agent_name: str,
+        content: str,
+        message_type: Optional[str] = None,
+        metadata: Optional[dict[str, Any]] = None,
+        expires_at: Optional[str] = None,
+        sender_type: Optional[str] = None,
+        sender_name: Optional[str] = None,
+    ) -> dict[str, Any]:
+        """POST /v1/agent-messages/"""
+        payload: dict[str, Any] = {
+            "agent_name": agent_name,
+            "content": content,
+        }
+        if message_type:
+            payload["message_type"] = message_type
+        if metadata:
+            payload["metadata"] = metadata
+        if expires_at:
+            payload["expires_at"] = expires_at
+        if sender_type:
+            payload["sender_type"] = sender_type
+        if sender_name:
+            payload["sender_name"] = sender_name
+        response: httpx.Response = httpx.post(
+            f"{self.api_url}/v1/agent-messages/",
+            json=payload,
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        return self._handle_response(response)
+
+    def get_agent_messages(
+        self,
+        agent_name: str,
+        delivered: Optional[bool] = None,
+    ) -> list[dict[str, Any]]:
+        """GET /v1/agent-messages/?agent_name=..."""
+        params: dict[str, str] = {"agent_name": agent_name}
+        if delivered is not None:
+            params["delivered"] = "true" if delivered else "false"
+        response: httpx.Response = httpx.get(
+            f"{self.api_url}/v1/agent-messages/",
+            params=params,
+            headers=self._agent_headers(),
+            timeout=self.timeout,
+        )
+        if response.status_code >= 400:
+            self._handle_response(response)
+        return response.json()  # type: ignore[no-any-return]

dailybot_cli-0.1.0/dailybot_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""DailyBot CLI commands."""