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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: letz-cli
-Version: 0.2.0
+Version: 0.3.0
 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
@@ -30,6 +30,7 @@ the [Letz](https://sam.weareletz.com) platform staged for review, and let the cl
 ```bash
 pip install letz-cli                                        # or: pipx install letz-cli
 export LETZ_API_URL="https://your-letz-instance.example.com"
+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
 ```
@@ -84,8 +85,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.0}/README.md

@@ -9,6 +9,7 @@ the [Letz](https://sam.weareletz.com) platform staged for review, and let the cl
 ```bash
 pip install letz-cli                                        # or: pipx install letz-cli
 export LETZ_API_URL="https://your-letz-instance.example.com"
+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
 ```
@@ -63,8 +64,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.0}/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.0"

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

@@ -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)
@@ -240,6 +240,7 @@ 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("--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.0}/letz/api.py

@@ -17,22 +17,30 @@ class LetzAPIError(Exception):
 
 
 class LetzAPI:
-    def __init__(self, base_url: str = "http://localhost:8000", timeout: int = 120):
+    def __init__(self, base_url: str = "http://localhost:8000", 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: