commune-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{commune_cli-0.1.3 → commune_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commune-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Official CLI for the Commune email API — agent-native, pipe-friendly, covers every API surface.
 Project-URL: Homepage, https://commune.email
 Project-URL: Documentation, https://docs.commune.email

{commune_cli-0.1.3 → commune_cli-0.1.5}/commune_cli/__init__.py

@@ -1,3 +1,3 @@
 """Commune CLI — official command-line interface for the Commune email API."""
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"

{commune_cli-0.1.3 → commune_cli-0.1.5}/commune_cli/banner.py

@@ -47,7 +47,7 @@ _COMMANDS = [
     ("attachments", "upload · get · url"),
     ("dmarc",       "list · summary"),
     ("data",        "deletion-request · confirm"),
-    ("config",      "set · show · register · status · keys"),
+    ("config",      "set · show · register · status · keys list · keys revoke"),
 ]
 
 _TAGLINE = "email infrastructure for agents"

{commune_cli-0.1.3 → commune_cli-0.1.5}/commune_cli/commands/config_cmd.py

@@ -6,7 +6,6 @@ import base64
 import os
 import re
 import stat
-import time
 from pathlib import Path
 from typing import Optional
 
@@ -244,43 +243,6 @@ def config_register(
     agent_id: str = verify_data["agentId"]
     inbox_email: str = verify_data["inboxEmail"]
 
-    # 8. Create API key using agent signing
-    #    Authorization: Agent {agentId}:{base64_signature}
-    #    X-Commune-Timestamp: {timestampMs}
-    #    signature = Ed25519("{agentId}:{timestampMs}")
-    if not json_output:
-        print_status("[cyan]→[/cyan] Creating API key...")
-
-    api_key: Optional[str] = None
-    timestamp_ms = int(time.time() * 1000)
-    req_sig_msg = f"{agent_id}:{timestamp_ms}"
-    req_sig = base64.b64encode(private_key.sign(req_sig_msg.encode())).decode()
-
-    try:
-        r3 = httpx.post(
-            f"{base_url}/v1/agent/api-keys",
-            json={"name": f"{org_slug}-cli"},
-            headers={
-                "Authorization": f"Agent {agent_id}:{req_sig}",
-                "X-Commune-Timestamp": str(timestamp_ms),
-                "Content-Type": "application/json",
-            },
-            timeout=30.0,
-        )
-        if r3.is_success:
-            key_data = r3.json()
-            api_key = (
-                key_data.get("key")
-                or key_data.get("apiKey")
-                or key_data.get("api_key")
-            )
-    except Exception:
-        pass  # Non-fatal: agent is registered even if key creation fails
-
-    # 9. Persist to config
-    if api_key:
-        set_value("api_key", api_key)
-
     # Save private key + agent ID to ~/.commune/agent.key (owner-only permissions)
     agent_key_path = config_dir() / "agent.key"
     agent_key_path.write_text(
@@ -292,27 +254,21 @@ def config_register(
     except OSError:
         pass
 
-    # 10. Output
+    # Output
     if json_output:
         print_json({
             "agentId": agent_id,
             "inboxEmail": inbox_email,
-            "apiKey": api_key,
-            "configSaved": bool(api_key),
             "keyFile": str(agent_key_path),
         })
         return
 
     print_success(f"Agent registered:  [bold]{agent_id}[/bold]")
     print_success(f"Inbox ready:       [bold]{inbox_email}[/bold]")
-    if api_key:
-        print_success(f"API key saved to:  [bold]{config_path()}[/bold]")
-        print_success("Run [bold cyan]commune inboxes list[/bold cyan] to confirm everything is working.")
-    else:
-        print_warning(
-            "Could not auto-create API key. Create one at commune.email/dashboard, then run:\n"
-            "  commune config set api_key comm_..."
-        )
+    print_warning(
+        "Get your API key at commune.email/dashboard, then run:\n"
+        "  commune config set api_key comm_..."
+    )
     from rich.console import Console
     Console(stderr=True).print(f"\n[dim]Private key stored at: {agent_key_path}[/dim]")
 
@@ -409,45 +365,6 @@ def keys_list(
     )
 
 
-@keys_app.command("create")
-def keys_create(
-    ctx: typer.Context,
-    name: str = typer.Option(..., "--name", help="Descriptive name for this key (e.g. 'agent-prod')."),
-    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
-) -> None:
-    """Create a new API key. POST /v1/agent/api-keys.
-
-    The full key (comm_...) is only returned once — save it immediately.
-    """
-    from ..client import CommuneClient
-    from ..errors import api_error, auth_required_error, network_error
-    from ..state import AppState
-
-    state: AppState = ctx.obj or AppState()
-    if not state.has_any_auth():
-        auth_required_error(json_output=json_output or state.should_json())
-
-    client = CommuneClient.from_state(state)
-    try:
-        r = client.post("/v1/agent/api-keys", json={"name": name})
-    except Exception as exc:
-        network_error(exc, json_output=json_output or state.should_json())
-
-    if not r.is_success:
-        api_error(r, json_output=json_output or state.should_json())
-
-    data = r.json()
-    if json_output or state.should_json():
-        print_json(data)
-        return
-
-    key = data.get("key") or data.get("apiKey") or data.get("api_key", "")
-    key_id = data.get("id", "")
-    print_success(f"API key created: [bold]{key_id}[/bold]")
-    if key:
-        from rich.console import Console
-        Console(stderr=True).print(f"\n[bold yellow]Key (save this — shown once):[/bold yellow]\n  {key}\n")
-
 
 @keys_app.command("revoke")
 def keys_revoke(
@@ -488,40 +405,3 @@ def keys_revoke(
     print_success(f"API key [bold]{key_id}[/bold] revoked.")
 
 
-@keys_app.command("rotate")
-def keys_rotate(
-    ctx: typer.Context,
-    key_id: str = typer.Argument(..., help="API key ID to rotate."),
-    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
-) -> None:
-    """Rotate an API key — generates a new secret, invalidates the old one. POST /v1/agent/api-keys/{keyId}/rotate.
-
-    The new full key (comm_...) is returned once — save it immediately.
-    """
-    from ..client import CommuneClient
-    from ..errors import api_error, auth_required_error, network_error
-    from ..state import AppState
-
-    state: AppState = ctx.obj or AppState()
-    if not state.has_any_auth():
-        auth_required_error(json_output=json_output or state.should_json())
-
-    client = CommuneClient.from_state(state)
-    try:
-        r = client.post(f"/v1/agent/api-keys/{key_id}/rotate")
-    except Exception as exc:
-        network_error(exc, json_output=json_output or state.should_json())
-
-    if not r.is_success:
-        api_error(r, json_output=json_output or state.should_json())
-
-    data = r.json()
-    if json_output or state.should_json():
-        print_json(data)
-        return
-
-    key = data.get("key") or data.get("apiKey") or data.get("api_key", "")
-    print_success(f"API key [bold]{key_id}[/bold] rotated.")
-    if key:
-        from rich.console import Console
-        Console(stderr=True).print(f"\n[bold yellow]New key (save this — shown once):[/bold yellow]\n  {key}\n")

commune_cli-0.1.5/commune_cli/commands/credits.py

@@ -0,0 +1,66 @@
+"""commune credits — credit balance and bundle management."""
+
+from __future__ import annotations
+
+import typer
+
+from ..client import CommuneClient
+from ..errors import api_error, auth_required_error, network_error
+from ..output import print_list, print_record
+from ..state import AppState
+
+app = typer.Typer(help="Credit balance and available bundles.", no_args_is_help=True)
+
+
+@app.command("balance")
+def credits_balance(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Get current credit balance. GET /v1/credits."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/credits")
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_record(r.json(), json_output=json_output or state.should_json(), title="Credit Balance")
+
+
+@app.command("bundles")
+def credits_bundles(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """List available credit bundles. GET /v1/credits/bundles."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/credits/bundles")
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_list(
+        r.json(),
+        json_output=json_output or state.should_json(),
+        title="Credit Bundles",
+        columns=[
+            ("ID", "id"),
+            ("Credits", "credits"),
+            ("Price", "price"),
+            ("Description", "description"),
+        ],
+    )

commune_cli-0.1.5/commune_cli/commands/phone_numbers.py

@@ -0,0 +1,92 @@
+"""commune phone-numbers — phone number management."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import typer
+
+from ..client import CommuneClient
+from ..errors import api_error, auth_required_error, network_error
+from ..output import print_list, print_record
+from ..state import AppState
+
+app = typer.Typer(help="Phone number management: list, get, settings.", no_args_is_help=True)
+
+
+@app.command("list")
+def phone_numbers_list(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """List all phone numbers in your organization. GET /v1/phone-numbers."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/phone-numbers")
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_list(
+        r.json(),
+        json_output=json_output or state.should_json(),
+        title="Phone Numbers",
+        columns=[
+            ("ID", "id"),
+            ("Number", "phoneNumber"),
+            ("Friendly Name", "friendlyName"),
+            ("Status", "status"),
+            ("Created", "createdAt"),
+        ],
+    )
+
+
+@app.command("get")
+def phone_numbers_get(
+    ctx: typer.Context,
+    phone_number_id: str = typer.Argument(..., help="Phone number ID."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Get a specific phone number. GET /v1/phone-numbers/{phoneNumberId}."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get(f"/v1/phone-numbers/{phone_number_id}")
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_record(r.json(), json_output=json_output or state.should_json(), title="Phone Number")
+
+
+@app.command("settings")
+def phone_numbers_settings(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Get SMS quota settings for your organization. GET /v1/phone-settings."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/phone-settings")
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_record(r.json(), json_output=json_output or state.should_json(), title="SMS Settings")

commune_cli-0.1.5/commune_cli/commands/sms.py

@@ -0,0 +1,187 @@
+"""commune sms — send SMS and manage conversations."""
+
+from __future__ import annotations
+
+from typing import Optional
+from urllib.parse import quote
+
+import typer
+
+from ..client import CommuneClient
+from ..errors import api_error, auth_required_error, network_error, validation_error
+from ..output import print_json, print_list, print_record, print_success
+from ..state import AppState
+
+app = typer.Typer(help="Send SMS and manage conversations.", no_args_is_help=True)
+
+
+@app.command("send")
+def sms_send(
+    ctx: typer.Context,
+    to: str = typer.Option(..., "--to", help="Recipient phone number in E.164 format (e.g. +1234567890)."),
+    body: str = typer.Option(..., "--body", help="SMS message body."),
+    phone_number_id: Optional[str] = typer.Option(
+        None,
+        "--phone-number-id",
+        help="Phone number ID to send from. Uses org default if omitted.",
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Send an SMS message. POST /v1/sms/send."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    payload: dict = {"to": to, "body": body}
+    if phone_number_id:
+        payload["phone_number_id"] = phone_number_id
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.post("/v1/sms/send", json=payload)
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    data = r.json()
+    if json_output or state.should_json():
+        print_json(data)
+        return
+
+    msg_id = data.get("id") or data.get("messageId", "")
+    print_success(f"SMS sent. ID: [bold]{msg_id}[/bold]")
+
+
+@app.command("conversations")
+def sms_conversations(
+    ctx: typer.Context,
+    phone_number_id: Optional[str] = typer.Option(
+        None,
+        "--phone-number-id",
+        help="Filter by phone number ID.",
+    ),
+    limit: Optional[int] = typer.Option(20, "--limit", help="Maximum results to return."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """List SMS conversations. GET /v1/sms/conversations."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/sms/conversations", params={
+            "phone_number_id": phone_number_id,
+            "limit": limit,
+        })
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_list(
+        r.json(),
+        json_output=json_output or state.should_json(),
+        title="SMS Conversations",
+        columns=[
+            ("Remote Number", "remoteNumber"),
+            ("Last Message", "lastMessage"),
+            ("Direction", "lastDirection"),
+            ("Updated", "updatedAt"),
+        ],
+    )
+
+
+@app.command("thread")
+def sms_thread(
+    ctx: typer.Context,
+    remote_number: str = typer.Argument(..., help="Remote phone number (E.164, e.g. +1234567890)."),
+    phone_number_id: str = typer.Option(
+        ...,
+        "--phone-number-id",
+        help="Phone number ID for the conversation.",
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Get the message thread with a specific number. GET /v1/sms/conversations/{remoteNumber}."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    encoded = quote(remote_number, safe="")
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get(
+            f"/v1/sms/conversations/{encoded}",
+            params={"phone_number_id": phone_number_id},
+        )
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    data = r.json()
+    if json_output or state.should_json():
+        print_json(data)
+        return
+
+    messages = data if isinstance(data, list) else data.get("data", data)
+    print_list(
+        messages,
+        json_output=False,
+        title=f"Thread with {remote_number}",
+        columns=[
+            ("ID", "id"),
+            ("Direction", "direction"),
+            ("Body", "body"),
+            ("Sent At", "createdAt"),
+        ],
+    )
+
+
+@app.command("search")
+def sms_search(
+    ctx: typer.Context,
+    query: str = typer.Argument(..., help="Search query."),
+    phone_number_id: Optional[str] = typer.Option(
+        None,
+        "--phone-number-id",
+        help="Scope search to a specific phone number.",
+    ),
+    limit: Optional[int] = typer.Option(20, "--limit", help="Maximum results to return."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Search SMS messages. GET /v1/sms/search."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.get("/v1/sms/search", params={
+            "q": query,
+            "phone_number_id": phone_number_id,
+            "limit": limit,
+        })
+    except Exception as exc:
+        network_error(exc, json_output=json_output or state.should_json())
+
+    if not r.is_success:
+        api_error(r, json_output=json_output or state.should_json())
+
+    print_list(
+        r.json(),
+        json_output=json_output or state.should_json(),
+        title=f"SMS Search: {query}",
+        columns=[
+            ("ID", "id"),
+            ("From", "from"),
+            ("To", "to"),
+            ("Body", "body"),
+            ("Date", "createdAt"),
+        ],
+    )

{commune_cli-0.1.3 → commune_cli-0.1.5}/commune_cli/main.py

@@ -24,6 +24,9 @@ from .commands import (
     webhooks,
     dmarc,
     data,
+    phone_numbers,
+    sms,
+    credits,
 )
 
 app = typer.Typer(
@@ -49,6 +52,9 @@ app.add_typer(delivery.app,    name="delivery",     help="Delivery metrics, even
 app.add_typer(webhooks.app,    name="webhooks",     help="Webhook delivery log: list, retry, health.")
 app.add_typer(dmarc.app,       name="dmarc",        help="DMARC reports and summary.")
 app.add_typer(data.app,        name="data",         help="Data deletion requests (GDPR / destructive).")
+app.add_typer(phone_numbers.app, name="phone-numbers", help="Phone number management: list, get, settings.")
+app.add_typer(sms.app,           name="sms",           help="Send SMS and manage conversations.")
+app.add_typer(credits.app,       name="credits",       help="Credit balance and available bundles.")
 
 
 @app.callback(invoke_without_command=True)

{commune_cli-0.1.3 → commune_cli-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "commune-cli"
-version = "0.1.3"
+version = "0.1.5"
 description = "Official CLI for the Commune email API — agent-native, pipe-friendly, covers every API surface."
 readme = "README.md"
 requires-python = ">=3.9"