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

{commune_cli-0.1.5 → commune_cli-0.1.8}/.gitignore

@@ -79,4 +79,11 @@ build/
 .mypy_cache/
 .ruff_cache/
 *.egg-info/
-pip-wheel-metadata/
+pip-wheel-metadata/
+
+# Large model/binary files (GitHub 100MB limit)
+launch-video/whisper.cpp/
+launch-video/documents/
+
+# OpenNext build output
+frontend/.open-next/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commune-cli
-Version: 0.1.5
+Version: 0.1.8
 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.5 → commune_cli-0.1.8}/commune_cli/commands/credits.py

@@ -6,7 +6,7 @@ import typer
 
 from ..client import CommuneClient
 from ..errors import api_error, auth_required_error, network_error
-from ..output import print_list, print_record
+from ..output import print_list, print_record, print_success
 from ..state import AppState
 
 app = typer.Typer(help="Credit balance and available bundles.", no_args_is_help=True)
@@ -64,3 +64,41 @@ def credits_bundles(
             ("Description", "description"),
         ],
     )
+
+
+@app.command("checkout")
+def credits_checkout(
+    ctx: typer.Context,
+    bundle: str = typer.Argument(..., help="Bundle to purchase: starter, growth, or scale."),
+    return_url: str = typer.Option(None, "--return-url", help="URL to redirect to after payment (optional)."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Create a Stripe checkout session to purchase credits. POST /v1/credits/checkout."""
+    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 = {"bundle": bundle}
+    if return_url:
+        payload["return_url"] = return_url
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.post("/v1/credits/checkout", 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():
+        from ..output import print_json
+        print_json(data)
+        return
+
+    checkout_url = data.get("checkout_url") or data.get("checkoutUrl", "")
+    credits = data.get("credits", "")
+    price = data.get("price", "")
+    print_success(f"Checkout session created for [bold]{bundle}[/bold] bundle ({credits} credits, ${price}).")
+    typer.echo(f"\nOpen this URL in your browser to complete payment:\n{checkout_url}")

commune_cli-0.1.8/commune_cli/commands/phone_numbers.py

@@ -0,0 +1,297 @@
+"""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, print_success
+from ..state import AppState
+
+app = typer.Typer(help="Phone number management: list, get, provision, release, 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("available")
+def phone_numbers_available(
+    ctx: typer.Context,
+    type: Optional[str] = typer.Option("TollFree", "--type", help="Number type: TollFree or Local."),
+    country: Optional[str] = typer.Option("US", "--country", help="Two-letter country code."),
+    limit: Optional[int] = typer.Option(20, "--limit", help="Maximum results to return."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """List available phone numbers to purchase. GET /v1/phone-numbers/available."""
+    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/available", params={
+            "type": type,
+            "country": country,
+            "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="Available Phone Numbers",
+        columns=[
+            ("Number", "phoneNumber"),
+            ("Friendly Name", "friendlyName"),
+            ("Region", "region"),
+            ("Locality", "locality"),
+        ],
+    )
+
+
+@app.command("provision")
+def phone_numbers_provision(
+    ctx: typer.Context,
+    phone_number: Optional[str] = typer.Option(None, "--phone-number", help="Specific E.164 number to buy (e.g. +18005551234). Auto-selected if omitted."),
+    type: Optional[str] = typer.Option("tollfree", "--type", help="Number type: tollfree or local."),
+    country: Optional[str] = typer.Option("US", "--country", help="Two-letter country code."),
+    friendly_name: Optional[str] = typer.Option(None, "--friendly-name", help="Human-readable label for this number."),
+    area_code: Optional[str] = typer.Option(None, "--area-code", help="Preferred area code (local numbers only)."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Purchase/provision a phone number for SMS. POST /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())
+
+    payload: dict = {"type": type, "country": country}
+    if phone_number:
+        payload["phone_number"] = phone_number
+    if friendly_name:
+        payload["friendly_name"] = friendly_name
+    if area_code:
+        payload["area_code"] = area_code
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.post("/v1/phone-numbers", 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())
+
+    print_record(r.json(), json_output=json_output or state.should_json(), title="Provisioned Phone Number")
+
+
+@app.command("release")
+def phone_numbers_release(
+    ctx: typer.Context,
+    phone_number_id: str = typer.Argument(..., help="Phone number ID to release."),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Release a provisioned phone number. DELETE /v1/phone-numbers/{id}."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    if not yes:
+        typer.confirm(
+            f"Are you sure you want to release phone number {phone_number_id}? This cannot be undone.",
+            abort=True,
+        )
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.delete(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())
+
+    if json_output or state.should_json():
+        from ..output import print_json
+        print_json(r.json())
+        return
+
+    print_success(f"Phone number [bold]{phone_number_id}[/bold] released.")
+
+
+@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")
+
+
+@app.command("update")
+def phone_numbers_update(
+    ctx: typer.Context,
+    phone_number_id: str = typer.Argument(..., help="Phone number ID to update."),
+    friendly_name: Optional[str] = typer.Option(None, "--friendly-name", help="Human-readable label for this number."),
+    auto_reply: Optional[str] = typer.Option(None, "--auto-reply", help="Auto-reply message body (empty string to disable)."),
+    auto_reply_enabled: Optional[bool] = typer.Option(None, "--auto-reply-enabled/--no-auto-reply-enabled", help="Enable or disable auto-reply."),
+    webhook_endpoint: Optional[str] = typer.Option(None, "--webhook-endpoint", help="HTTPS URL to receive SMS event webhooks."),
+    webhook_secret: Optional[str] = typer.Option(None, "--webhook-secret", help="Webhook signing secret."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Update a phone number's settings. PATCH /v1/phone-numbers/{id}."""
+    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 = {}
+    if friendly_name is not None:
+        payload["friendly_name"] = friendly_name
+    if auto_reply is not None or auto_reply_enabled is not None:
+        auto_reply_obj: dict = {}
+        if auto_reply_enabled is not None:
+            auto_reply_obj["enabled"] = auto_reply_enabled
+        if auto_reply is not None:
+            auto_reply_obj["body"] = auto_reply
+        payload["auto_reply"] = auto_reply_obj
+    if webhook_endpoint is not None:
+        webhook: dict = {"endpoint": webhook_endpoint}
+        if webhook_secret is not None:
+            webhook["secret"] = webhook_secret
+        payload["webhook"] = webhook
+
+    if not payload:
+        from ..errors import validation_error
+        validation_error("No fields to update. Provide at least one option.", json_output=json_output or state.should_json())
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.patch(f"/v1/phone-numbers/{phone_number_id}", 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())
+
+    print_record(r.json(), json_output=json_output or state.should_json(), title="Updated Phone Number")
+
+
+@app.command("set-allow-list")
+def phone_numbers_set_allow_list(
+    ctx: typer.Context,
+    phone_number_id: str = typer.Argument(..., help="Phone number ID."),
+    numbers: list[str] = typer.Option(..., "--number", help="E.164 number to allow (repeat for multiple, e.g. --number +15551234567 --number +15559876543). Pass no --number flags to clear."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Set allow list for a phone number (only listed numbers can message it). PUT /v1/phone-numbers/{id}/allow-list."""
+    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.put(f"/v1/phone-numbers/{phone_number_id}/allow-list", json={"numbers": 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_record(r.json(), json_output=json_output or state.should_json(), title="Updated Phone Number")
+
+
+@app.command("set-block-list")
+def phone_numbers_set_block_list(
+    ctx: typer.Context,
+    phone_number_id: str = typer.Argument(..., help="Phone number ID."),
+    numbers: list[str] = typer.Option(..., "--number", help="E.164 number to block (repeat for multiple). Pass no --number flags to clear."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Set block list for a phone number (listed numbers are rejected). PUT /v1/phone-numbers/{id}/block-list."""
+    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.put(f"/v1/phone-numbers/{phone_number_id}/block-list", json={"numbers": 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_record(r.json(), json_output=json_output or state.should_json(), title="Updated Phone Number")

commune_cli-0.1.8/commune_cli/commands/sms.py

@@ -0,0 +1,354 @@
+"""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"),
+        ],
+    )
+
+
+@app.command("suppressions")
+def sms_suppressions(
+    ctx: typer.Context,
+    phone_number_id: Optional[str] = typer.Option(
+        None,
+        "--phone-number-id",
+        help="Filter by phone number ID.",
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """List SMS suppressed numbers (opted out via STOP). GET /v1/sms/suppressions."""
+    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/suppressions", 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())
+
+    print_list(
+        r.json(),
+        json_output=json_output or state.should_json(),
+        title="SMS Suppressions",
+        columns=[
+            ("Phone Number", "phone_number"),
+            ("Reason", "reason"),
+            ("Created", "created_at"),
+        ],
+    )
+
+
+@app.command("remove-suppression")
+def sms_remove_suppression(
+    ctx: typer.Context,
+    phone_number: str = typer.Argument(..., help="E.164 phone number to remove from suppression list (e.g. +15551234567)."),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Remove a number from the SMS suppression list. DELETE /v1/sms/suppressions/{phoneNumber}."""
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    from urllib.parse import quote
+    encoded = quote(phone_number, safe="")
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.delete(f"/v1/sms/suppressions/{encoded}")
+    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())
+
+    if json_output or state.should_json():
+        from ..output import print_json
+        print_json(r.json())
+        return
+
+    print_success(f"[bold]{phone_number}[/bold] removed from suppression list.")
+
+
+@app.command("listen")
+def sms_listen(
+    ctx: typer.Context,
+    phone_number_id: Optional[str] = typer.Option(
+        None,
+        "--phone-number-id",
+        help="Listen for events on a specific phone number. Omit to listen on all.",
+    ),
+    events: Optional[str] = typer.Option(
+        None,
+        "--events",
+        help="Comma-separated event types to filter: sms.received,sms.sent,sms.status_updated (default: all SMS events).",
+    ),
+) -> None:
+    """Stream SMS events in real time (like az logs). Ctrl+C to stop."""
+    import sys
+    import time
+    from rich.console import Console
+    from rich.text import Text
+
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=False)
+
+    console = Console()
+
+    base_url = state.base_url or "https://api.commune.email"
+    api_key = state.api_key or state.session_token or ""
+
+    params: list[tuple[str, str]] = []
+    if phone_number_id:
+        params.append(("phone_number_id", phone_number_id))
+    if events:
+        params.append(("events", events))
+    else:
+        params.append(("events", "sms.received,sms.sent,sms.status_updated"))
+
+    import httpx
+    from urllib.parse import urlencode
+
+    qs = urlencode(params)
+    url = f"{base_url.rstrip('/')}/v1/events/stream?{qs}"
+
+    label = f"phone number [bold]{phone_number_id}[/bold]" if phone_number_id else "all phone numbers"
+    console.print(f"\n[dim]Listening for SMS events on {label}... (Ctrl+C to stop)[/dim]\n")
+
+    try:
+        with httpx.Client(timeout=None) as client:
+            with client.stream(
+                "GET",
+                url,
+                headers={"Authorization": f"Bearer {api_key}", "Accept": "text/event-stream"},
+            ) as response:
+                if response.status_code != 200:
+                    console.print(f"[red]Error {response.status_code}:[/red] {response.text}")
+                    raise SystemExit(1)
+
+                event_type = None
+                for line in response.iter_lines():
+                    if line.startswith("event:"):
+                        event_type = line[6:].strip()
+                    elif line.startswith("data:"):
+                        raw = line[5:].strip()
+                        if raw == "[DONE]" or raw == "":
+                            continue
+                        try:
+                            import json as _json
+                            data = _json.loads(raw)
+                        except Exception:
+                            continue
+
+                        ts = data.get("created_at", time.strftime("%H:%M:%S"))
+                        if len(ts) > 8:
+                            ts = ts[11:19] if "T" in ts else ts[:8]
+
+                        ev = event_type or data.get("type", "event")
+                        from_num = data.get("from_number", data.get("from", ""))
+                        to_num = data.get("to_number", data.get("to", ""))
+                        body = data.get("content", data.get("body", ""))
+                        status = data.get("delivery_status", "")
+
+                        color = "green" if ev == "sms.received" else "blue" if ev == "sms.sent" else "yellow"
+                        direction = f"[dim]{from_num}[/dim] → [dim]{to_num}[/dim]" if from_num and to_num else ""
+                        status_str = f" · [dim]{status}[/dim]" if status else ""
+
+                        console.print(
+                            f"[[dim]{ts}[/dim]] [{color}]{ev:<20}[/{color}] {direction}{status_str}"
+                        )
+                        if body:
+                            preview = body[:100] + ("…" if len(body) > 100 else "")
+                            console.print(f"           [dim]\"{preview}\"[/dim]")
+                    elif line == "":
+                        event_type = None
+
+    except KeyboardInterrupt:
+        console.print("\n[dim]Stopped.[/dim]")
+    except Exception as exc:
+        console.print(f"[red]Connection error:[/red] {exc}")
+        raise SystemExit(1)

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

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

commune_cli-0.1.5/commune_cli/commands/phone_numbers.py

@@ -1,92 +0,0 @@
-"""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

@@ -1,187 +0,0 @@
-"""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"),
-        ],
-    )