commune-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{commune_cli-0.2.0 → commune_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commune-cli
-Version: 0.2.0
+Version: 0.2.2
 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
@@ -249,12 +249,23 @@ Full API reference: https://docs.commune.email
 
 | Package | Description |
 |---------|-------------|
-| [commune](https://github.com/shanjai-raj/commune) | Email & SMS infrastructure — self-hostable backend |
+| [commune](https://github.com/shanjai-raj/commune) | Email infrastructure — self-hostable backend |
 | [commune-ai](https://github.com/shanjai-raj/commune-ai) | TypeScript/Node.js SDK |
 | [commune-python](https://github.com/shanjai-raj/commune-python) | Python SDK |
 | [commune-mcp](https://github.com/shanjai-raj/commune-mcp) | MCP server for Claude Desktop, Cursor, Windsurf |
 | **[commune-cli](https://github.com/shanjai-raj/commune-cli)** | **Command-line interface** |
 
+## Guides
+
+- [LangChain agent with email](https://commune.email/blog/email-for-langchain-agents)
+- [CrewAI email agent](https://commune.email/blog/crewai-email-agent)
+- [AutoGen email agent](https://commune.email/blog/autogen-email-agent)
+- [Inbound email API](https://commune.email/inbound-email-api)
+- [SendGrid alternative for AI agents](https://commune.email/sendgrid-alternative)
+- [Mailgun alternative for AI agents](https://commune.email/mailgun-alternative)
+
+---
+
 ## License
 
 Apache-2.0

{commune_cli-0.2.0 → commune_cli-0.2.2}/README.md

@@ -219,12 +219,23 @@ Full API reference: https://docs.commune.email
 
 | Package | Description |
 |---------|-------------|
-| [commune](https://github.com/shanjai-raj/commune) | Email & SMS infrastructure — self-hostable backend |
+| [commune](https://github.com/shanjai-raj/commune) | Email infrastructure — self-hostable backend |
 | [commune-ai](https://github.com/shanjai-raj/commune-ai) | TypeScript/Node.js SDK |
 | [commune-python](https://github.com/shanjai-raj/commune-python) | Python SDK |
 | [commune-mcp](https://github.com/shanjai-raj/commune-mcp) | MCP server for Claude Desktop, Cursor, Windsurf |
 | **[commune-cli](https://github.com/shanjai-raj/commune-cli)** | **Command-line interface** |
 
+## Guides
+
+- [LangChain agent with email](https://commune.email/blog/email-for-langchain-agents)
+- [CrewAI email agent](https://commune.email/blog/crewai-email-agent)
+- [AutoGen email agent](https://commune.email/blog/autogen-email-agent)
+- [Inbound email API](https://commune.email/inbound-email-api)
+- [SendGrid alternative for AI agents](https://commune.email/sendgrid-alternative)
+- [Mailgun alternative for AI agents](https://commune.email/mailgun-alternative)
+
+---
+
 ## License
 
 Apache-2.0

{commune_cli-0.2.0 → commune_cli-0.2.2}/commune_cli/__init__.py

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

{commune_cli-0.2.0 → commune_cli-0.2.2}/commune_cli/commands/describe.py

@@ -37,6 +37,7 @@ _GROUPS: dict[str, str] = {
     "dmarc":         "DMARC reports and compliance summary",
     "data":          "Data deletion requests (GDPR)",
     "config":        "CLI config, agent registration, API keys",
+    "feedback":      "Submit feedback: errors, feature requests, and signals",
 }
 
 
@@ -133,6 +134,7 @@ _GROUP_TYPES: dict[str, list[str]] = {
     "dmarc":         [],
     "data":          [],
     "config":        [],
+    "feedback":      [],
 }
 
 
@@ -533,7 +535,7 @@ _COMMANDS: dict[str, dict] = {
     },
     "sms.thread": {
         "description": "Get all messages in an SMS thread",
-        "method": "GET /v1/sms/threads/{remote_number}",
+        "method": "GET /v1/sms/conversations/{remote_number}",
         "parameters": {
             "remote_number": {"type": "string (E.164)", "required": True},
             "--phone-number-id": {"type": "string", "required": True},
@@ -580,6 +582,26 @@ _COMMANDS: dict[str, dict] = {
         },
         "returns": "{ id, status }",
     },
+    # ── Feedback ─────────────────────────────────────────────────────
+    "feedback.submit": {
+        "description": "Submit feedback to the Commune product team. Use for errors, feature requests, or signals (observations/impressions).",
+        "method": "POST /v1/feedback",
+        "parameters": {
+            "--type": {
+                "type": "string",
+                "required": True,
+                "enum": ["error", "feature", "signal"],
+                "description": (
+                    "error = something broke or behaved unexpectedly; "
+                    "feature = need a capability that doesn't exist; "
+                    "signal = observation or impression (positive or improvement)"
+                ),
+            },
+            "--message": {"type": "string", "required": True, "description": "Feedback description (max 4000 chars). Prompted if omitted."},
+            "--context": {"type": "json", "required": False, "description": 'Structured metadata, e.g. \'{"command":"list_threads","status_code":500}\''},
+        },
+        "returns": "{ id, type, status: received, created_at }",
+    },
     # ── Config ───────────────────────────────────────────────────────
     "config.register": {
         "description": "Self-register as an agent using Ed25519 keypair. No dashboard required.",

commune_cli-0.2.2/commune_cli/commands/feedback.py

@@ -0,0 +1,101 @@
+"""commune feedback — submit errors, feature requests, and signals to Commune."""
+
+from __future__ import annotations
+
+import json
+from enum import Enum
+from typing import Optional
+
+import typer
+
+from ..client import CommuneClient
+from ..errors import api_error, auth_required_error, network_error
+from ..output import print_json, print_success
+from ..state import AppState
+
+app = typer.Typer(
+    help=(
+        "Submit feedback to Commune.\n\n"
+        "Three types:\n\n"
+        "  error    — something broke or behaved unexpectedly\n\n"
+        "  feature  — request for new functionality\n\n"
+        "  signal   — observations, impressions, things working well or needing polish"
+    ),
+    no_args_is_help=True,
+)
+
+
+class FeedbackType(str, Enum):
+    error = "error"
+    feature = "feature"
+    signal = "signal"
+
+
+@app.command("submit")
+def feedback_submit(
+    ctx: typer.Context,
+    type: FeedbackType = typer.Option(
+        ...,
+        "--type",
+        "-t",
+        help="Feedback type: error, feature, or signal.",
+        show_choices=True,
+    ),
+    message: Optional[str] = typer.Option(
+        None,
+        "--message",
+        "-m",
+        help="Feedback message (prompted if omitted).",
+    ),
+    context: Optional[str] = typer.Option(
+        None,
+        "--context",
+        help='Optional JSON context object, e.g. \'{"command":"list_threads","status_code":500}\'.',
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Output JSON."),
+) -> None:
+    """Submit feedback. POST /v1/feedback.
+
+    Examples:
+
+      commune feedback submit --type error --message "Thread list 500s when inbox is empty"
+
+      commune feedback submit --type feature --message "Add cursor pagination to search"
+
+      commune feedback submit --type signal --message "Semantic search quality has improved a lot"
+    """
+    state: AppState = ctx.obj or AppState()
+    if not state.has_any_auth():
+        auth_required_error(json_output=json_output or state.should_json())
+
+    # Prompt for message if not provided
+    if not message:
+        message = typer.prompt(f"[{type.value}] Feedback message")
+
+    payload: dict = {"type": type.value, "message": message}
+
+    if context:
+        try:
+            payload["context"] = json.loads(context)
+        except json.JSONDecodeError:
+            typer.echo("Error: --context must be valid JSON.", err=True)
+            raise typer.Exit(1)
+
+    client = CommuneClient.from_state(state)
+    try:
+        r = client.post("/v1/feedback", 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
+
+    record = data.get("data", data)
+    feedback_id = record.get("id", "")
+    type_label = {"error": "Error", "feature": "Feature request", "signal": "Signal"}.get(type.value, type.value)
+    print_success(f"[bold]{type_label}[/bold] received. ID: [dim]{feedback_id}[/dim]")

{commune_cli-0.2.0 → commune_cli-0.2.2}/commune_cli/main.py

@@ -30,6 +30,7 @@ from .commands import (
     phone_numbers,
     sms,
     credits,
+    feedback,
 )
 
 app = typer.Typer(
@@ -64,6 +65,7 @@ app.add_typer(data.app,        name="data",         help="Data deletion requests
 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.add_typer(feedback.app,      name="feedback",      help="Submit feedback: errors, feature requests, and signals.")
 
 
 @app.callback(invoke_without_command=True)

{commune_cli-0.2.0 → commune_cli-0.2.2}/pyproject.toml

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