letz-cli 0.2.0__tar.gz → 0.3.1__tar.gz

{letz_cli-0.2.0 → letz_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: letz-cli
-Version: 0.2.0
+Version: 0.3.1
 Summary: Letz Brain CLI - pull campaigns from the Letz platform, draft email sequences locally with Claude, and push them back staged for review.
 Project-URL: Homepage, https://sam.weareletz.com
 Author: Letz
@@ -28,12 +28,15 @@ the [Letz](https://sam.weareletz.com) platform staged for review, and let the cl
 ## 60-second start
 
 ```bash
-pip install letz-cli                                        # or: pipx install letz-cli
-export LETZ_API_URL="https://your-letz-instance.example.com"
-letz campaigns                                              # list your campaigns + ids
-letz prompt <CAMPAIGN_ID>                                   # print the playbook for Claude
+pip install letz-cli                # or: pipx install letz-cli
+export LETZ_API_KEY="letz_sk_..."   # create one in Settings → Claude Code Tools → API Keys
+letz campaigns                      # list your campaigns + ids
+letz prompt <CAMPAIGN_ID>           # print the playbook for Claude
 ```
 
+The CLI talks to the Letz cloud by default. Self-hosted or local instance? Point it
+elsewhere with `export LETZ_API_URL="https://your-instance.example.com"` or `--api`.
+
 Paste the output of `letz prompt` into a [Claude Code](https://docs.claude.com/en/docs/claude-code/overview)
 session signed in with a **Claude Pro or Max subscription** (not a metered API key — the
 subscription is what makes generation free). Claude runs the whole loop below for you,
@@ -84,8 +87,9 @@ letz status <campaign_id>
 | `push <id> --activate` | push **and** flip the campaign active (begins sending) | no |
 | `status <id>` | staged enrollments / previews / sends | no |
 
-Flags: `--api <url>` (or `$LETZ_API_URL`), `--work <dir>` (or `$LETZ_WORK`, default
-`./letz_work`), `--version`. Global flags go before the command: `letz --api <url> status <id>`.
+Flags: `--api <url>` (or `$LETZ_API_URL`), `--key <api key>` (or `$LETZ_API_KEY`),
+`--work <dir>` (or `$LETZ_WORK`, default `./letz_work`), `--version`. Global flags go
+before the command: `letz --api <url> status <id>`.
 
 Requires Python 3.10+. Zero dependencies (pure standard library).
 

{letz_cli-0.2.0 → letz_cli-0.3.1}/README.md

@@ -7,12 +7,15 @@ the [Letz](https://sam.weareletz.com) platform staged for review, and let the cl
 ## 60-second start
 
 ```bash
-pip install letz-cli                                        # or: pipx install letz-cli
-export LETZ_API_URL="https://your-letz-instance.example.com"
-letz campaigns                                              # list your campaigns + ids
-letz prompt <CAMPAIGN_ID>                                   # print the playbook for Claude
+pip install letz-cli                # or: pipx install letz-cli
+export LETZ_API_KEY="letz_sk_..."   # create one in Settings → Claude Code Tools → API Keys
+letz campaigns                      # list your campaigns + ids
+letz prompt <CAMPAIGN_ID>           # print the playbook for Claude
 ```
 
+The CLI talks to the Letz cloud by default. Self-hosted or local instance? Point it
+elsewhere with `export LETZ_API_URL="https://your-instance.example.com"` or `--api`.
+
 Paste the output of `letz prompt` into a [Claude Code](https://docs.claude.com/en/docs/claude-code/overview)
 session signed in with a **Claude Pro or Max subscription** (not a metered API key — the
 subscription is what makes generation free). Claude runs the whole loop below for you,
@@ -63,8 +66,9 @@ letz status <campaign_id>
 | `push <id> --activate` | push **and** flip the campaign active (begins sending) | no |
 | `status <id>` | staged enrollments / previews / sends | no |
 
-Flags: `--api <url>` (or `$LETZ_API_URL`), `--work <dir>` (or `$LETZ_WORK`, default
-`./letz_work`), `--version`. Global flags go before the command: `letz --api <url> status <id>`.
+Flags: `--api <url>` (or `$LETZ_API_URL`), `--key <api key>` (or `$LETZ_API_KEY`),
+`--work <dir>` (or `$LETZ_WORK`, default `./letz_work`), `--version`. Global flags go
+before the command: `letz --api <url> status <id>`.
 
 Requires Python 3.10+. Zero dependencies (pure standard library).
 

{letz_cli-0.2.0 → letz_cli-0.3.1}/letz/__init__.py

@@ -2,4 +2,4 @@
 sequences locally with Claude, and push them back staged for review.
 Nothing sends until a human clicks Activate.
 """
-__version__ = "0.2.0"
+__version__ = "0.3.1"

{letz_cli-0.2.0 → letz_cli-0.3.1}/letz/__main__.py

@@ -23,12 +23,12 @@ import sys
 
 try:
     from . import __version__
-    from .api import LetzAPI, LetzAPIError
+    from .api import DEFAULT_API_URL, LetzAPI, LetzAPIError
     from .gauntlet import audit_sequence
 except ImportError:  # allow running as a plain script: python cli/letz/__main__.py
     sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
     from letz import __version__
-    from letz.api import LetzAPI, LetzAPIError
+    from letz.api import DEFAULT_API_URL, LetzAPI, LetzAPIError
     from letz.gauntlet import audit_sequence
 
 
@@ -65,7 +65,7 @@ def _save(path, obj):
 
 # ---------------------------------------------------------------- commands ----
 def cmd_campaigns(args):
-    api = LetzAPI(args.api)
+    api = LetzAPI(args.api, api_key=args.key)
     camps = api.campaigns()
     if not camps:
         print(f"No campaigns found at {args.api}")
@@ -84,7 +84,7 @@ def cmd_prompt(args):
 
 
 def cmd_pull(args):
-    api = LetzAPI(args.api)
+    api = LetzAPI(args.api, api_key=args.key)
     camp = api.campaign(args.campaign_id)
     if not camp:
         print(f"✗ Campaign {args.campaign_id} not found at {args.api}")
@@ -197,7 +197,7 @@ def cmd_push(args):
     # Push in batches so a large campaign never trips the request timeout.
     # The endpoint is idempotent + atomic per request, so a failed batch can be
     # safely retried by re-running push.
-    api = LetzAPI(args.api)
+    api = LetzAPI(args.api, api_key=args.key)
     batch = max(1, args.batch)
     total_imported = total_skipped = 0
     last_status = None
@@ -222,7 +222,7 @@ def cmd_push(args):
 
 
 def cmd_status(args):
-    api = LetzAPI(args.api)
+    api = LetzAPI(args.api, api_key=args.key)
     camp = api.campaign(args.campaign_id) or {}
     enrs = api.enrollments(args.campaign_id)
     prev = api.previews(args.campaign_id)
@@ -239,7 +239,9 @@ def cmd_status(args):
 def main(argv=None):
     p = argparse.ArgumentParser(prog="letz", description="Letz Brain CLI — off-platform generation, persist, click send.")
     p.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
-    p.add_argument("--api", default=os.environ.get("LETZ_API_URL", "http://localhost:8000"), help="platform base URL")
+    p.add_argument("--api", default=os.environ.get("LETZ_API_URL") or DEFAULT_API_URL,
+                   help="platform base URL (default: the Letz cloud; override via $LETZ_API_URL)")
+    p.add_argument("--key", default=os.environ.get("LETZ_API_KEY", ""), help="API key (or $LETZ_API_KEY) — create one in Settings → API Keys")
     p.add_argument("--work", default=None, help="work dir (default ./letz_work)")
     sub = p.add_subparsers(dest="cmd", required=True)
 

{letz_cli-0.2.0 → letz_cli-0.3.1}/letz/api.py

@@ -16,23 +16,34 @@ class LetzAPIError(Exception):
         super().__init__(f"HTTP {status}: {str(body)[:300]}")
 
 
+DEFAULT_API_URL = "https://letz-auto-sdr-production.up.railway.app"
+
+
 class LetzAPI:
-    def __init__(self, base_url: str = "http://localhost:8000", timeout: int = 120):
+    def __init__(self, base_url: str = DEFAULT_API_URL, timeout: int = 120,
+                 api_key: str = ""):
         self.base = base_url.rstrip("/")
         self.timeout = timeout
+        self.api_key = (api_key or "").strip()
 
     def _req(self, method: str, path: str, body=None):
         url = self.base + ("/api/v1" if not path.startswith("/api/") else "") + path
         data = json.dumps(body).encode() if body is not None else None
-        req = urllib.request.Request(
-            url, data=data, method=method,
-            headers={"Content-Type": "application/json"},
-        )
+        headers = {"Content-Type": "application/json"}
+        if self.api_key:
+            headers["X-API-Key"] = self.api_key
+        req = urllib.request.Request(url, data=data, method=method, headers=headers)
         try:
             with urllib.request.urlopen(req, timeout=self.timeout) as resp:
                 raw = resp.read().decode() or "{}"
                 return json.loads(raw)
         except urllib.error.HTTPError as e:
+            if e.code == 401:
+                raise LetzAPIError(401, {
+                    "detail": "Unauthorized. Create an API key in the platform under "
+                              "Settings → Claude Code Tools → API Keys, then "
+                              'export LETZ_API_KEY="letz_sk_..." (or pass --key).'
+                })
             try:
                 payload = json.loads(e.read().decode() or "{}")
             except Exception: