cueapi 0.1.0__tar.gz

cueapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vector Apps Inc.
+
+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.

cueapi-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: cueapi
+Version: 0.1.0
+Summary: CLI for CueAPI — Your Agents' Cue to Act. The scheduling API for AI agents.
+Author-email: "Vector Apps Inc." <hello@cueapi.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://cueapi.ai
+Project-URL: Repository, https://github.com/govindkavaturi-art/cueapi-cli
+Keywords: cueapi,ai-agents,scheduling,webhook,cron,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: httpx>=0.27
+Dynamic: license-file
+
+# CueAPI CLI
+
+The official command-line interface for [CueAPI](https://cueapi.ai) — Your Agents' Cue to Act.
+
+CueAPI is a scheduling API for AI agents. Agents register cues (scheduled tasks), CueAPI fires webhooks at the right time. No cron jobs. No infrastructure.
+
+## Install
+
+```bash
+pip install cueapi
+```
+
+## Quick Start
+
+```bash
+cueapi login
+cueapi quickstart
+cueapi create --name "morning-check" --cron "0 9 * * *" --url https://my-agent.com/webhook
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `cueapi login` | Authenticate and store API key |
+| `cueapi whoami` | Show current user and plan |
+| `cueapi logout` | Remove local credentials |
+| `cueapi quickstart` | Guided first-cue setup |
+| `cueapi create` | Create a new cue |
+| `cueapi list` | List all cues |
+| `cueapi get <id>` | Get cue details |
+| `cueapi pause <id>` | Pause a cue |
+| `cueapi resume <id>` | Resume a cue |
+| `cueapi delete <id>` | Delete a cue |
+| `cueapi upgrade` | Open billing |
+| `cueapi usage` | Show current usage |
+| `cueapi key regenerate` | Regenerate API key |
+
+## Auth
+
+Credentials stored in `~/.config/cueapi/credentials.json`.
+
+Override: `export CUEAPI_API_KEY=cue_sk_your_key` or `--api-key` flag.
+
+## Links
+
+- [Website](https://cueapi.ai)
+- [API Reference](https://cueapi.ai/api)
+- [Pricing](https://cueapi.ai/pricing)
+
+## License
+
+MIT — Built by [Vector Apps Inc.](https://vectorapps.com)

cueapi-0.1.0/README.md

@@ -0,0 +1,53 @@
+# CueAPI CLI
+
+The official command-line interface for [CueAPI](https://cueapi.ai) — Your Agents' Cue to Act.
+
+CueAPI is a scheduling API for AI agents. Agents register cues (scheduled tasks), CueAPI fires webhooks at the right time. No cron jobs. No infrastructure.
+
+## Install
+
+```bash
+pip install cueapi
+```
+
+## Quick Start
+
+```bash
+cueapi login
+cueapi quickstart
+cueapi create --name "morning-check" --cron "0 9 * * *" --url https://my-agent.com/webhook
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `cueapi login` | Authenticate and store API key |
+| `cueapi whoami` | Show current user and plan |
+| `cueapi logout` | Remove local credentials |
+| `cueapi quickstart` | Guided first-cue setup |
+| `cueapi create` | Create a new cue |
+| `cueapi list` | List all cues |
+| `cueapi get <id>` | Get cue details |
+| `cueapi pause <id>` | Pause a cue |
+| `cueapi resume <id>` | Resume a cue |
+| `cueapi delete <id>` | Delete a cue |
+| `cueapi upgrade` | Open billing |
+| `cueapi usage` | Show current usage |
+| `cueapi key regenerate` | Regenerate API key |
+
+## Auth
+
+Credentials stored in `~/.config/cueapi/credentials.json`.
+
+Override: `export CUEAPI_API_KEY=cue_sk_your_key` or `--api-key` flag.
+
+## Links
+
+- [Website](https://cueapi.ai)
+- [API Reference](https://cueapi.ai/api)
+- [Pricing](https://cueapi.ai/pricing)
+
+## License
+
+MIT — Built by [Vector Apps Inc.](https://vectorapps.com)

cueapi-0.1.0/cueapi/__init__.py

@@ -0,0 +1,3 @@
+"""CueAPI CLI — Your Agents' Cue to Act."""
+
+__version__ = "0.1.0"

cueapi-0.1.0/cueapi/auth.py

@@ -0,0 +1,185 @@
+"""Auth commands: login, logout, whoami, key regenerate."""
+from __future__ import annotations
+
+import secrets
+import string
+import time
+import webbrowser
+from typing import Optional
+
+import click
+
+from cueapi.client import CueAPIClient, UnauthClient
+from cueapi.credentials import (
+    get_profile_info,
+    remove_all_credentials,
+    remove_credentials,
+    resolve_api_base,
+    save_credentials,
+)
+from cueapi.formatting import echo_error, echo_info, echo_success
+
+
+def _generate_device_code() -> str:
+    """Generate a random device code like ABCD-EFGH."""
+    chars = string.ascii_uppercase + string.digits
+    part1 = "".join(secrets.choice(chars) for _ in range(4))
+    part2 = "".join(secrets.choice(chars) for _ in range(4))
+    return f"{part1}-{part2}"
+
+
+def do_login(api_base: Optional[str] = None, profile: str = "default") -> None:
+    """Run the device code login flow."""
+    base = api_base or resolve_api_base(profile=profile)
+    device_code = _generate_device_code()
+
+    with UnauthClient(api_base=base) as client:
+        # Step 1: Create device code
+        resp = client.post("/auth/device-code", json={"device_code": device_code})
+        if resp.status_code != 201:
+            error = resp.json().get("detail", {}).get("error", {})
+            echo_error(error.get("message", f"Failed to create device code (HTTP {resp.status_code})"))
+            return
+
+        data = resp.json()
+        verification_url = data["verification_url"]
+        expires_in = data["expires_in"]
+
+        # Step 2: Open browser
+        click.echo("\nOpening browser to authenticate...")
+        try:
+            webbrowser.open(verification_url)
+        except Exception:
+            pass
+        click.echo(f"If browser doesn't open, visit: {verification_url}\n")
+
+        # Step 3: Poll
+        click.echo("Waiting for authentication...", nl=False)
+        deadline = time.time() + expires_in
+        while time.time() < deadline:
+            time.sleep(2)
+            click.echo(".", nl=False)
+
+            resp = client.post("/auth/device-code/poll", json={"device_code": device_code})
+            if resp.status_code != 200:
+                continue
+
+            poll_data = resp.json()
+            status = poll_data.get("status")
+
+            if status == "approved":
+                api_key = poll_data["api_key"]
+                email = poll_data["email"]
+
+                # Save credentials
+                save_credentials(
+                    profile=profile,
+                    data={
+                        "api_key": api_key,
+                        "email": email,
+                        "api_base": base,
+                    },
+                )
+
+                click.echo()
+                echo_success(f"Authenticated as {email}")
+                click.echo(f"API key stored in credentials file.\n")
+                click.echo(f"Your API key: {api_key}")
+                click.echo("(This is the only time your full key will be shown. Save it if you need it elsewhere.)\n")
+                click.echo('Run `cueapi quickstart` to create your first cue.')
+                return
+
+            if status == "expired":
+                click.echo()
+                echo_error("Device code expired. Run `cueapi login` to try again.")
+                return
+
+        click.echo()
+        echo_error("Login timed out. Run `cueapi login` to try again.")
+
+
+def do_whoami(
+    api_key: Optional[str] = None,
+    profile: Optional[str] = None,
+) -> None:
+    """Show current user info."""
+    profile_name = profile or "default"
+    try:
+        with CueAPIClient(api_key=api_key, profile=profile) as client:
+            resp = client.get("/auth/me")
+            if resp.status_code != 200:
+                echo_error(f"Failed to get user info (HTTP {resp.status_code})")
+                return
+
+            data = resp.json()
+
+            # Get local key prefix
+            prof_info = get_profile_info(profile=profile)
+            key_display = "***"
+            if prof_info and "api_key" in prof_info:
+                key_display = prof_info["api_key"][:7] + "..." + prof_info["api_key"][-4:]
+
+            click.echo()
+            echo_info("Email:", data["email"])
+            echo_info("Plan:", data["plan"].capitalize())
+            echo_info("Active cues:", f"{data['active_cues']} / {data['active_cue_limit']}")
+            echo_info("Executions:", f"{data['executions_this_month']} / {data['monthly_execution_limit']} this month")
+            echo_info("API key:", key_display)
+            echo_info("Profile:", profile_name)
+            echo_info("API base:", client.api_base)
+            click.echo()
+    except click.ClickException:
+        click.echo("Not logged in. Run `cueapi login` to authenticate.")
+
+
+def do_logout(profile: str = "default", logout_all: bool = False) -> None:
+    """Remove credentials."""
+    if logout_all:
+        remove_all_credentials()
+        click.echo("Removed all credentials.")
+        return
+
+    email = remove_credentials(profile=profile)
+    if email:
+        click.echo(f"Removed credentials for {email} ({profile} profile).")
+    else:
+        click.echo(f"No credentials found for profile '{profile}'.")
+
+
+def do_key_regenerate(
+    api_key: Optional[str] = None,
+    profile: Optional[str] = None,
+    skip_confirm: bool = False,
+) -> None:
+    """Regenerate API key."""
+    if not skip_confirm:
+        click.echo()
+        click.echo(click.style("Warning: ", fg="yellow") + "This will instantly revoke your current API key.")
+        click.echo("  All agents using the old key will stop working.\n")
+        if not click.confirm("Proceed?"):
+            click.echo("Cancelled.")
+            return
+
+    try:
+        with CueAPIClient(api_key=api_key, profile=profile) as client:
+            resp = client.post("/auth/key/regenerate")
+            if resp.status_code != 200:
+                echo_error(f"Failed to regenerate key (HTTP {resp.status_code})")
+                return
+
+            data = resp.json()
+            new_key = data["api_key"]
+
+            # Update local credentials
+            profile_name = profile or "default"
+            prof_info = get_profile_info(profile=profile)
+            if prof_info:
+                prof_info["api_key"] = new_key
+                save_credentials(profile=profile_name, data=prof_info)
+
+            click.echo()
+            click.echo(f"New API key: {new_key}")
+            click.echo("(This is the only time this key will be shown.)\n")
+            click.echo("Local credentials updated.")
+    except click.ClickException as e:
+        click.echo(str(e))